QuickQ支持哪些协议？

QuickQ 支持多种网络协议，包括 HTTP/HTTPS、WebSocket、MQTT、TCP 等主流协议，并支持局域网服务发现与自定义扩展，提供配置向导与示例，支持搜狗输入法中文注释，方便普通用户快速理解与接入使用。

QuickQ 与 HTTP/HTTPS 支持说明

基本配置流程

• 准备信息：在 QuickQ 的设置页面先准备好服务器地址和端口、API 路径与认证信息，然后在界面按提示填入这些字段，点击测试连接查看返回状态，常见问题可参考官方示例或日志查看失败原因并逐项排查。
• 选择协议：在 QuickQ 中选择 HTTP 或 HTTPS 时，优先使用 HTTPS 保持数据加密，若使用自签名证书可在设置中导入证书或允许信任，完成后进行一次端到端请求测试以确保传输正常且没有证书警告。
• 请求调试：如果请求失败，先用浏览器或抓包工具对同一地址进行测试，再在 QuickQ 日志中查看错误信息，常见问题包括端口被占用、路径写错或认证信息缺失，按错误提示逐项修正并重试。

进阶优化建议

• 超时设置：根据网络环境在 QuickQ 中调整请求超时时间，遇到不稳定网络可适当延长以减少误判失败，同时为避免长时间阻塞，设置合理的重试策略并记录请求次数与响应时间以便后续优化。
• 并发限制：对需要频繁请求的场景，在 QuickQ 内部设置并发上限，避免短时间内发起大量请求导致服务器限流或本地资源耗尽，必要时采用队列方式平滑请求峰值。
• 日志管理：开启适度的日志等级，记录关键请求与响应内容（注意脱敏敏感信息），通过日志可以分析请求失败原因、响应延迟以及错误率，帮助设定更合理的重试和降级策略。

QuickQ 与 WebSocket 使用指南

建立连接步骤

• 确认地址：在 QuickQ 填写 WebSocket 的 ws:// 或 wss:// 地址时，先确认服务器端口和路径是否正确，若使用 wss:// 需要配置证书或信任选项，连接前可用浏览器或工具进行初步验证。
• 心跳配置：为避免长连接被中间网络设备关闭，在 QuickQ 中设置合适的心跳间隔或发送保活包，心跳频率不要太低也不要太频繁，以保证连接稳定并降低不必要的流量消耗。
• 事件处理：在 QuickQ 的事件回调中处理好连接断开和重连逻辑，遇到短暂网络波动应尝试指数退避重连，并在重连失败时记录原因以便排查服务器或网络问题。

消息传输与管理

• 消息格式：在 QuickQ 里对传输的消息约定统一格式，比如使用 JSON 并包含时间戳和唯一 ID，方便双方解析与追踪，接收端应校验格式并对异常消息进行容错处理或丢弃记录。
• 大小控制：对于大消息建议在 QuickQ 中分片发送或先上传到文件存储再传链接，避免一次性发送超大包导致连接中断，同时记录每次消息大小以便统计与优化。
• 顺序保证：如果需要严格的消息顺序，在 QuickQ 端实现序号校验与重试机制，接收端可根据序号重组或等待缺失片段，必要时配合服务端提供确认机制提高可靠性。

QuickQ 与 MQTT 接入流程

连接与订阅步骤

• 准备凭证：在 QuickQ 创建 MQTT 连接前，先准备好 broker 地址、端口、客户端 ID、用户名和密码等凭证，若使用 TLS/SSL 则需准备证书并在设置里启用安全连接并测试握手是否成功。
• 选择主题：在 QuickQ 中明确要订阅或发布的主题，尽量使用有层级结构且带前缀的主题命名方法，订阅时设置好 QoS 等级以平衡传输可靠性和效率，测试后查看消息是否按预期到达。
• 保持会话：对于需要持久订阅的场景，在 QuickQ 中开启持久会话并设置合适的清除会话标志，以便重连后能继续接收离线消息，不同 Broker 的行为略有差异需对照文档配置。

消息可靠性与性能

• QoS 策略：根据场景在 QuickQ 里选择合适的 QoS 等级，重要消息可用 QoS 1 或 2 以确保投递，普通状态更新可用 QoS 0 来降低开销，同时监控重试量避免重复投递。
• 离线处理：启用离线消息保留或在 QuickQ 端实现本地缓存，网络中断时将要发送的消息先保存本地，重连后按序发送并确认，避免数据丢失或重复处理。
• 性能监控：监测 QuickQ 与 Broker 的连接数、消息吞吐与延迟，遇到性能瓶颈可通过增加并发连接或优化主题设计分流负载，也可以考虑对消息内容做精简。

