86a6633000
- Add debug_font_path, demo_docs_dir, e2e_api_base_url to config.py - Fix hardcoded paths in pp_structure_debug.py, create_demo_images.py - Fix hardcoded paths in test files - Update .env.example with new configuration options - Update .gitignore to exclude AI development files (.claude/, openspec/, AGENTS.md, CLAUDE.md) - Add production startup script (start-prod.sh) - Add README.md with project documentation - Add 1panel Docker deployment files (docker-compose.yml, Dockerfiles, nginx.conf) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Tool_OCR - 1Panel Docker 佈署指南
本目錄包含 1Panel 平台的 Docker 佈署配置。
前置需求
- Docker 20.10+
- Docker Compose 2.0+
- NVIDIA Container Toolkit（GPU 加速）
- MySQL 8.0+（外部資料庫）
佈署步驟
1. 配置環境變數
# 複製環境變數範本
cp .env.example .env
# 編輯配置
nano .env
必要配置項：
MYSQL_*- 資料庫連線設定SECRET_KEY- JWT 簽名金鑰（使用openssl rand -hex 32生成）DIFY_*- 翻譯 API 設定
2. 建置映像
# 建置所有服務
docker-compose build
# 或分別建置
docker-compose build backend
docker-compose build frontend
3. 啟動服務
# 啟動所有服務
docker-compose up -d
# 查看日誌
docker-compose logs -f
# 查看狀態
docker-compose ps
4. 存取服務
- 前端介面：http://your-server:12010
- API 文件：http://your-server:8000/docs
- 健康檢查：http://your-server:8000/health
服務管理
# 停止服務
docker-compose down
# 重啟服務
docker-compose restart
# 更新服務
docker-compose pull
docker-compose up -d --build
# 查看資源使用
docker stats
資料持久化
以下 Docker volumes 會自動建立：
| Volume | 用途 |
|---|---|
tool_ocr_uploads |
上傳檔案 |
tool_ocr_storage |
處理結果 |
tool_ocr_logs |
應用日誌 |
tool_ocr_models |
OCR 模型快取 |
GPU 加速
預設配置會使用 NVIDIA GPU。如果不需要 GPU 加速，請修改 docker-compose.yml，移除 deploy.resources.reservations 區塊。
常見問題
Q: 服務啟動失敗？
檢查日誌：
docker-compose logs backend
docker-compose logs frontend
Q: 資料庫連線失敗？
確認：
- MySQL 服務正在運行
- 防火牆允許連接
- 使用者權限正確
Q: GPU 不可用？
確認 NVIDIA Container Toolkit 已安裝：
nvidia-smi
docker run --rm --gpus all nvidia/cuda:11.8.0-base-ubuntu22.04 nvidia-smi
1Panel 整合
在 1Panel 中：
- 進入「應用商店」→「自訂應用」
- 上傳此目錄的所有檔案
- 配置環境變數
- 點擊「安裝」
或使用 1Panel 的「容器」功能直接導入 docker-compose.yml。