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://server-address: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,這會刪除資料庫卷。