QuickQ 与 TCP/自定义协议配置

基础连接设置

• 端口与地址：在 QuickQ 中手动输入 TCP 服务的 IP 和端口，确认服务器端口已开放并允许访问，测试时可以用简单的 TCP 客户端先行连通，再在 QuickQ 中配置超时与重试参数。
• 协议规范：如果是自定义协议，先在 QuickQ 的文档或备注里记录数据包格式和帧边界规则，配置发送与接收时按规范打包和解析，测试多种边界情况确保解析不出错。
• 连接保持：长期连接时在 QuickQ 配置保活机制或周期性心跳，监控连接是否意外断开并实现自动重连，同时把状态变更记录到日志以方便后续排查。

调试与异常处理

• 抓包分析：在遇到自定义协议问题时，用抓包工具观察真实的 TCP 流量，并对照 QuickQ 的发送内容确认是否按约定构造包，抓包可以帮助定位边界、编码或顺序问题。
• 编码注意：处理文本或二进制数据时在 QuickQ 中明确字符编码和字节序规则，避免中文或特殊字符导致解析失败，必要时在界面备注编码信息供团队统一使用。
• 错误恢复：设计好 QuickQ 的错误恢复策略，例如遇到不完整包时先缓存再等待剩余数据，遇到解析错误记录原始包并跳过，以免整个连接被少数坏包影响。

QuickQ 在局域网发现与服务发现支持

发现服务配置

• 开启发现：在 QuickQ 的局域网设置里启用服务发现功能，配置好广播或多播地址与端口，确认局域网内路由允许该类型流量，通过界面可以扫描到本地可用服务并进行一键连接。
• 服务命名：为方便在 QuickQ 中识别设备和服务，使用有意义的服务名称与版本号，必要时添加位置或用途标签，扫描结果多时可以按标签或名称快速筛选目标服务。
• 权限控制：对可被发现的服务在 QuickQ 中设置访问权限或需要验证的标记，避免局域网内随意连接带来安全隐患，对于敏感服务建议只在受控网络或启用认证后才曝光。

常见场景与实践

• 家庭网络：在家用场景把 QuickQ 用于智能设备接入时，先确认路由器允许局域网内设备互相发现，若遇到跨子网无法发现可考虑静态配置服务地址或使用集中化的注册服务。
• 办公环境：企业网络通常有更多限制，使用 QuickQ 发现服务时与网络管理员沟通开放必要端口或采用 VPN 方式，必要时使用静态登记和权限管理以防无关人员接入。
• 设备管理：对于大量设备，QuickQ 可配合资产列表维护已发现服务的健康状态，定期扫描并记录在线率，遇到异常可自动告警并提供常见修复建议给普通用户参考。

QuickQ 与安全与认证协议支持

身份验证配置

• 选择方式：在 QuickQ 中支持用户名密码、Token 或证书等多种认证方式，按实际需求选择合适方式，重要数据通道优先使用证书或短期有效的 Token 来提升安全性并减少密码泄露风险。
• 密钥管理：在 QuickQ 设置里妥善保管 API Key 或证书文件，避免在共享环境明文保存，必要时通过导入导出功能配合密钥管理系统操作并在界面说明中记录有效期与使用范围。
• 双因素支持：如果服务端支持双因素认证，可在 QuickQ 端配合使用，例如通过一次性验证码或确认推送来增加安全保护，普通用户可通过界面提示完成二次确认以增强账户安全。

传输与存储安全

• 加密传输：优先在 QuickQ 里启用 TLS/SSL 等安全传输层协议，敏感数据在传输时必须加密，避免使用明文通道，若使用自签名证书请在设置中明确可信任并记录适用场景。
• 本地加密：对于在 QuickQ 本地保存的敏感配置或凭证，启用本地加密或受操作系统权限保护，避免普通用户的误操作或备份泄露导致凭证被滥用，定期更新凭证并注销旧凭证。
• 权限最小化：按照最小权限原则在 QuickQ 中配置访问范围，只给必要的服务最少权限，避免广泛授权带来的风险，必要时通过日志审计发现异常访问并及时处理。