Web配置对接使用教程
一、机器人端Web基础配置
在机器人管理端找到「Web配置」页面，按以下说明填写基础对接参数：
1. 对接端口
- 填写范围：
1025 ~ 65535之间的纯数字，示例填写30001 - 作用：机器人对外开放的通信端口，Web后台通过该端口与机器人建立连接
- 注意：需确保服务器/本地防火墙已开放该端口，否则外网无法正常通信
2. 对接密钥
- 可直接留空，当前版本暂未启用强校验，后续版本将用于接口鉴权加密
- 若填写自定义密钥，需与Web后台配置保持完全一致，否则无法正常通信
3. 外网地址
- 填写格式：
http://服务器公网IP:对接端口，示例http://111.159.65.36:30001 - 作用：Web后台访问机器人的公网通信地址
- 配置完成后点击右侧「检测状态」按钮，可验证端口是否对外开放、通信是否正常
4. 对接地址
- 填写WebUI管理系统的登录页面地址，示例 https://v3.iqapi.cn/user/login.php
- 作用：用于跳转登录Web管理后台，填写对应官方或自建的Web系统地址即可
官方标准对接步骤
页面底部附带完整对接流程指引：
- 若外网通信失败，优先检查端口是否开放、服务器防火墙是否放行，可参考官方端口教程排查
- 浏览器访问填写的「对接地址」，首次登录自动注册账号，账号必须使用绑定的主人QQ号，密码自行设置
- 登录Web管理系统后，进入「通信配置」→「添加服务」，按提示完成连接绑定
二、WebUI管理后台服务配置
登录WebUI管理后台，进入「服务管理/通信配置」页面，可管理所有已绑定的机器人服务。
1. 服务列表说明
- 连接：点击「连接」按钮，可手动发起与对应机器人的通信连接
- 当前：标记「是」代表当前正在使用的机器人服务
- 服务ID：系统自动生成的服务唯一编号
- 地址Url：对应机器人的外网通信地址
- 状态：显示「正常」代表通信连接成功，异常则显示对应错误状态
- 备注：自定义服务备注，方便区分多台机器人
- 操作列：黄色编辑按钮可修改服务地址与备注；红色删除按钮可移除该服务
2. 添加新服务
点击左上角「+ 添加」按钮，弹出添加弹窗：
- 连接地址：填写机器人端配置的外网地址，格式为
http://IP:端口 - 备注：填写自定义标识，例如「腾讯云1号」「私人订制」，方便区分多台机器
- 填写完成后点击「添加」，服务会保存至列表中
3. 连接与日常管理
- 添加完成后，在列表中点击对应服务左侧的「连接」按钮
- 等待系统校验通信，状态变为「正常」即代表对接成功
- 「当前」列标记为「是」的服务，为当前后台正在管理的机器人
- 如需切换管理其他机器人，点击对应服务的「连接」按钮即可一键切换
三、完整对接流程总结
- 机器人端设置对接端口（如30001），确保服务器防火墙、安全组放行该端口
- 填写外网地址，点击「检测状态」确认端口通信正常
- 填写WebUI对接地址，点击右上角「保存配置」生效
- 浏览器打开对接地址，用主人QQ号注册登录Web后台
- 后台进入服务管理页面，添加机器人外网地址
- 点击连接，状态显示「正常」，对接完成
四、常见问题与注意事项
-
检测状态失败/通信异常
- 优先检查服务器安全组、系统防火墙是否放行对应端口
- 确认外网地址的IP和端口填写正确，不要遗漏
http://前缀 - 本地部署无公网IP的环境，需先做内网穿透获取公网访问地址
-
连接后状态异常
- 确认机器人程序正常运行，Web配置已点击「保存配置」生效
- 核对外网地址的端口与机器人端对接端口是否一致
- 若设置了对接密钥，确保两端密钥填写完全一致
-
多服务管理说明
- 支持添加多台机器人服务，可在后台一键切换管理
- 「清空」按钮可批量删除所有服务，操作前请确认，避免误删
- 建议给每台服务添加清晰备注，方便区分不同服务器、不同用途的机器人