部署故障排查
实例起不来、邮件收不到、实时协作断开？按日志与检查清单逐步定位最常见的自托管问题。
先看日志
绝大多数部署问题都能在容器日志中找到直接线索。使用 docker compose logs -f <服务名> 跟踪后端、实时协作、导出等组件的日志；Kubernetes 中使用 kubectl logs 并结合 describe、events 查看 Pod 调度与重启原因。
高频问题清单
- 容器反复重启：多半是数据库连接、密钥缺失或环境变量拼写错误
- 页面能打开但无法登录/邀请：检查公网地址配置与 SMTP 邮件
- 多人协作时频繁断线：反向代理未正确转发 WebSocket
- 图片或缩略图不显示：存储卷权限、对象存储配置或 Exporter 异常
- 大文件上传失败：Ingress/Nginx 的请求体大小与超时限制过小
- 升级后异常：.env 缺少新增配置项或数据库迁移未完成
- 内存不足导致容器被杀：检查资源限制并提高内存配额
标准排查步骤
- 确认所有容器/Pod 处于健康状态，没有反复重启
- 确认数据库、Redis 可从应用容器网络连通
- 核对 .env 中的公网域名、协议与实际访问方式一致
- 检查反向代理的 WebSocket、超时与上传大小配置
- 发送测试邮件并查看 SMTP 相关日志
- 回滚到最近可用版本，再逐步恢复以缩小问题范围
反馈问题时请附上
反馈问题时请附上
提交问题时附上部署方式（Compose/K8s）、版本号、相关组件日志片段与复现步骤，信息越完整定位越快。希爱设计私有化客户可直接联系微信客服获取支持。
实用提示
- 数据库定期备份是一切排查的安全网，升级前务必先备份。
- 只在必要时开启详细日志，问题解决后恢复默认级别。