进阶 docs.linkwarden.app 2026-11-18 13:26:15 · 6 阅读

第7章 自托管指南:Docker 部署 Linkwarden

环境搭建 提示:官方云服务是上手 Linkwarden 最简单的方式,通常也比租用 VPS 更划算。而且你的订阅费用还能支持应用的持续开发和改进,惠及所有用户!当然,如果你想自己部署 Linkwarden,也完全没问题,所有核心功能照样可用。 本章将介绍在自己服务器上搭建一套完整的 Linkwarden 实例所需的全部内容。 安装 硬件要求 Linkwarden 在小型 VPS 或家用服务器上就能流畅运行: 内存:4 GB 是比较宽裕的起步配置。 CPU:任意双核机器即可。镜像同时提供 x86-64 和 ARM64 版本。 磁盘:镜像约需 1.5 GB,另加你的数据空间。 如果你用的是配置更低的机器,或者想了解内存和磁盘的实际占用情况,请参阅 Running a Lighter Setup。 Docker Compose 🐋 环境要求: Docker Curl Nano 1. 下载所需文件 mkdir linkwarden && cd linkwarden
curl -O https://raw.githubusercontent.com/linkwarden/linkwarden/refs/heads/main/docker-compose.yml
curl -L https://raw.githubusercontent.com/linkwarden/linkwarden/refs/heads/main/.env.sample -o ".env"
2. 配置环境变量 nano .env
需要设置的环境变量如下: NEXTAUTH_URL=http://localhost:3000/api/v1/auth
NEXTAUTH_SECRET=VERY_SENSITIVE_SECRET
MEILI_MASTER_KEY=VERY_SENSITIVE_MEILI_MASTER_KEY
POSTGRES_PASSWORD=CUSTOM_POSTGRES_PASSWORD
其中 NEXTAUTH_SECRET、POSTGRES_PASSWORD 和 MEILI_MASTER_KEY 是必须修改的,且三者应设置为不同的密钥字符串。如果包含特殊字符,需要用单引号或双引号包裹。 只有当你把服务部署到其他地方时,才需要将 NEXTAUTH_URL 改成你自己的域名。 3. 启动! 在主目录(即创建 .env 文件的目录)中运行: docker compose up
等待数分钟后(具体时间取决于您的网络速度),即可通过 http://localhost:3000(或您部署 Linkwarden 所用的主机名)访问该应用。 注意:新实例创建的第一个账户将成为管理员。在将实例暴露至公网之前请先创建您的账户,或设置 NEXT_PUBLIC_ADMIN 指定其他账户。 祝您使用愉快! 手动安装 注意:手动安装面向更偏向技术向的读者。若希望走更简单的路径,建议使用 Docker 安装。 依赖项: Git Node(20 及以上版本) Yarn(启用 Corepack) Postgres(16 及以上版本) Nano Monolith 1. 克隆 Linkwarden 仓库 git clone https://github.com/linkwarden/linkwarden.git
cd linkwarden
2. 安装所需依赖 yarn workspaces focus linkwarden @linkwarden/web @linkwarden/worker
3. 配置环境变量 cd linkwarden
cp .env.sample .env
nano .env
所需的环境变量如下: NEXTAUTH_SECRET=VERY_SENSITIVE_SECRET
NEXTAUTH_URL=http://localhost:3000/api/v1/auth
DATABASE_URL=postgresql://[USERNAME]:[PASSWORD]@localhost:[PORT]/[DATABASE]
上述变量中,必须修改的是 NEXTAUTH_SECRET 和 DATABASE_URL。 仅当您在其他域名下托管服务时,才需将 NEXTAUTH_URL 更改为对应域名。 4. 构建应用并初始化数据库 yarn prisma:generate
yarn web:build
yarn prisma:deploy
5. 配置 Meilisearch(可选) 若要使用高级搜索功能,需先按照 Meilisearch 安装指南安装 Meilisearch。 然后在 .env 文件中添加以下环境变量: MEILI_HOST=http://localhost:7700
MEILI_MASTER_KEY=VERY_SENSITIVE_MEILI_MASTER_KEY
请注意,启动 Linkwarden 前,需确保 Meilisearch 已在后台运行。 6. 启动应用 yarn concurrently:start
警告:新实例创建的第一个账户将成为管理员。在将实例暴露至公网之前请先创建您的账户,或设置 NEXT_PUBLIC_ADMIN 指定其他账户。 故障排查 设置 Linkwarden 时可能会遇到一些常见问题,例如: 类型错误:模块 '"@prisma/client"' 没有导出成员……此错误由 @prisma/client 包安装不正确导致。解决方法是运行:yarn prisma:generate
显示「upstream image response failed for https://t2.gstatic.com/faviconV2...」这条错误(在较新版本的 Linkwarden 中已不会再出现)是因为找不到网站图标而导致的,其实没什么大不了的。如果你想处理一下,可以给没有 favicon 的链接手动设置一个图标,或者直接隐藏图标。favicon 是唯一没有实际存储在本地、每次加载页面时都要从网上重新抓取的部分。

评论 (0)