Linkding_CN部署指南：汉化版书签管理器-墙外贴吧

Linkding 是一款 自托管 的书签管理服务，其设计理念是追求极简、快速和易于设置。相比同类型软件，它以内存占用小的优势脱颖而出，提供便捷高效的书签管理体验。感谢sissbruecker 大佬做出这么棒的书签管理器。

英文项目地址： https://github.com/sissbruecker/linkding
官方演示地址： https://demo.linkding.link/login/

🇨🇳 Linkding_CN：功能增强的中文本地化版本

鉴于 Linkding 原项目为全英文界面，为提供更符合中文用户习惯的使用体验，衍生出Linkding_CN 汉化项目。

Linkding_CN 是基于 Linkding 修改而来的书签管理器，不仅进行了中文本地化，还在此基础上实现了 功能增强 和 界面优化。感谢WooHooDai大佬的优化与增强～

Linkding_CN 项目地址： https://github.com/WooHooDai/linkding-cn

✨ 主要功能亮点

Linkding_CN 提供了原版 Linkding 不具备的丰富功能：

类别	特性	描述
功能增强	🎲 随机排序	支持书签的随机展示和排序。
	📅 日期筛选	允许用户根据日期范围筛选书签。
	🐞 自定义快照脚本	提供自定义网页快照脚本的支持。
	♻️ 回收站	增加了回收站功能，避免误删。
界面优化	滚动优化	搜索栏和侧边栏支持随屏滚动。
	侧边栏控制	支持侧边栏折叠功能。
	独立滚动条	优化了独立的滚动条设计。
	状态记忆	能够记忆侧边栏的位置和折叠状态。

🚀 Linkding_CN 部署指南

一、文件获取与环境准备

1. 📥 下载项目文件

访问项目地址： 前往 Linkding_CN 的项目仓库。
获取最新版本： 点击页面右侧的 "Releases"（版本发布）。
下载压缩包： 在最新版本下找到 "Assets"，下载包含所有项目文件的压缩包（通常为 .zip）。

2. 📂 上传与解压

登录 VPS： 访问您的虚拟私人服务器（VPS），进入文件管理界面。
上传文件： 将下载的压缩包上传至您指定的目录，例如：alloon/dockers/。
解压： 将压缩包解压。解压后会生成部署所需的项目文件夹（例如：linkding_cn）。

二、核心配置与服务启动

部署 Linkding_CN 仅需配置两个文件，然后通过一条命令启动。请参考项目仓库中的「开始使用」说明进行配置。

1. ⚙️ 配置管理员信息（`.env`）

此文件用于定义容器运行时的环境变量，是设置登录凭证的关键步骤。

文件处理： 在项目文件夹中，将 .env.sample 文件重命名为 .env。

修改内容： 打开 .env 文件，务必填写您的管理员用户名和密码。

# 示例 (.env 文件核心配置)# 管理员登录账号 (必填!)LD_SUPERUSER_NAME=your_admin_username # 管理员登录密码 (必填! 建议使用强密码)LD_SUPERUSER_PASSWORD=your_secure_password# ... 其他可选配置，如时区等

2. 📄 配置容器定义（`docker-compose.yml`）

此文件定义了 Linkding 容器的运行参数，如端口映射和数据持久化。

检查文件： 找到并打开 docker-compose.yml 文件。
端口确认： 如果需要更改默认访问端口（默认为 9090），请修改 ports 映射配置。

3. ▶️ 启动服务

完成配置后，即可通过 Docker Compose 启动服务。

进入目录： 使用 SSH 终端进入到 docker-compose.yml 所在的文件夹：
```
cd /path/to/linkding_cn
```
执行启动命令： 使用 -d 参数让容器在后台持续运行：
```
docker compose up -d
```

三、浏览器访问与登录

服务启动成功后，即可通过浏览器访问您的自托管书签管理器。

打开浏览器： 输入您的 VPS IP 地址和端口号进行访问。
访问格式： http://[您的VPS IP地址]:[端口号]
- 默认地址： 如果未修改配置，访问地址为：http://您的VPS-IP地址:9090
登录： 使用您在 .env 文件中设置的 LD_SUPERUSER_NAME 和 LD_SUPERUSER_PASSWORD 即可开始使用。

Linkding_CN部署指南：汉化版书签管理器