Docker Compose 部署

Docker Compose 部署带 Redis 和 PostgreSQL，是小规模生产环境最常用的方式。 数据持久化在 PostgreSQL，流程执行队列走 Redis，稳定可靠。

前提条件

• 已安装 Docker 与 Docker Compose
• 服务器至少 4GB 内存（PostgreSQL + Redis + 链盒共用）
• 有公网 IP（如需 Webhook 触发器）

部署步骤

1. 获取部署文件

从官方仓库获取 docker-compose 配置：

git clone https://github.com/linkoo/linkoo.git
cd linkoo

2. 生成环境变量

运行部署脚本生成 .env 文件（含随机密钥）：

sh tools/deploy.sh

脚本会生成 .env，内含数据库密码、JWT 密钥等。生产环境请核对并保管好这些值。

3. 配置 Webhook URL（重要）

如果服务器有公网 IP，编辑 .env 设置 Webhook 回调地址，否则 Webhook 和应用触发器无法正常工作：

AP_WEBHOOK_URL=https://your-domain.com

4. 启动服务

docker compose up -d

首次启动会拉取镜像并初始化数据库，约需 1-2 分钟。完成后访问 http://your-server:3000。

5. 检查状态

docker compose ps
docker compose logs -f

确认所有容器状态为 running，日志无报错。

升级

自动拉取

docker compose pull
docker compose up -d

Compose 会自动用新镜像重建容器，数据卷保留。

手动指定版本

如需固定到特定版本，编辑 .env：

AP_IMAGE_TAG=0.83.0

然后重新 pull && up -d。

备份与恢复

定期备份 PostgreSQL 数据卷：

docker compose exec db pg_dump -U postgres linkoo > backup.sql

恢复：

cat backup.sql | docker compose exec -T db psql -U postgres linkoo

常用运维命令

docker compose restart        # 重启所有服务
docker compose down           # 停止并删除容器（数据卷保留）
docker compose logs -f app    # 只看链盒应用日志
docker compose exec app sh    # 进入应用容器排查