对接E云管家与Dify
编辑 | blame | 历史 | 原始文档

E云管家-DifyAI对接服务 Windows部署指南

概述

本文档介绍如何在Windows服务器上部署E云管家-DifyAI对接服务的exe版本。

系统要求

  • Windows Server 2016 或更高版本
  • Windows 10/11 (用于测试)
  • 至少 2GB 可用内存
  • 至少 1GB 可用磁盘空间
  • 网络连接（用于访问数据库、Redis、E云管家和DifyAI服务）

部署步骤

1. 准备部署文件

确保以下文件存在于部署目录中：
- ecloud_dify.exe - 主程序文件
- config.production.json - 生产环境配置模板
- config.example.json - 配置示例文件
- install_service.bat - Windows服务安装脚本
- uninstall_service.bat - Windows服务卸载脚本
- start.bat - 直接启动脚本（非服务模式）

2. 配置服务

2.1 创建配置文件

  1. 复制 config.production.json 为 config.json
  2. 编辑 config.json 文件，修改以下配置：
{
  "database": {
    "url": "mysql+pymysql://用户名:密码@数据库地址:端口/数据库名"
  },
  "redis": {
    "url": "redis://Redis地址:端口/数据库编号"
  },
  "ecloud": {
    "base_url": "E云管家API地址",
    "authorization": "E云管家授权令牌"
  },
  "dify": {
    "base_url": "DifyAI API地址",
    "api_key": "DifyAI API密钥"
  },
  "server": {
    "host": "0.0.0.0",
    "port": 7979,
    "debug": false
  }
}

2.2 配置说明

  • database.url: MySQL数据库连接字符串
  • redis.url: Redis服务器连接字符串
  • ecloud: E云管家相关配置
  • dify: DifyAI相关配置
  • server: 服务器监听配置

3. 安装和启动服务

方式一：Windows服务模式（推荐）

  1. 安装服务：
  • 右键点击 install_service.bat
  • 选择"以管理员身份运行"
  • 按照提示完成安装
  1. 管理服务：
    ```cmd
    # 启动服务
    sc start ECloudDifyService

# 停止服务
sc stop ECloudDifyService

# 查看服务状态
sc query ECloudDifyService

# 删除服务
sc delete ECloudDifyService
```

  1. 卸载服务：
  • 右键点击 uninstall_service.bat
  • 选择"以管理员身份运行"

方式二：直接运行模式

  1. 双击 start.bat 启动服务
  2. 按 Ctrl+C 停止服务

4. 验证部署

  1. 检查服务状态：
  • 访问 http://服务器IP:7979/health
  • 应该返回健康检查信息
  1. 查看日志：
  • 日志文件位于 logs/app.log
  • 检查是否有错误信息
  1. 测试API：
  • 访问 http://服务器IP:7979/
  • 应该返回服务信息

防火墙配置

确保Windows防火墙允许端口7979的入站连接：

# 添加防火墙规则
netsh advfirewall firewall add rule name="ECloudDify Service" dir=in action=allow protocol=TCP localport=7979

故障排除

常见问题

  1. 服务启动失败：
  • 检查配置文件格式是否正确
  • 确认数据库和Redis连接是否正常
  • 查看日志文件获取详细错误信息
  1. 端口被占用：
  • 修改配置文件中的端口号
  • 或者停止占用端口的其他程序
  1. 权限问题：
  • 确保以管理员身份运行安装脚本
  • 检查exe文件的执行权限
  1. 网络连接问题：
  • 检查防火墙设置
  • 确认网络连接正常

日志查看

日志文件位置：logs/app.log

常用日志级别：
- INFO: 一般信息
- WARNING: 警告信息
- ERROR: 错误信息

性能优化

  1. 内存优化：
  • 监控内存使用情况
  • 必要时调整系统内存分配
  1. 网络优化：
  • 确保网络延迟较低
  • 使用高速网络连接
  1. 数据库优化：
  • 优化数据库连接池设置
  • 定期清理日志数据

安全建议

  1. 配置文件安全：
  • 保护配置文件中的敏感信息
  • 设置适当的文件权限
  1. 网络安全：
  • 使用HTTPS（如果支持）
  • 限制访问IP范围
  1. 定期更新：
  • 定期更新服务版本
  • 关注安全补丁

联系支持

如遇到问题，请提供以下信息：
- 错误日志内容
- 配置文件（隐藏敏感信息）
- 系统环境信息
- 问题复现步骤