FAQ

常见问题（FAQ）

部署失败怎么办？

先查看服务状态和后端日志：

docker compose -f docker-compose.prod.yml ps
docker compose -f docker-compose.prod.yml logs --tail=200 imboy_backend

再对照 Day-1 部署 检查 Docker、环境变量、数据库、域名和端口。

配置改了但没有生效？

确认修改的是当前部署实际加载的 .env/配置文件，重新执行前置检查并重启对应服务。完整配置来源见 配置说明。

消息或 WebSocket 不通？

检查 HTTPS/WSS、反向代理路径、JWT、客户端 API 地址和后端健康状态。不要把真实 token 或用户数据粘贴到公共 Issue。

E2EE 消息无法解密？

先确认设备身份和密钥备份/迁移状态。E2EE 的当前协议与迁移边界见 E2EE 说明。

如何升级或回滚？

先备份，再阅读 升级指南 和主仓库的升级手册；不要直接套用旧版本 SQL。

如何报告问题？

请通过 GitHub Issues 提供版本、部署方式、最小复现步骤和脱敏日志。安全漏洞不要公开提交，按仓库 SECURITY.md 流程处理。