Docker 部署¶
镜像构建¶
# 标准镜像(多阶段构建:Node 构建前端 + Rust 构建后端)
docker build -f docker/Dockerfile -t linklist .
# 国内网络镜像(走代理拉取基础镜像)
docker build -f docker/CN.Dockerfile -t linklist .
# 或 just docker-build
三种数据库形态¶
基础编排 docker/compose.yaml 为 SQLite 单容器形态;PostgreSQL / MySQL
形态通过叠加 overlay 编排文件启用(官方数据库镜像 + 健康检查 +
持久化卷,linklist 仅在数据库健康后启动):
# SQLite(默认形态)
docker compose -f docker/compose.yaml up -d
# PostgreSQL(官方 postgres 镜像)
docker compose -f docker/compose.yaml -f docker/compose.postgres.yaml up -d
# MySQL(官方 mysql 镜像 8.4)
docker compose -f docker/compose.yaml -f docker/compose.mysql.yaml up -d
just 任务:just docker-up / just docker-up-postgres /
just docker-up-mysql;停止:just docker-down /
just docker-down-postgres / just docker-down-mysql。
数据库凭据¶
overlay 通过 Compose 变量插值读取凭据(优先级:shell 环境 >
docker/.env > overlay 内默认值)。建议把凭据写入 docker/.env:
# docker/.env(PostgreSQL 形态)
POSTGRES_USER=linklist
POSTGRES_PASSWORD=change-me
POSTGRES_DB=linklist
# docker/.env(MySQL 形态;密码请用字母数字,避免连接串特殊字符转义问题)
MYSQL_USER=linklist
MYSQL_PASSWORD=change-me
MYSQL_DATABASE=linklist
MYSQL_ROOT_PASSWORD=change-me-root
生产部署务必覆盖默认凭据。中国网络环境拉取镜像遵循仓库 docker mtrans
约定:docker mtrans spull postgres:17 / docker mtrans spull mysql:8.4。
数据与卷¶
- linklist 容器:数据目录挂载在
../data:/app/data——无论使用哪种 数据库,网页快照、预览图、favicon 缓存与上传资产都写此目录。 - SQLite 形态:数据库文件也在该目录(
linklist.db)。 - PostgreSQL / MySQL 形态:数据库数据分别在命名卷
postgres_data/mysql_data中。
SQLite 形态需要目录归属容器运行用户(uid 65532):
容器环境变量¶
容器内无需配置文件,所有配置项通过 LINKLIST_* 环境变量注入(优先级高于
config.toml,见配置参考)。常用:
environment:
LINKLIST_ADMIN_PASSWORD: "change-me" # 预置管理员口令(仅首次 setup 生效)
LINKLIST_GUEST_SHARING: "true" # 允许匿名访客查看公开共享书签
LINKLIST_LOG: info
备份与恢复¶
三种数据库的备份/恢复命令、数据目录(快照与资产)打包、跨库迁移与定期
备份建议,见备份与恢复。要点:数据库与 data/
目录文件必须成对备份;恢复前先停 linklist 容器。