在服务器上跑一套自己的书签管理器：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
想把网页存下来又不怕它消失、还想快速翻出攒了一千多条的旧书签？把它跑在自己服务器上往往是更务实的答案。Linkding 是一款自托管书签管理器，界面极简、速度很快，用 Docker 就能启动，自带标签、Markdown 笔记与网页归档能力。
装好之后的 Linkding 长什么样
先交代最终效果，再回头看安装过程。打开主页面你会看到：左侧是筛选区（标签云、日期分组），中间是书签列表，每条显示标题、favicon 和标签；点开任意一条进入详情，可以编辑描述、补充 Markdown 笔记，也能把它标记为"未读"以便稍后阅读。
日常操作集中在三件事上：
- 筛选：搜索框里输入关键词，或用
tag:前缀按标签过滤，再配合未读、归档等状态条件组合查询； - 批量编辑：勾选多条书签，一次性改标签、归档或调整状态；
- 添加：手动粘贴 URL，或用浏览器扩展直接保存当前页面。
手机里如何安装
Linkding 支持 PWA：在手机浏览器打开你的实例地址，从菜单里选择"添加到主屏幕"，就能得到一个全屏的书签应用。这样"手机上遇到好网页 → 存进 Linkding"的流程只需要两次点击。
前置条件与镜像选型
Linkding 默认使用 SQLite，基础镜像很轻量，官方安装文档明确 ARM 平台也可运行，树莓派这类设备没问题。开始前只需确认宿主机装好了 Docker 和 Docker Compose。
什么时候该选 latest-plus
镜像分两种，选型直接决定资源占用：
latest：基础功能，镜像小、内存占用低，适合大多数人；latest-plus：内置无头 Chromium，添加书签时自动生成网页的 HTML 快照，但镜像明显更大、至少需要 1 GB 内存，且不支持 ARM v7。
如果只是存链接加笔记，latest足够；如果希望重要页面留一份"离线副本"，再上latest-plus，或者用浏览器端方案保存快照（后文会讲）。
用 Docker Compose 部署 Linkding
用 Compose 的方式，安装就是几行命令。先克隆仓库并准备配置文件：
git clone https://gitcode.com/GitHub_Trending/li/linkding cd linkding cp .env.sample .env然后启动容器：
docker-compose up -d它会拉取镜像、初始化数据目录并启动服务。浏览器打开http://localhost:9090就能看到登录页。
.env 环境变量怎么配
.env里注释很多，但真正要动的只有几项：
LD_HOST_PORT：宿主机端口，默认 9090，被占用就改掉；LD_HOST_DATA_DIR：挂载到宿主机的数据目录，默认./data。这个目录是全部数据的唯一存放处，建议改成绝对路径并纳入备份；LD_SUPERUSER_NAME/LD_SUPERUSER_PASSWORD：填了会在启动时自动创建初始账号，留空则需要容器起来后手动创建。
想从 SQLite 换成 PostgreSQL，再补上LD_DB_ENGINE等数据库变量即可。
首次登录：创建超级用户
如果在.env里留空了超级用户，就在容器内执行下面的命令创建（会提示输入密码）：
docker compose exec linkding python manage.py \ createsuperuser --username=admin之后用这个账号登录即可，所有数据都挂在这个用户下。
部署后的几件必办事
导入现有书签
不必手敲 URL。把浏览器里现有的书签导出为 HTML（Netscape 标准格式），在设置页的导入入口上传，原有标签和描述都会保留。
网页归档的两条路
- 服务端归档（
latest-plus镜像）：添加书签后由无头浏览器生成 HTML 快照，URL 直指 PDF 时会自动改存 PDF。省心，但遇到反爬机制或需要登录的页面可能拿不到完整内容； - 客户端归档（基础镜像也能用）：安装 Singlefile 浏览器扩展，把保存目标设为 REST API 上传，URL 填你实例的
/api/bookmarks/singlefile/，再填上设置页里的 API token。点一下扩展图标，当前页面就以单个 HTML 文件存入并挂到对应书签上，保存的正是你眼前看到的样子。
两种方式更多细节见归档文档。
自动打标与浏览器快捷方式
两个能显著降低维护成本的小功能：一是自动打标规则，按 URL 特征自动给新书签打标签；二是设置页提供的书签小工具（bookmarklet），把它拖进浏览器书签栏后，收藏当前页一次点击完成，不用走表单。
数据放在哪里，Linkding 怎么备份
Linkding 把所有数据写进挂载的数据目录，容器内路径是/etc/linkding/data，里面有：
db.sqlite3：SQLite 数据库，书签、标签、用户设置都在这里；assets：HTML 快照；favicons与previews：图标和预览图缓存。
官方备份文档推荐用内置的全量备份命令，把数据库和素材一起打成 zip：
docker compose exec linkding python manage.py \ full_backup /etc/linkding/data/backup.zip docker cp linkding:/etc/linkding/data/backup.zip ./backup.zip恢复时把 zip 解压到新实例的数据目录，让容器挂载该目录再启动即可。注意：数据库虽是单文件，但服务运行时直接拷贝并不事务安全，所以备份请走full_backup命令而不是裸拷文件。
怎么升级到新版本
数据在挂载卷上，容器本身是一次性运行环境，升级就是换新镜像再启动：
docker compose pull docker compose up -d适用边界：它适合谁，哪里要妥协
Linkding 不是以"多设备云端同步"为卖点的书签服务，它的核心是数据落在你服务器上、随处可访问。因此：
- 适合：已有 VPS 或家用服务器，想要桌面手机统一入口；希望重要页面有归档、不随原站消失；想用标签和批量操作整理大量链接；
- 要妥协：没有服务器的话，先解决"在哪跑"的问题；快照数量多了要留意磁盘占用；
latest-plus至少 1 GB 内存，低配设备用基础镜像即可。
对单用户管理几百到几千条书签的场景，它稳定够用——自托管书签管理工具能提供的确定性，基本都在这里了。
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
