WuYongJie/flnxi-Wu

Fork 0

WuYongJie f646b71813

CI Check / check (push) Has been cancelled

Details

chore: 初始化本地仓库并同步最近改动

2025-11-18 17:50:16 +08:00

4.1 KiB

Raw Blame History

服务器测试配置指南

📋 配置步骤

1. 配置 Docker 镜像加速器（必须）

方式1：使用配置脚本（推荐）

在服务器上执行：

# 上传配置脚本到服务器
scp scripts/server/setup-docker-mirror.sh root@45.249.208.118:/root/

# SSH 登录服务器
ssh root@45.249.208.118

# 执行配置脚本
chmod +x /root/setup-docker-mirror.sh
sudo /root/setup-docker-mirror.sh

方式2：手动配置

SSH 登录服务器后执行：

# 1. 创建或编辑配置文件
sudo nano /etc/docker/daemon.json

# 2. 添加以下内容
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com"
  ]
}

# 3. 保存并退出（Ctrl+X, Y, Enter）

# 4. 重启 Docker
sudo systemctl daemon-reload
sudo systemctl restart docker

# 5. 验证配置
docker info | grep -A 10 "Registry Mirrors"

2. 更新 docker-compose.prod.yml

已更新内容：

✅ MinIO 镜像版本：minio/minio:RELEASE.2025-04-22T22-12-26Z
✅ MinIO MC 镜像版本：minio/mc:RELEASE.2025-04-22T22-12-26Z

检查配置：

# 在项目根目录执行
grep "minio" docker-compose.prod.yml

3. 拉取 MinIO 镜像

在服务器上执行：

# 拉取 MinIO 镜像（将自动使用国内镜像源）
docker pull minio/minio:RELEASE.2025-04-22T22-12-26Z
docker pull minio/mc:RELEASE.2025-04-22T22-12-26Z

# 验证镜像
docker images | grep minio

4. 检查配置

使用检查脚本：

# 上传检查脚本
scp scripts/server/check-docker-config.sh root@45.249.208.118:/root/

# 在服务器上执行
chmod +x /root/check-docker-config.sh
/root/check-docker-config.sh

5. 部署测试

使用部署脚本：

# 在本地执行（Windows PowerShell）
cd D:\sucaiku\flnxi_sucai
pwsh -ExecutionPolicy Bypass -File scripts/deploy/local-build-and-upload.ps1 `
  -Server 45.249.208.118 `
  -Username root `
  -Password lxvhNYFZ4160 `
  -CleanupAfterDeploy

或手动部署：

# 在服务器上执行
cd /root/deploy
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d

✅ 配置检查清单

部署前确认：

Docker 镜像加速器已配置
docker-compose.prod.yml 已更新（使用特定版本号）
MinIO 镜像已拉取
服务器 IP 和端口配置正确
环境变量已设置（如需要）

🧪 测试验证

1. 检查服务状态

docker compose -f docker-compose.prod.yml ps

2. 检查服务日志

# 查看应用日志
docker compose -f docker-compose.prod.yml logs -f app

# 查看 MinIO 日志
docker compose -f docker-compose.prod.yml logs -f minio

3. 访问应用

应用地址：http://45.249.208.118:4320
MinIO 控制台：http://45.249.208.118:9001
健康检查：http://45.249.208.118:4320/api/health

🔧 故障排查

问题1：镜像拉取失败

原因：未配置镜像加速器或网络问题

解决：

# 检查镜像加速器配置
docker info | grep -A 10 "Registry Mirrors"

# 如果未配置，运行配置脚本
sudo bash scripts/server/setup-docker-mirror.sh

问题2：MinIO 启动失败

原因：镜像版本不存在或配置错误

解决：

# 检查镜像是否存在
docker images | grep minio

# 重新拉取镜像
docker pull minio/minio:RELEASE.2025-04-22T22-12-26Z

问题3：服务无法访问

原因：端口未开放或防火墙配置

解决：

# 检查端口监听
netstat -tlnp | grep -E "4320|9000|9001"

# 检查防火墙
sudo ufw status
# 如需开放端口
sudo ufw allow 4320/tcp
sudo ufw allow 9000/tcp
sudo ufw allow 9001/tcp

📝 注意事项

版本号管理：
- 使用特定版本号确保稳定性
- 更新版本前必须在测试环境验证
镜像源配置：
- 必须配置国内镜像源
- 配置后需要重启 Docker 服务
数据备份：
- 部署前建议备份数据库
- MinIO 数据存储在 Docker volume 中

最后更新：2025-11-15

4.1 KiB Raw Blame History Unescape Escape