Add Baota panel Docker setup guide and scripts

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-05 21:31:25 +08:00
parent 02ae5855a8
commit 9c0f6153b8
3 changed files with 496 additions and 0 deletions
--- a/deploy/scripts/baota-setup.sh
+++ b/deploy/scripts/baota-setup.sh
@@ -0,0 +1,104 @@
+#!/bin/bash
+# 宝塔面板一键部署脚本
+# 用途：在宝塔面板服务器上快速部署项目
+
+set -e
+
+PROJECT_DIR="/www/wwwroot/wecom-ai-assistant"
+REGISTRY_URL="git.quanyu360.cn"
+REGISTRY_USER="admin"
+REGISTRY_PASS="ye972030"
+
+echo "=== 宝塔面板一键部署 ==="
+echo ""
+
+# 检查 Docker 是否安装
+if ! command -v docker &> /dev/null; then
+    echo "错误: Docker 未安装"
+    echo "请在宝塔面板中安装 Docker"
+    exit 1
+fi
+
+# 检查 docker-compose 是否安装
+if ! command -v docker-compose &> /dev/null && ! docker compose version &> /dev/null; then
+    echo "警告: docker-compose 未安装，尝试安装..."
+    # 尝试安装 docker-compose
+    pip3 install docker-compose 2>/dev/null || {
+        echo "请手动安装 docker-compose"
+        exit 1
+    }
+fi
+
+# 创建项目目录
+echo "1. 创建项目目录..."
+mkdir -p "$PROJECT_DIR"
+cd "$PROJECT_DIR"
+echo "✓ 目录已创建: $PROJECT_DIR"
+echo ""
+
+# 登录 Docker Registry
+echo "2. 登录 Docker Registry..."
+echo "$REGISTRY_PASS" | docker login "$REGISTRY_URL" -u "$REGISTRY_USER" --password-stdin
+echo "✓ 登录成功"
+echo ""
+
+# 检查项目文件是否存在
+if [ ! -f "docker-compose.prod.yml" ]; then
+    echo "3. 项目文件不存在，请:"
+    echo "   - 使用 Git 克隆项目，或"
+    echo "   - 使用宝塔文件管理器上传项目文件"
+    echo ""
+    echo "Git 克隆命令:"
+    echo "  cd $PROJECT_DIR"
+    echo "  git clone https://admin:ye972030@git.quanyu360.cn/admin/wecom-ai-assistant.git ."
+    echo ""
+    exit 1
+fi
+
+# 检查环境变量文件
+if [ ! -f ".env.prod" ]; then
+    echo "3. 创建环境变量文件..."
+    if [ -f ".env.prod.example" ]; then
+        cp .env.prod.example .env.prod
+        echo "✓ 已创建 .env.prod（请编辑填写实际配置）"
+    else
+        echo "⚠ .env.prod.example 不存在，请手动创建 .env.prod"
+    fi
+    echo ""
+fi
+
+# 拉取镜像
+echo "4. 拉取 Docker 镜像..."
+if [ -f "deploy/scripts/pull-images.sh" ]; then
+    chmod +x deploy/scripts/pull-images.sh
+    ./deploy/scripts/pull-images.sh
+else
+    echo "   拉取 Backend 镜像..."
+    docker pull ${REGISTRY_URL}/wecom-ai/wecom-ai-backend:latest || echo "   ⚠ Backend 镜像拉取失败"
+    echo "   拉取 Admin 镜像..."
+    docker pull ${REGISTRY_URL}/wecom-ai/wecom-ai-admin:latest || echo "   ⚠ Admin 镜像拉取失败"
+fi
+echo ""
+
+# 启动服务
+echo "5. 启动服务..."
+if command -v docker-compose &> /dev/null; then
+    DOCKER_COMPOSE_CMD="docker-compose"
+else
+    DOCKER_COMPOSE_CMD="docker compose"
+fi
+
+$DOCKER_COMPOSE_CMD -f docker-compose.prod.yml --env-file .env.prod up -d
+echo ""
+
+# 检查服务状态
+echo "6. 服务状态:"
+$DOCKER_COMPOSE_CMD -f docker-compose.prod.yml ps
+echo ""
+
+echo "=== 部署完成 ==="
+echo ""
+echo "项目目录: $PROJECT_DIR"
+echo "查看日志: cd $PROJECT_DIR && $DOCKER_COMPOSE_CMD -f docker-compose.prod.yml logs -f"
+echo "停止服务: cd $PROJECT_DIR && $DOCKER_COMPOSE_CMD -f docker-compose.prod.yml down"
+echo ""
--- a/deploy/scripts/pull-images.sh
+++ b/deploy/scripts/pull-images.sh
@@ -0,0 +1,72 @@
+#!/bin/bash
+# 拉取私有 Registry 镜像脚本
+# 用途：在服务器上拉取 Docker 镜像
+
+set -e
+
+# 读取配置（如果存在）
+if [ -f ".registry-config" ]; then
+    source <(grep -E '^[^#]*=' .registry-config | sed 's/^/export /')
+fi
+
+# 默认配置
+REGISTRY_URL="${REGISTRY_URL:-git.quanyu360.cn}"
+REGISTRY_USER="${REGISTRY_USERNAME:-admin}"
+REGISTRY_PASS="${REGISTRY_PASSWORD:-ye972030}"
+NAMESPACE="${REGISTRY_NAMESPACE:-wecom-ai}"
+BACKEND_IMAGE="${BACKEND_IMAGE_NAME:-wecom-ai-backend}"
+ADMIN_IMAGE="${ADMIN_IMAGE_NAME:-wecom-ai-admin}"
+IMAGE_TAG="${IMAGE_TAG:-latest}"
+
+echo "=== 拉取私有 Registry 镜像 ==="
+echo ""
+echo "Registry: $REGISTRY_URL"
+echo "命名空间: $NAMESPACE"
+echo "标签: $IMAGE_TAG"
+echo ""
+
+# 登录 Registry
+echo "1. 登录 Docker Registry..."
+echo "$REGISTRY_PASS" | docker login "$REGISTRY_URL" -u "$REGISTRY_USER" --password-stdin
+if [ $? -ne 0 ]; then
+    echo "✗ 登录失败"
+    exit 1
+fi
+echo "✓ 登录成功"
+echo ""
+
+# 拉取 Backend 镜像
+echo "2. 拉取 Backend 镜像..."
+BACKEND_FULL="${REGISTRY_URL}/${NAMESPACE}/${BACKEND_IMAGE}:${IMAGE_TAG}"
+echo "   镜像: $BACKEND_FULL"
+docker pull "$BACKEND_FULL"
+if [ $? -eq 0 ]; then
+    echo "✓ Backend 镜像拉取成功"
+else
+    echo "✗ Backend 镜像拉取失败"
+    exit 1
+fi
+echo ""
+
+# 拉取 Admin 镜像
+echo "3. 拉取 Admin 镜像..."
+ADMIN_FULL="${REGISTRY_URL}/${NAMESPACE}/${ADMIN_IMAGE}:${IMAGE_TAG}"
+echo "   镜像: $ADMIN_FULL"
+docker pull "$ADMIN_FULL"
+if [ $? -eq 0 ]; then
+    echo "✓ Admin 镜像拉取成功"
+else
+    echo "⚠ Admin 镜像拉取失败（可能不存在，继续）"
+fi
+echo ""
+
+# 显示已拉取的镜像
+echo "4. 已拉取的镜像:"
+docker images | grep "$REGISTRY_URL" || echo "   无"
+echo ""
+
+echo "=== 完成 ==="
+echo ""
+echo "可以使用以下命令启动服务:"
+echo "  docker-compose -f docker-compose.prod.yml --env-file .env.prod up -d"
+echo ""
--- a/docs/baota-docker-setup.md
+++ b/docs/baota-docker-setup.md
@@ -0,0 +1,320 @@
+# 宝塔面板 Docker 私有镜像拉取指南
+
+## 概述
+
+本指南介绍如何在宝塔面板中使用 Docker 拉取私有 Registry 的镜像。
+
+## 私有 Registry 信息
+
+- **Registry URL**: `git.quanyu360.cn`
+- **用户名**: `admin`
+- **密码**: `ye972030`
+- **命名空间**: `wecom-ai`
+- **镜像名称**:
+  - Backend: `git.quanyu360.cn/wecom-ai/wecom-ai-backend:latest`
+  - Admin: `git.quanyu360.cn/wecom-ai/wecom-ai-admin:latest`
+
+## 方法一：在宝塔面板中配置 Docker 登录（推荐）
+
+### 步骤 1：登录 Docker Registry
+
+1. **打开宝塔面板终端**：
+   - 登录宝塔面板
+   - 点击左侧菜单 **"终端"** 或 **"SSH终端"**
+
+2. **执行登录命令**：
+   ```bash
+   docker login git.quanyu360.cn -u admin -p ye972030
+   ```
+
+3. **验证登录**：
+   ```bash
+   # 查看登录信息（凭据存储在 ~/.docker/config.json）
+   cat ~/.docker/config.json | grep git.quanyu360.cn
+   ```
+
+### 步骤 2：拉取镜像
+
+登录成功后，可以直接拉取镜像：
+
+```bash
+# 拉取 Backend 镜像
+docker pull git.quanyu360.cn/wecom-ai/wecom-ai-backend:latest
+
+# 拉取 Admin 镜像
+docker pull git.quanyu360.cn/wecom-ai/wecom-ai-admin:latest
+
+# 查看拉取的镜像
+docker images | grep git.quanyu360.cn
+```
+
+### 步骤 3：使用 docker-compose 部署
+
+在宝塔面板中：
+
+1. **创建项目目录**：
+   ```bash
+   mkdir -p /www/wwwroot/wecom-ai-assistant
+   cd /www/wwwroot/wecom-ai-assistant
+   ```
+
+2. **上传项目文件**：
+   - 使用宝塔文件管理器上传项目文件
+   - 或使用 Git 克隆：
+     ```bash
+     git clone https://admin:ye972030@git.quanyu360.cn/admin/wecom-ai-assistant.git .
+     ```
+
+3. **配置环境变量**：
+   ```bash
+   cp .env.prod.example .env.prod
+   # 编辑 .env.prod，填写生产环境变量
+   nano .env.prod
+   ```
+
+4. **启动服务**：
+   ```bash
+   docker-compose -f docker-compose.prod.yml --env-file .env.prod up -d
+   ```
+
+## 方法二：在 docker-compose.yml 中配置认证
+
+### 创建认证文件
+
+在服务器上创建 Docker 认证配置：
+
+```bash
+# 创建认证目录
+mkdir -p ~/.docker
+
+# 登录（会自动创建认证文件）
+docker login git.quanyu360.cn -u admin -p ye972030
+```
+
+### 更新 docker-compose.prod.yml
+
+确保 `docker-compose.prod.yml` 中的镜像地址正确：
+
+```yaml
+services:
+  backend:
+    image: git.quanyu360.cn/wecom-ai/wecom-ai-backend:${IMAGE_TAG:-latest}
+    # ... 其他配置
+```
+
+### 使用环境变量
+
+在 `.env.prod` 中配置：
+
+```bash
+REGISTRY_URL=git.quanyu360.cn
+REGISTRY_NAMESPACE=wecom-ai
+IMAGE_TAG=latest
+```
+
+## 方法三：使用宝塔 Docker 管理器
+
+### 步骤 1：安装 Docker 管理器
+
+1. 在宝塔面板中，点击 **"软件商店"**
+2. 搜索 **"Docker管理器"** 或 **"Docker"**
+3. 点击安装
+
+### 步骤 2：配置 Registry
+
+1. 打开 **Docker管理器**
+2. 找到 **"镜像管理"** 或 **"Registry"** 选项
+3. 添加私有 Registry：
+   - Registry URL: `git.quanyu360.cn`
+   - 用户名: `admin`
+   - 密码: `ye972030`
+
+### 步骤 3：拉取镜像
+
+1. 在 Docker 管理器中，点击 **"镜像"** 或 **"Images"**
+2. 点击 **"拉取镜像"** 或 **"Pull"**
+3. 输入镜像名称：
+   - `git.quanyu360.cn/wecom-ai/wecom-ai-backend:latest`
+   - `git.quanyu360.cn/wecom-ai/wecom-ai-admin:latest`
+4. 点击拉取
+
+## 方法四：使用脚本自动化
+
+### 创建拉取脚本
+
+在服务器上创建脚本 `pull-images.sh`：
+
+```bash
+#!/bin/bash
+
+# Docker Registry 配置
+REGISTRY_URL="git.quanyu360.cn"
+REGISTRY_USER="admin"
+REGISTRY_PASS="ye972030"
+NAMESPACE="wecom-ai"
+
+# 登录 Registry
+echo "登录 Docker Registry..."
+echo "$REGISTRY_PASS" | docker login $REGISTRY_URL -u $REGISTRY_USER --password-stdin
+
+# 拉取镜像
+echo "拉取 Backend 镜像..."
+docker pull ${REGISTRY_URL}/${NAMESPACE}/wecom-ai-backend:latest
+
+echo "拉取 Admin 镜像..."
+docker pull ${REGISTRY_URL}/${NAMESPACE}/wecom-ai-admin:latest
+
+# 查看镜像
+echo "已拉取的镜像:"
+docker images | grep $REGISTRY_URL
+
+echo "完成！"
+```
+
+### 使用脚本
+
+```bash
+# 赋予执行权限
+chmod +x pull-images.sh
+
+# 执行脚本
+./pull-images.sh
+```
+
+## 在宝塔面板中使用 docker-compose
+
+### 步骤 1：安装 docker-compose
+
+如果宝塔面板没有安装 docker-compose：
+
+```bash
+# 方法 1：使用 pip 安装
+pip3 install docker-compose
+
+# 方法 2：下载二进制文件
+curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
+chmod +x /usr/local/bin/docker-compose
+
+# 验证安装
+docker-compose --version
+```
+
+### 步骤 2：配置项目
+
+1. **创建项目目录**（在宝塔文件管理器中）：
+   - 路径：`/www/wwwroot/wecom-ai-assistant`
+
+2. **上传文件**：
+   - 上传 `docker-compose.prod.yml`
+   - 上传 `.env.prod`（或创建）
+   - 上传 `deploy/docker/nginx.conf`
+
+3. **配置环境变量**（`.env.prod`）：
+   ```bash
+   # Registry 配置
+   REGISTRY_URL=git.quanyu360.cn
+   REGISTRY_NAMESPACE=wecom-ai
+   IMAGE_TAG=latest
+   
+   # WeCom 配置
+   WECOM_CORP_ID=你的企业ID
+   WECOM_AGENT_ID=你的应用AgentId
+   WECOM_TOKEN=你的Token
+   WECOM_ENCODING_AES_KEY=你的43位密钥
+   
+   # 其他配置...
+   ```
+
+### 步骤 3：启动服务
+
+在宝塔终端中执行：
+
+```bash
+cd /www/wwwroot/wecom-ai-assistant
+
+# 登录 Docker Registry
+docker login git.quanyu360.cn -u admin -p ye972030
+
+# 启动服务
+docker-compose -f docker-compose.prod.yml --env-file .env.prod up -d
+
+# 查看服务状态
+docker-compose -f docker-compose.prod.yml ps
+
+# 查看日志
+docker-compose -f docker-compose.prod.yml logs -f
+```
+
+## 更新镜像
+
+### 拉取最新镜像
+
+```bash
+# 拉取最新镜像
+docker pull git.quanyu360.cn/wecom-ai/wecom-ai-backend:latest
+docker pull git.quanyu360.cn/wecom-ai/wecom-ai-admin:latest
+
+# 重启服务（使用新镜像）
+cd /www/wwwroot/wecom-ai-assistant
+docker-compose -f docker-compose.prod.yml --env-file .env.prod up -d --force-recreate
+```
+
+### 使用特定标签
+
+```bash
+# 拉取指定标签的镜像
+docker pull git.quanyu360.cn/wecom-ai/wecom-ai-backend:v1.0.0
+
+# 更新 .env.prod 中的 IMAGE_TAG
+# IMAGE_TAG=v1.0.0
+
+# 重启服务
+docker-compose -f docker-compose.prod.yml --env-file .env.prod up -d
+```
+
+## 故障排查
+
+### 问题 1：拉取镜像时提示认证失败
+
+**解决方案**：
+```bash
+# 重新登录
+docker login git.quanyu360.cn -u admin -p ye972030
+
+# 检查认证文件
+cat ~/.docker/config.json
+```
+
+### 问题 2：docker-compose 无法拉取私有镜像
+
+**解决方案**：
+1. 确保已登录：`docker login git.quanyu360.cn -u admin -p ye972030`
+2. 检查镜像名称是否正确
+3. 检查网络连接
+
+### 问题 3：宝塔面板中无法使用 docker-compose
+
+**解决方案**：
+1. 使用 SSH 终端而不是宝塔终端
+2. 或安装 docker-compose 插件
+3. 或使用 `docker compose`（新版本 Docker 内置）
+
+## 安全建议
+
+1. **保护凭据**：
+   - `.env.prod` 文件不要提交到 Git
+   - Docker 认证文件 `~/.docker/config.json` 权限设置为 600
+
+2. **使用环境变量**：
+   - 密码等敏感信息存储在环境变量中
+   - 不要硬编码在配置文件中
+
+3. **定期更新**：
+   - 定期更新镜像
+   - 定期轮换密码
+
+## 相关文档
+
+- [私有仓库配置](./private-registry-setup.md)
+- [生产部署指南](./deploy.md)
+- [Docker Compose 配置](../docker-compose.prod.yml)