跳转到正文

Docker Compose 部署 ​

创建 Compose 配置 ​

新建一个部署目录,后续命令都在该目录执行:

sh
mkdir -p ~/sayrud
cd ~/sayrud
sudo install -d -o 10001 -g 10001 -m 0750 ./config ./data
umask 077
printf 'SAYRUD_IMAGE=ghcr.io/sayrud/sayrud:latest\nPOSTGRES_PASSWORD=%s\nREDIS_PASSWORD=%s\n' \
  "$(openssl rand -hex 24)" "$(openssl rand -hex 24)" > .env

.env 中的 POSTGRES_PASSWORD 和 REDIS_PASSWORD 分别为 PostgreSQL 和 Redis 密码,后续安装向导中也需要填写。

将以下内容保存为 compose.yaml:

yaml
services:
  sayrud:
    image: ${SAYRUD_IMAGE:?请在 .env 中设置 SAYRUD_IMAGE}
    restart: unless-stopped
    ports:
      - "2830:2830"
    stop_grace_period: 45s
    volumes:
      - ./config:/home/app/config
      - ./data:/home/app/data
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy

  postgres:
    image: postgres:17-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: sayrud
      POSTGRES_USER: sayrud
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?请在 .env 中设置 POSTGRES_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U sayrud -d sayrud"]
      interval: 2s
      timeout: 3s
      retries: 30

  redis:
    image: redis:7-alpine
    restart: unless-stopped
    environment:
      REDISCLI_AUTH: ${REDIS_PASSWORD:?请在 .env 中设置 REDIS_PASSWORD}
    command: ["redis-server", "--appendonly", "yes", "--requirepass", "${REDIS_PASSWORD}"]
    volumes:
      - redis_data:/data
    healthcheck:
      test: ["CMD-SHELL", "redis-cli ping | grep -qx PONG"]
      interval: 2s
      timeout: 3s
      retries: 30

volumes:
  postgres_data:
  redis_data:

启动并安装 ​

sh
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100 sayrud

打开 http://服务器地址:2830/setup,从日志找到 Setup token: 后的令牌,再按照 Web 安装流程操作。数据库信息填写为:

字段值
PostgreSQL 主机、端口postgres、5432
数据库名、用户名sayrud、sayrud
PostgreSQL 密码.env 中的 POSTGRES_PASSWORD
PostgreSQL SSL 模式不加密
Redis 地址redis:6379
Redis 用户名default
Redis 密码.env 中的 REDIS_PASSWORD

127.0.0.1 在应用容器中指向应用自身,不能用来连接另外两个容器。访问已有数据库时,改填容器能够访问的地址。

配置保存在 ./config/sayrud.yaml,上传文件保存在 ./data/storage。

升级和备份 ​

先停止应用,备份数据库和本地文件:

sh
umask 077
docker compose stop sayrud
docker compose exec -T postgres pg_dump -U sayrud -d sayrud -Fc > sayrud.dump
sudo tar -czf - .env config data > sayrud-files.tar.gz

更新 .env 中的 SAYRUD_IMAGE,再升级:

sh
docker compose pull sayrud
docker compose up -d sayrud
docker compose logs --tail=100 sayrud
curl -fsS http://127.0.0.1:2830/-/readyz

不要执行 docker compose down -v,它会删除数据库卷。