Linkwarden

访问

1. 打开 http://<SERVER_IP>.
2. 点击 “Sign Up”。
3. 创建第一个账户。
4. 第一个账户会成为服务器管理员，因为 NEXT_PUBLIC_ADMIN=1 已启用。

注册

默认开放注册。

创建管理员账户后，可以关闭注册。

如需关闭，请编辑 /root/linkwarden/.env 并设置：

NEXT_PUBLIC_DISABLE_REGISTRATION=true

然后应用配置：

cd /root/linkwarden
docker compose up -d

重要路径

• 安装路径： /root/linkwarden
• Compose 文件: /root/linkwarden/docker-compose.yml
• 环境文件: /root/linkwarden/.env
• 应用数据： /root/linkwarden/data
• PostgreSQL 数据: /root/linkwarden/pgdata
• Meilisearch 数据： /root/linkwarden/meili_data
• Nginx 配置： /etc/nginx/sites-available/linkwarden

Docker 管理

查看容器：

cd /root/linkwarden
docker compose ps

查看日志:

cd /root/linkwarden
docker compose logs -f

查看 Linkwarden 日志：

cd /root/linkwarden
docker compose logs -f linkwarden

重启 Linkwarden：

cd /root/linkwarden
docker compose restart linkwarden

停止 stack:

cd /root/linkwarden
docker compose down

启动 stack:

cd /root/linkwarden
docker compose up -d

NGINX 管理

检查 NGINX：

systemctl status nginx

测试配置：

nginx -t

重启 NGINX：

systemctl restart nginx

重新加载 NGINX：

systemctl reload nginx

域名与 HTTPS

1. 创建一条 A 记录用于你的应用主机名，并将其指向服务器的公网 IP 地址（例如 app.example.com).

2. 安装 Certbot：

apt update
apt install -y certbot python3-certbot-nginx

3. 编辑 NGINX 配置并替换 server_name _; 为你的域名（例如 server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. 测试配置：

nginx -t

5. 重新加载 NGINX：

systemctl reload nginx

6. 签发 TLS 证书：

certbot --nginx -d app.example.com

7. 更新 Linkwarden 的环境变量（.env 文件）：

NEXTAUTH_URL=https://app.example.com/api/v1/auth
BASE_URL=https://app.example.com

8. 修改环境变量后，重启 Linkwarden：

cd /root/linkwarden
docker compose down
docker compose up -d

9. 打开浏览器,访问: https://app.example.com

注意事项

• Linkwarden 通过 Nginx 在以下端口对外开放 80.
• Linkwarden 应用本身只监听 127.0.0.1:3000.
• PostgreSQL 和 Meilisearch 是 Docker 内部服务，不会直接暴露给宿主机。
• 配置域名时，请务必将 http:// 替换为 https:// 在所有配置了应用 URL 的位置，包括 NEXTAUTH_URL 和 BASE_URL.
• 在 NGINX 和 Linkwarden 的全部配置中，请始终使用同一个 HTTPS 域名。
• BASE_URL 在使用密码重置或验证邮件等邮件功能时尤其有用。
• 可按你的偏好修改 Linkwarden 配置。