国民专业级NAS --铁威马官方论坛

发表于： **2026年 7月 27日星期一 4:25 pm**

在铁威马 TOS 7 系统通过 Docker 部署 Linkding 完整教程

—— 将浏览器收藏夹升级为个人私有书签知识库 ——

一、项目介绍

Linkding 是一款轻量、开源、可自行部署的书签管理工具。它适合部署在 NAS 上，用于集中保存、分类、检索和分享日常收集的网址。

浏览器自带书签同步虽然方便，但通常依赖单一浏览器账号，管理方式也主要是文件夹。Linkding 则更适合长期积累大量资料：一个网址可以添加多个标签、补充备注、批量整理，也可以按需分享给家人或同事。

Linkding 的主要特点：

使用标签管理书签，一个链接可同时属于多个分类；
自动获取网页标题、简介、图标和预览信息；
支持 Markdown 备注和“稍后阅读”；
支持浏览器书签 HTML 文件导入、导出；
支持批量编辑标签、状态或删除书签；
支持 Chrome、Firefox 浏览器扩展，快速保存当前网页；
支持多用户和访客分享；
支持网页归档功能，可选保存网页 HTML 快照；
单容器运行，默认使用 SQLite 数据库，资源占用较低。

简单来说：浏览器同步书签解决“收藏夹如何同步”；Linkding 更适合解决“积累的大量链接如何长期整理、检索、备注、分享和备份”。

二、准备工作

在开始前，请确认已完成以下准备：

铁威马 NAS 已安装 TOS 7；
已安装并启用 Docker Manager；
Docker Engine 服务处于运行状态；
在 File Manager 中创建项目目录，例如：`/Volume1/docker/linkding`；
NAS 可以正常连接 Docker 镜像仓库。

三、创建 Linkding 项目

打开 Docker Manager；
点击左侧菜单项目；
点击顶部 创建项目；
项目名称填写：`linkding`；
项目路径填写：`/Volume1/docker/linkding`；
配置文件来源选择 创建 YAML 文件。

四、准备目录结构

在 `/Volume1/docker/linkding` 中创建 `data` 文件夹，最终目录结构如下：

代码：全选

/Volume1/docker/linkding
└── data    # 保存书签数据库、用户信息和配置

重要说明：
`data` 目录保存全部书签和账号数据。升级、重建容器或迁移 NAS 时，应保留并备份此目录。

五、配置 YAML 文件

将以下内容完整复制到 Docker Manager 的 YAML 编辑框中。

请把 `请改成高强度密码` 改为自己的密码。不要直接使用示例密码，也不要把管理端口直接暴露到公网。

代码：全选

services:
  linkding:
    image: sissbruecker/linkding:latest
    container_name: linkding
    restart: unless-stopped
    ports:
      - 39090:9090
    volumes:
      - ./data:/etc/linkding/data
    environment:
      LD_SUPERUSER_NAME: admin
      LD_SUPERUSER_PASSWORD: 请改成高强度密码

填写完成后，点击创建。

等待镜像下载和容器启动完成，Docker Manager 中项目状态显示为“运行中”即可。

六、访问 Linkding

在局域网浏览器中访问：

代码：全选

http://你的NAS_IP:39090

例如：

代码：全选

http://192.168.1.100:39090

登录信息为：

代码：全选

用户名：admin
密码：YAML 中设置的高强度密码

说明：
`LD_SUPERUSER_NAME` 和 `LD_SUPERUSER_PASSWORD` 用于容器首次启动时创建管理员账号。账号已经创建后，即使修改 YAML 中的用户名或密码，也不会自动修改现有账号。

七、从浏览器迁移已有书签

如果之前已经使用 Chrome、Edge、Firefox 等浏览器保存了大量书签，可以导出后导入 Linkding。

1、从浏览器导出书签

以 Chrome、Edge 为例：

打开浏览器书签管理器；
点击右上角菜单；
选择 导出书签；
保存为 HTML 文件。

2、导入到 Linkding

登录 Linkding 后，进入设置页面，找到书签导入功能，选择刚才导出的 HTML 文件即可。

导入完成后，建议为常用书签补充标签。例如：

代码：全选

Docker
TOS 7
教程
工具
待测试
影视
下载
家庭

相比浏览器单层或多层文件夹，标签可以交叉分类。例如一篇 Docker 教程可以同时添加 `Docker`、`TOS 7`、`教程` 三个标签，后续查找会更方便。

八、安装浏览器扩展

Linkding 提供 Chrome 和 Firefox 浏览器扩展，可用于快速保存当前网页，也可直接在浏览器地址栏中搜索已收藏的书签。

安装扩展后，需要填写：

Linkding 服务地址，例如：`http://192.168.1.100:39090`；
Linkding 账户生成的 API Token。

API Token 可在 Linkding 的个人设置中创建。建议为不同设备分别创建 Token，设备不再使用时可单独撤销对应 Token。

九、参数说明

1、image

代码：全选

image: sissbruecker/linkding:latest

使用 Linkding 官方 Docker 镜像。

基础镜像适合普通书签管理。若需要将网页保存为本地 HTML 快照，可改用：

代码：全选

image: sissbruecker/linkding:latest-plus

注意：
`latest-plus` 包含网页归档所需的 Chromium，镜像更大、内存和存储占用也更高。低配置 NAS 建议先使用基础版。

2、ports

代码：全选

ports:
  - 39090:9090

`39090` 是 NAS 对外访问端口，`9090` 是容器内部端口。

如端口已被占用，可改为其他未使用端口，例如：

代码：全选

ports:
  - 39091:9090

随后通过以下地址访问：

代码：全选

http://你的NAS_IP:39091

3、volumes

代码：全选

volumes:
  - ./data:/etc/linkding/data

将容器内的数据目录映射到 NAS 项目目录。所有书签、用户和 SQLite 数据库都会保存在：

代码：全选

/Volume1/docker/linkding/data

4、管理员账号

代码：全选

LD_SUPERUSER_NAME: admin
LD_SUPERUSER_PASSWORD: 请改成高强度密码

用于首次启动时自动创建管理员账户。

建议密码使用大小写字母、数字和特殊字符组合，并避免与 NAS 管理员密码相同。

十、使用建议

将 Linkding 作为主书签库，浏览器本地书签只保留少量临时链接；
建立统一标签规则，避免同时出现“Docker”“docker”“DOCKER”等重复标签；
重要链接可添加 Markdown 备注，记录账号入口、使用说明或部署笔记；
定期导出书签 HTML 文件，并备份 `data` 目录；
需要外网访问时，建议通过反向代理和 HTTPS 提供服务，不建议直接将端口暴露到公网；
如通过反向代理访问时出现登录或保存书签失败，可检查反向代理是否正确传递 Host 请求头。

十一、项目链接

Linkding 官方项目：

https://github.com/sissbruecker/linkding

Linkding 官方文档：

https://linkding.link/

本文为社区部署经验分享，Linkding 为第三方开源项目。请根据自己的网络环境、NAS 性能和数据安全需求进行配置。