DocTranslator 一键部署指南

在服务器上快速部署和更新 DocTranslator。

🚨 部署前准备 (必做)

在运行任何部署脚本之前，您必须先配置好环境变量。

1. 配置环境变量 进入项目后端目录，复制并编辑 .env 文件。此文件包含数据库连接、API 密钥等核心配置。

   # 在 DocTranslator 目录下执行
   cd backend
   cp .env.example .env
   vim .env

   请务必填写以下关键信息：

   • PROD_DATABASE_URL: 数据库连接字符串 (格式: mysql+pymysql://用户名:密码@数据库地址/数据库名)
   • 其他相关 API Key

2. 安装依赖 确保您的服务器已安装 Git 和 Docker。

3. 克隆代码 如果您是第一次部署，请先克隆项目到本地。

   git clone https://github.com/mingchen666/DocTranslator.git
   cd DocTranslator

⚡ 快速开始

🚀 一键部署 (首次部署)

此脚本用于新服务器或完全重置环境。它会自动创建 Docker 网络、构建镜像并启动所有服务。

# 赋予脚本执行权限 (仅需执行一次)
chmod +x deploy.sh

# 运行一键部署脚本
./deploy.sh

🔄 一键更新 (日常更新)

当项目有新版本发布时，使用此脚本。它会自动拉取最新代码、重新构建并重启服务，同时保留您的数据。

# 赋予脚本执行权限 (仅需执行一次)
chmod +x update.sh

# 运行一键更新脚本
./update.sh

🌐 访问服务

部署成功后，您可以通过以下地址访问服务：

• 前端: http://localhost:1475
• 管理端: http://localhost:8081
• 后端 API: http://localhost:5000

📖 脚本说明

脚本	用途	特点
deploy.sh	初始化部署	创建网络和目录，覆盖所有旧容器
update.sh	日常更新	仅更新代码和镜像，保留 backend-storage 数据

❓ 常见问题

• 问：提示 git pull 失败？答： 您可能修改了某些文件导致冲突。如需强制覆盖本地修改，请执行：

  git reset --hard origin/main

  然后再运行 ./update.sh。

• 问：提示 Permission denied？答： 脚本没有执行权限，请先运行 chmod +x deploy.sh 和 chmod +x update.sh。

• 问：端口被占用？答： 请检查 5000, 1475, 8081 端口是否被其他程序占用，或修改脚本中的端口映射即可。