Cat2Bug-App连接自定义Bug平台配置指南

1. Cat2Bug-App连接自定义Bug平台全指南

作为一款专业的Bug管理系统，Cat2Bug提供了完整的网页端和移动端解决方案。很多团队在部署了Cat2Bug-Platform后，都希望手机端App能够连接到自己部署的服务器而非官方平台。本文将详细介绍如何实现这一需求。

Cat2Bug-App最新版本已经支持自定义服务器配置（注意：微信小程序版本暂不支持此功能），通过简单的配置即可让App连接到您自己部署的Cat2Bug-Platform。下面我将从原理到实操，一步步带您完成整个配置过程。

2. 配置前的准备工作

2.1 确认部署方式

在开始配置前，您需要先确认自己部署Cat2Bug-Platform的方式，这直接决定了后续需要填写的服务器地址格式：

1. 单JAR部署：前后端打包在同一个JAR文件中运行

   • 典型场景：小型团队或测试环境
   • 特点：部署简单，维护方便
   • 接口地址格式：http://服务器IP:端口

2. 前后端分离部署：前端和后端分别独立部署

   • 典型场景：中大型团队或生产环境
   • 特点：性能更好，扩展性强
   • 接口地址格式：http://服务器IP:端口/prod-api

提示：如果您不确定自己的部署方式，可以检查启动命令或部署文档。单JAR部署通常会使用类似java -jar cat2bug-platform.jar的命令启动。

2.2 获取服务器信息

您需要准备以下信息：

• 服务器IP地址或域名
• 服务端口号（默认通常是8080）
• 确保服务器已正确部署且网络可达
• 确保手机与服务器在同一网络或可通过公网访问

3. 详细配置步骤

3.1 进入配置界面

1. 打开Cat2Bug-App（确保是最新版本）
2. 在登录界面，找到并点击右下角的"配置"链接
3. 系统将跳转到服务器配置页面

3.2 填写服务器地址

根据您的部署方式，在"服务器地址"输入框中填写对应的地址：

• 单JAR部署：

  code复制http://您的服务器IP:端口
  

  示例：http://192.168.1.100:8080

• 前后端分离部署：

  code复制http://您的服务器IP:端口/prod-api
  

  示例：http://api.yourcompany.com/prod-api

注意：地址中不要包含多余的空格或特殊字符，且必须以http://或https://开头。

3.3 保存并验证配置

1. 填写完服务器地址后，点击"确定"按钮
2. 系统会自动跳转回登录页面
3. 尝试使用您的平台账号登录
   • 如果登录成功，说明配置正确
   • 如果登录失败，请检查以下方面：
     • 服务器地址是否正确
     • 服务器是否正常运行
     • 网络连接是否正常
     • 防火墙设置是否允许该端口的访问

4. 常见问题排查

4.1 无法连接到服务器

可能原因：

1. 服务器地址填写错误
2. 服务器未启动或崩溃
3. 网络连接问题
4. 防火墙/安全组限制

解决方案：

1. 使用ping命令测试服务器是否可达
2. 在电脑浏览器中尝试访问API接口（如http://服务器IP:端口/api/test）
3. 检查服务器日志查看是否有错误
4. 确认防火墙设置允许来自移动设备的连接

4.2 登录失败

可能原因：

1. 服务器地址配置不正确
2. 账号密码错误
3. 服务器数据库连接问题
4. 跨域问题（前后端分离部署时）

解决方案：

1. 重新检查服务器地址配置
2. 尝试在网页端使用相同账号登录测试
3. 检查服务器数据库连接状态
4. 对于前后端分离部署，确保已正确配置CORS

4.3 配置不生效

可能原因：

1. 使用的是微信小程序版本（不支持自定义配置）
2. App版本过旧
3. 缓存问题

解决方案：

1. 确认使用的是原生App而非微信小程序
2. 升级到最新版Cat2Bug-App
3. 清除App缓存后重试

5. 高级配置建议

5.1 使用域名而非IP地址

建议为您的Cat2Bug-Platform配置一个专用域名，这样：

• 更专业且易于记忆
• 方便未来服务器迁移
• 可以启用HTTPS加密

配置示例：

code复制https://bug.yourcompany.com/prod-api

5.2 启用HTTPS安全连接

为了数据传输安全，建议：

1. 申请SSL证书
2. 在服务器配置HTTPS
3. 将HTTP请求重定向到HTTPS
4. 在App中使用https://开头的地址

5.3 多环境配置管理

对于大型团队，可以考虑：

• 为开发、测试、生产环境配置不同的服务器地址
• 使用环境变量或配置文件管理这些地址
• 为团队成员提供各环境的配置说明

6. 最佳实践分享

在实际使用中，我发现以下几点特别重要：

1. 文档记录：为团队维护一份标准的服务器配置文档，包括各环境的地址、账号等信息。

2. 版本控制：确保App版本与平台版本兼容，特别是进行大版本升级时。

3. 网络优化：如果服务器在公网，考虑使用CDN加速API响应速度。

4. 监控设置：配置服务器健康监控，及时发现连接问题。

5. 定期测试：每月进行一次连接测试，确保配置持续有效。

对于企业用户，我建议将Cat2Bug-App的自定义配置纳入IT标准化管理流程，包括：

• 统一的域名规范
• 标准的SSL证书管理
• 定期的安全审计
• 员工使用培训

通过以上措施，可以确保移动端与自建Bug管理平台的无缝对接，提升团队的问题跟踪和处理效率。