shudao-main

蜀道安全管理AI智能助手 - 部署指南

1. 环境准备

1.1 配置文件

本项目使用 conf/app.conf 进行配置管理。该文件未包含在版本控制中，部署时需要手动创建。

步骤:

1. 进入项目根目录 shudao-go-backend。

2. 复制配置模板:

   cp conf/app.conf.example conf/app.conf
   

3. 编辑 conf/app.conf，根据当前环境（本地/测试/生产）修改配置项。

1.2 关键配置项说明

• base_url: 系统基础URL，用于生成OSS代理链接等。
• mysql_*: 数据库连接信息。
• oss_*: 对象存储配置（MinIO/S3）。
• deepseek_api_key: AI模型API密钥。
• yolo_base_url: 隐患识别服务地址。

2. 部署流程

2.1 本地开发 (Local Development)

支持热重载，适合开发调试。

# 确保已安装 bee 工具
go install github.com/beego/bee/v2@latest

# 启动服务
cd shudao-go-backend
bee run

2.2 测试/生产环境部署 (Production Deployment)

编译:

cd shudao-go-backend
go build -o shudao-chat-go main.go

运行:

# 赋予执行权限
chmod +x shudao-chat-go

# 启动服务 (建议使用 nohup 或 supervisor 管理进程)
nohup ./shudao-chat-go &

3. 验证部署

1. 检查日志: 查看 nohup.out 或控制台输出，确认没有配置加载错误。
2. 健康检查: 访问 /api/health (如果已实现) 或尝试调用基础接口。
3. 功能验证:
   • 上传一张图片，验证OSS配置是否正确。
   • 发起一次AI对话，验证模型服务配置。

4. 常见问题

Q: 启动时报错 "配置项 xxx 未设置或为空" A: 检查 conf/app.conf 是否包含该配置项，且值不为空。

Q: 数据库连接失败 A: 检查 mysql_urls 和 mysql_port 是否正确，以及防火墙是否允许连接。

Q: 图片无法预览 A: 检查 base_url 是否配置为当前环境的可访问地址（如 https://aqai.shudaodsj.com:22000）。