docs: expand Docker deployment instructions in README

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-13 22:38:58 +08:00
parent 5e69e5a841
commit d5b4cc7b77
+25 -11
View File
@@ -57,28 +57,42 @@ cd web && python -m uvicorn backend.main:app --host 0.0.0.0 --port 8000
**默认账号:** `admin` / `admin123`(首次登录后建议修改密码)
### Docker 部署
### Docker 部署 (生产环境)
**环境要求:** Docker + Docker Compose
```bash
# 构建并启动
# 1. 克隆代码
git clone https://gitea.94kan.cn/houhuan/orc-order-v2.git
cd orc-order-v2
# 2. 配置环境变量(百度 OCR API 密钥、Gitea Token 等)
cp .env.example .env # 若无 .env.example,手动创建 .env
# 编辑 .env 填入:
# BAIDU_OCR_API_KEY=xxx
# BAIDU_OCR_SECRET_KEY=xxx
# GITEA_TOKEN=xxx
# 3. 构建并启动
docker-compose up -d --build
# 访问
# 4. 访问
# 前端: http://服务器IP:18888
# 后端 API: http://服务器IP:18889
# 默认账号: admin / admin123(首次登录后建议修改密码)
# 查看日志
docker-compose logs -f
# 停止
docker-compose down
# 常用命令
docker-compose logs -f # 查看日志
docker-compose restart # 重启服务
docker-compose down # 停止服务
docker-compose up -d --build # 重新构建并启动
```
**端口说明:**
- `18888` — 前端 (Nginx)
- `18889` — 后端 API (FastAPI)
- `18888` — 前端 (Nginx),对外访问入口
- `18889` — 后端 API (FastAPI),前端自动代理,无需直接访问
**数据持久化:** `data/` 目录挂载到宿主机,数据库上传文件不会丢失。
**数据持久化:** `data/` 目录挂载到宿主机,SQLite 数据库上传文件、处理结果不会因容器重建而丢失。
## 项目结构