Linkwarden 书签管理器部署教程

Linkwarden 是一款开源的协作式书签管理工具，不仅可以保存书签链接，还会自动为每个收藏的网页创建快照存档，即使原始网页被删除或修改，你依然可以查看保存时的内容。Linkwarden 支持标签分类、集合管理、全文搜索、多用户协作等功能，是替代 Pocket、Raindrop.io 等商业服务的优秀自托管方案。本文将介绍如何在搬瓦工 VPS 上使用 Docker 部署 Linkwarden。部署前请确保已安装好 Docker 和 Docker Compose。

一、系统要求

操作系统：Ubuntu 20.04+ 或 Debian 11+。
内存：至少 1GB，建议 2GB（网页快照功能需要一定内存）。
磁盘：至少 10GB，快照存档会占用较多空间。
域名：建议绑定域名并配置 SSL。

二、Docker Compose 部署

mkdir -p /opt/linkwarden
cd /opt/linkwarden

cat > /opt/linkwarden/docker-compose.yml <<'EOF'
version: '3.8'

services:
  postgres:
    image: postgres:15-alpine
    restart: always
    environment:
      POSTGRES_DB: linkwarden
      POSTGRES_USER: linkwarden
      POSTGRES_PASSWORD: your_db_password
    volumes:
      - postgres_data:/var/lib/postgresql/data

  linkwarden:
    image: ghcr.io/linkwarden/linkwarden:latest
    restart: always
    depends_on:
      - postgres
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgresql://linkwarden:your_db_password@postgres:5432/linkwarden
      NEXTAUTH_SECRET: your_nextauth_secret
      NEXTAUTH_URL: https://links.yourdomain.com
      NEXT_PUBLIC_DISABLE_REGISTRATION: "false"
      STORAGE_FOLDER: /data/archives
      NEXT_PUBLIC_MAX_FILE_SIZE: 20
    volumes:
      - linkwarden_data:/data/archives

volumes:
  postgres_data:
  linkwarden_data:
EOF

生成 NEXTAUTH_SECRET：

openssl rand -hex 32

三、启动 Linkwarden

cd /opt/linkwarden
docker compose up -d

查看启动状态：

docker compose ps
docker compose logs -f linkwarden

四、配置 Nginx 反向代理

cat > /etc/nginx/sites-available/linkwarden <<'EOF'
server {
    listen 80;
    server_name links.yourdomain.com;

    client_max_body_size 20M;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
EOF

ln -s /etc/nginx/sites-available/linkwarden /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d links.yourdomain.com

五、注册与初始化

访问 https://links.yourdomain.com，注册管理员账户。注册后建议将 NEXT_PUBLIC_DISABLE_REGISTRATION 设置为 true 以禁用公开注册，然后重启容器。

六、核心功能

6.1 添加书签

在 Web 界面中点击 "+" 按钮添加新书签，输入 URL 后 Linkwarden 会自动：

获取网页标题和描述。
提取网页缩略图。
创建网页快照（PDF 和截图）。
提取网页全文内容（用于搜索）。

6.2 集合管理

集合（Collection）类似文件夹，用于分类组织书签。你可以创建多层嵌套的集合结构，例如：

技术文章 > 前端 > React
技术文章 > 后端 > Go
学习资源 > 在线课程

6.3 标签系统

为书签添加标签进行交叉分类。一个书签可以同时属于一个集合和多个标签，提供灵活的内容组织方式。

6.4 网页存档

这是 Linkwarden 的核心特色功能。每个收藏的链接都会自动保存网页快照，包括：

PDF 快照：将网页渲染为 PDF 文件。
截图：保存网页的完整截图。
可读模式：提取网页正文内容并保存。

即使原始网页被删除或修改，你依然可以通过快照查看保存时的内容。

七、浏览器扩展

Linkwarden 提供了 Chrome 和 Firefox 浏览器扩展，一键保存当前网页为书签。安装扩展后：

配置服务器地址为 https://links.yourdomain.com。
使用账户登录授权。
浏览网页时点击扩展图标即可快速收藏。
可以选择目标集合和添加标签。

八、协作功能

Linkwarden 支持多用户协作。你可以邀请其他用户加入，并将集合共享给他们。共享的集合可以设置不同的权限级别：

查看：只能查看集合中的书签。
创建：可以向集合中添加新书签。
编辑：可以修改和删除集合中的书签。

九、全文搜索

Linkwarden 支持对书签的标题、描述、标签和网页全文内容进行搜索。搜索支持过滤条件：

按集合筛选。
按标签筛选。
按时间范围筛选。

十、导入和导出

Linkwarden 支持从多种来源导入书签：

# 支持的导入格式
# - 浏览器导出的 HTML 书签文件
# - Pocket 导出文件
# - Omnivore 导出文件
# - Linkwarden 自身的 JSON 导出文件

在设置页面中可以导入和导出书签数据。

十一、数据备份

# 备份数据库
docker exec linkwarden-postgres-1 pg_dump -U linkwarden linkwarden > /opt/linkwarden/backup_$(date +%Y%m%d).sql

# 备份存档文件
tar -czf /opt/linkwarden/backup_archives_$(date +%Y%m%d).tar.gz /opt/linkwarden/linkwarden_data/

十二、常见问题

网页快照生成失败

快照功能使用 Chromium 渲染引擎，需要较多内存。如果 VPS 内存不足，可能导致快照生成失败。建议至少分配 2GB 内存，或创建 swap 空间。

存储空间增长快

每个书签的快照（PDF + 截图）通常占用 1-5MB。如果收藏大量网页，存储需求会快速增长。可以在设置中调整快照策略或定期清理不需要的快照。

导入书签超时

批量导入大量书签时，每个书签都会生成快照，这个过程非常耗时。建议分批导入，或在导入时暂时禁用快照功能。

总结

Linkwarden 是一款功能丰富的自托管书签管理工具，网页存档功能是其最大亮点，确保你保存的内容永远不会丢失。在搬瓦工 VPS 上部署 Linkwarden 后，配合浏览器扩展可以实现便捷的网页收藏工作流。更多自托管应用教程请参考：Memos 笔记部署、Outline Wiki 部署、Docker 安装教程。选购搬瓦工 VPS 请参考全部方案，购买时使用优惠码 NODESEEK2026 可享受 6.77% 的循环折扣。