deploy.sh 和 update.sh 面向 Linux/macOS 的 Bash。Windows 用户可在 Docker Desktop 的 Linux containers 模式下，通过 PowerShell 在项目根目录执行：

# 首次部署或默认数据库队列模式
docker compose up -d --build --force-recreate
日常更新
git pull --ff-only; if ($LASTEXITCODE -eq 0) { docker compose up -d --build --force-recreate } else { exit $LASTEXITCODE }

该方式同样自动构建后端镜像，并直接使用已提交的 frontend/dist 与 admin/dist。 Celery 模式使用 docker compose --profile celery up -d --build --force-recreate。

Docker Compose 部署

生产环境优先使用上方 deploy.sh。旧版只启动 API 和 Nginx 的手工命令不会启动 翻译队列 worker，不能用于当前版本。需要手工管理容器时，请使用本节末尾的完整示例。

新数据库不会创建默认管理员。首次启动前可在 backend/.env 同时配置 ADMIN_EMAIL 和 ADMIN_PASSWORD；创建成功后应移除 ADMIN_PASSWORD。

启动项目

cd DocTranslator
docker compose up -d --build --force-recreate

Docker Compose 从 backend/.env 读取数据库和密钥配置，并在启动服务前同步完成迁移。

默认 TRANSLATION_QUEUE_BACKEND=database，只运行数据库 worker，不需要 Redis。 需要 Celery + Redis 时，在 backend/.env 设置：

TRANSLATION_QUEUE_BACKEND=celery
CELERY_BROKER_URL=redis://redis:6379/0

然后使用 Celery profile：

docker compose --profile celery up -d --build --force-recreate

翻译结果对象存储

默认情况下，翻译结果继续保存在 /app/storage。如需把新完成的结果保存到 阿里云 OSS，可在 backend/.env 设置：

RESULT_STORAGE_BACKEND=oss
OSS_ENDPOINT=https://oss-cn-hangzhou.aliyuncs.com
OSS_BUCKET=your-private-bucket
OSS_ACCESS_KEY_ID=your-access-key-id
OSS_ACCESS_KEY_SECRET=your-access-key-secret
OSS_PREFIX=translations/

历史本地结果不会自动迁移；每条记录仍从它完成时使用的存储后端读取。 /app/storage 挂载仍然必须保留，用于源文件、翻译临时文件和历史结果。

独立 Docker 容器

不使用 Compose 时，所有容器使用同一个镜像、同一个 .env、同一个数据库和 /app/storage 挂载。

先构建镜像并创建网络：

docker build -t doctranslator ./backend
docker network create my-network

数据库队列模式：

docker run -d --name backend-container --env-file backend/.env \
  --network my-network -p 5000:5000 \
  -v $(pwd)/backend/db:/app/db \
  -v $(pwd)/backend/storage:/app/storage doctranslator
docker run -d --name backend-worker-container --env-file backend/.env \
  --network my-network \
  -v $(pwd)/backend/db:/app/db \
  -v $(pwd)/backend/storage:/app/storage \
  doctranslator python worker.py

Celery 模式额外启动 Redis 和两个 Celery worker：

docker run -d --name redis --network my-network \
  redis:7-alpine redis-server --appendonly yes
docker run -d --name celery-document-worker --env-file backend/.env \
  --network my-network \
  -v $(pwd)/backend/db:/app/db \
  -v $(pwd)/backend/storage:/app/storage \
  doctranslator celery -A app.celery_app:celery worker \
  --queues=translation.default --concurrency=2
docker run -d --name celery-pdf-worker --env-file backend/.env \
  --network my-network \
  -v $(pwd)/backend/db:/app/db \
  -v $(pwd)/backend/storage:/app/storage \
  doctranslator celery -A app.celery_app:celery worker \
  --queues=translation.pdf --concurrency=1

独立容器部署在多台主机时，/app/storage 必须使用共享文件系统；普通本地 Docker volume 不能跨主机共享翻译源文件和结果文件。

更新项目

cd /DocTranslator
git pull --ff-only && docker compose up -d --build --force-recreate