230 lines
4.8 KiB
Markdown
230 lines
4.8 KiB
Markdown
# CpyGateway 打包和部署指南
|
||
|
||
## 环境要求
|
||
|
||
### 开发环境(打包机器)
|
||
- Python 3.8 或更高版本
|
||
- Windows 操作系统
|
||
- 管理员权限(可选,但建议)
|
||
|
||
### 目标环境(运行机器)
|
||
- Windows 7 或更高版本
|
||
- 无需安装Python
|
||
- 无需安装依赖库
|
||
|
||
## 打包步骤
|
||
|
||
### 方法1:使用批处理脚本(推荐)
|
||
|
||
1. 打开命令提示符,进入项目目录:
|
||
```cmd
|
||
cd d:\Qt\CpyAlgorithmServerQt\PythonGateway
|
||
```
|
||
|
||
2. 运行打包脚本:
|
||
```cmd
|
||
build.bat
|
||
```
|
||
|
||
3. 等待打包完成,生成的exe文件位于 `dist\CpyGateway_v1.0.0.exe`(版本号会根据version.py自动更新)
|
||
|
||
### 方法2:手动打包
|
||
|
||
1. 安装PyInstaller:
|
||
```cmd
|
||
pip install pyinstaller
|
||
```
|
||
|
||
2. 安装项目依赖:
|
||
```cmd
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
3. 执行打包命令:
|
||
```cmd
|
||
pyinstaller CpyGateway.spec
|
||
```
|
||
|
||
4. 打包完成后,exe文件位于 `dist\CpyGateway_v1.0.0.exe`(版本号会根据version.py自动更新)
|
||
|
||
## 部署步骤
|
||
|
||
### 1. 准备部署包
|
||
|
||
将以下文件/文件夹复制到目标电脑:
|
||
|
||
```
|
||
CpyGateway/
|
||
├── dist/
|
||
│ └── CpyGateway.exe # 主程序
|
||
├── config.json # 配置文件(可选,程序会自动生成默认配置)
|
||
└── README_DEPLOY.md # 部署说明
|
||
```
|
||
|
||
### 2. 修改配置文件(可选)
|
||
|
||
根据目标环境修改 `config.json`:
|
||
|
||
```json
|
||
{
|
||
"device_id": "1",
|
||
"file_root": "D:\\CPY_DTAT",
|
||
"template_path": "D:\\Python\\CPY_Server\\InStructTemplate.mat",
|
||
"http": {
|
||
"host": "0.0.0.0",
|
||
"port": 5000
|
||
},
|
||
"mqtt": {
|
||
"enable": true,
|
||
"broker": "123.57.81.127",
|
||
"port": 1883,
|
||
"username": "test",
|
||
"password": "test",
|
||
"keepalive": 60,
|
||
"topic_prefix": "v1/cpycal/"
|
||
},
|
||
"udp": {
|
||
"udp_map": {}
|
||
},
|
||
"logging": {
|
||
"level": "INFO",
|
||
"file": "cpy_server.log"
|
||
}
|
||
}
|
||
```
|
||
|
||
**重要配置项说明**:
|
||
- `file_root`: 数据文件存储根目录,确保该目录存在且有写入权限
|
||
- `template_path`: MATLAB模板文件路径,确保文件存在
|
||
- `mqtt.broker`: MQTT服务器地址,根据实际环境修改
|
||
- `http.port`: HTTP服务端口,确保端口未被占用
|
||
|
||
### 3. 创建必要的目录
|
||
|
||
在目标电脑上创建数据存储目录:
|
||
|
||
```cmd
|
||
mkdir D:\CPY_DTAT
|
||
```
|
||
|
||
如果使用MATLAB计算,还需要:
|
||
```cmd
|
||
mkdir D:\Python\CPY_Server
|
||
```
|
||
|
||
并将 `InStructTemplate.mat` 文件复制到该目录。
|
||
|
||
### 4. 运行程序
|
||
|
||
双击 `CpyGateway.exe` 运行程序,或在命令行中运行:
|
||
|
||
```cmd
|
||
cd dist
|
||
CpyGateway.exe
|
||
```
|
||
|
||
### 5. 验证运行
|
||
|
||
打开浏览器访问:`http://localhost:5000/api/status`
|
||
|
||
应该看到类似以下响应:
|
||
|
||
```json
|
||
{
|
||
"running": "true",
|
||
"mqtt_connected": true
|
||
}
|
||
```
|
||
|
||
## 常见问题
|
||
|
||
### 1. 防火墙提示
|
||
|
||
首次运行时,Windows防火墙可能会提示是否允许程序访问网络,请选择"允许"。
|
||
|
||
### 2. 端口被占用
|
||
|
||
如果提示端口5000被占用,可以修改 `config.json` 中的端口号:
|
||
|
||
```json
|
||
"http": {
|
||
"host": "0.0.0.0",
|
||
"port": 5001 // 修改为其他端口
|
||
}
|
||
```
|
||
|
||
### 3. 文件权限错误
|
||
|
||
确保程序有权限读写 `file_root` 指定的目录。可以右键目录 -> 属性 -> 安全,添加用户权限。
|
||
|
||
### 4. MATLAB相关错误
|
||
|
||
如果程序需要与MATLAB网关通信:
|
||
- 确保MATLAB网关程序正在运行
|
||
- 确保UDP端口配置正确
|
||
- 检查防火墙是否阻止了UDP通信
|
||
|
||
### 5. MQTT连接失败
|
||
|
||
检查 `config.json` 中的MQTT配置:
|
||
- 确认broker地址正确
|
||
- 确认端口正确(默认1883)
|
||
- 确认用户名和密码正确
|
||
- 确认网络可以访问MQTT服务器
|
||
|
||
## 日志查看
|
||
|
||
程序运行日志保存在 `cpy_server.log` 文件中,位于exe文件同级目录。
|
||
|
||
如果遇到问题,请查看日志文件获取详细错误信息。
|
||
|
||
## 卸载
|
||
|
||
要卸载程序:
|
||
|
||
1. 停止程序(如果正在运行)
|
||
2. 删除程序文件夹
|
||
3. 删除数据目录(如果需要)
|
||
|
||
## 更新
|
||
|
||
要更新程序:
|
||
|
||
1. 停止旧版本程序
|
||
2. 备份 `config.json` 文件
|
||
3. 用新版本的 `CpyGateway.exe` 替换旧版本
|
||
4. 恢复 `config.json` 文件
|
||
5. 启动新版本程序
|
||
|
||
## 性能优化建议
|
||
|
||
1. **关闭控制台窗口**:如果不需要看到控制台输出,可以修改 `CpyGateway.spec` 文件:
|
||
```python
|
||
console=False, # 改为False
|
||
```
|
||
然后重新打包。
|
||
|
||
2. **启用UPX压缩**:spec文件中已启用UPX压缩,可以减小exe文件大小。
|
||
|
||
3. **日志级别调整**:在生产环境中,可以将日志级别改为 `WARNING` 或 `ERROR`:
|
||
```json
|
||
"logging": {
|
||
"level": "WARNING",
|
||
"file": "cpy_server.log"
|
||
}
|
||
```
|
||
|
||
## 技术支持
|
||
|
||
如遇到问题,请:
|
||
1. 查看日志文件 `cpy_server.log`
|
||
2. 检查配置文件 `config.json`
|
||
3. 参考API文档 `API_DOCUMENTATION.md`
|
||
4. 联系技术支持
|
||
|
||
## 版本信息
|
||
|
||
- 版本:1.0.0
|
||
- 打包日期:2026-01-05
|
||
- Python版本:3.11
|