企业官网建设流程全解析

如何用Docker部署linkding自托管书签管理

【免费下载链接】linkdingSelf-hosted bookmark manager that is designed be to be minimal, fast, and easy to set up using Docker.项目地址: https://gitcode.com/GitHub_Trending/li/linkding

你的浏览器书签栏塞满了几百条链接，找一条要翻半分钟。你需要的是 linkding，一个自托管（数据存在你自己服务器上）的书签管理器，一个 Docker 容器就能跑起来。

后端是 Django 写的，但不用你操心。你只需要几条 Docker 命令，得到的就是一个干净的书签管理界面：列表在中间，标签在右侧，搜索框置顶。

🧭 它和云端书签工具差在哪

• 不同于浏览器云同步，这个书签管理工具把所有数据放进本地 SQLite 数据库，文件就在挂载目录里，直接备份、直接查看
• 标签体系加批量编辑，几百条书签一次归类
• 新增书签自动抓取标题、描述和网站图标
• 可装成 PWA，手机上当原生应用用
• 支持 OIDC 单点登录，能接入现有内网认证

✅ 部署前检查清单

• 已安装 Docker 与 Docker Compose
• 至少 1GB 可用内存（要 HTML 快照归档需要更多）
• 镜像兼容 ARM，树莓派也能跑

🚀 三步拉起服务

接下来三步从空白机器到可用的书签列表，总命令不超过五句。

Step 1：克隆并复制配置

克隆仓库，把样例配置复制成 .env。端口、数据目录、容器名这三个参数都有默认值，冲突了再改。

git clone https://gitcode.com/GitHub_Trending/li/linkding cd linkding && cp .env.sample .env

完成后你会得到一个 .env，里面已配好 LD_HOST_PORT=9090 和 LD_HOST_DATA_DIR=./data。仓库里还有一份现成的 docker-compose.yml，下一步只需一条命令。

Step 2：一键启动容器

用 Compose 拉镜像并启动，数据目录挂载到仓库下的 ./data。

docker-compose up -d

完成后 docker ps 能看到 linkding 容器处于运行状态，宿主机 9090 端口已映射。首次拉取镜像要几分钟，取决于网络。

Step 3：创建第一个账号

镜像不带初始用户，登录前要先建一个超级用户，命令会提示输入两次密码。

docker exec -it linkding python manage.py createsuperuser \ --username=joe --email=joe@example.com

完成后打开 http://localhost:9090 登录，你会看到空的书签列表页，可以开始粘贴链接了。

参考：docs/src/content/docs/installation.md

⚙️ 装完后的常见配置

多数人只会动这几项：

如果要把 linkding 放到子路径下，再补一个 LD_CONTEXT_PATH 即可。改完 .env 重新执行 docker-compose up -d 才会生效。再用 Firefox 或 Chrome 装一个 linkding 扩展，就能从浏览器一键收藏。用一段时间后会发现，手动打开页面填写的情况其实很少。

🔎 两个值得知道的功能

自动归档：保存书签时自动存一份网页快照，可以是本地 HTML 文件，也可以交给 Internet Archive，原站挂掉照样能看。需要换 latest-plus 镜像，内置 Chromium，体积会大一圈。

REST API：每个用户都有一个 API token，拿来做脚本化的书签管理，比如从笔记应用同步收藏。书签端点是 GET /api/bookmarks/，支持按搜索、分页、时间增量拉取。

参考：docs/src/content/docs/api.md

📦 备份与升级速查

对书签管理服务来说，备份一条命令：把数据库和网站图标打包成 zip，挂进 cron 就是定时备份。

docker exec -it linkding python manage.py full_backup /etc/linkding/data/backup.zip

升级是换新镜像，数据留在挂载目录里不会丢：

docker-compose pull && docker-compose up -d

💡 用一段时间后的经验

💡 标签用 tech/docker 这类层级，少返工 💡 「稍后阅读」的书签放进一个 bundle 批量整理 💡 唯一状态是 data 目录，备它就行

让 linkding 接管你的书签管理，Docker 一条命令起步。

【免费下载链接】linkdingSelf-hosted bookmark manager that is designed be to be minimal, fast, and easy to set up using Docker.项目地址: https://gitcode.com/GitHub_Trending/li/linkding