自托管故障排除

安装过程中

• “此安装命令已过期、已被使用或已被替换”：请在“设置 → 自托管”中新建命令并运行。
• “没有可提问的终端”：请在 SSH 会话中运行，或传入 --host、--tls 和 --storage。
• 卡在域名检查：DNS 记录必须指向此服务器的地址。更改最多可能需要一小时生效。
• 80 或 443 端口被占用：有其他 Web 服务器在运行。请停止它，或使用干净的服务器。
• 镜像拉取三次失败：请检查服务器的出站 HTTPS，然后再次运行同一命令。
• 证书失败：80 和 443 端口必须可从互联网访问，或改用您自己的证书或内部网络选项。

登录

• “无法完成登录”：服务器无法连接 FlowX。请检查到 license.flowx.ninja 的出站 HTTPS，并确认已开启时间同步（NTP），然后重试。
• 在服务器自己的地址上显示“此工作区不存在”，或登录后跳转到类似 your-workspace.yourcompany.com 的地址：服务器版本低于 0.1.22。请运行 sudo flowx upgrade。
• 有人完全无法登录：请确认其仍是您 FlowX 账户中该工作区的成员，且账户处于启用状态。

运行与更新

• “自托管”页面提示最近未收到服务器消息：请确认服务器在运行且能访问 license.flowx.ninja，然后运行 sudo flowx doctor。
• 升级失败：系统已自动回滚到上一版本。查看 sudo flowx logs api --tail 200，修复原因后再次升级。
• 签名或时间错误：请在服务器上开启时间同步（NTP）。
• 收不到邮件：请在“设置 → 服务器”中完成邮件发送（SMTP）设置，并点击“测试”。

获取帮助

使用 FlowX 中的“支持”按钮提交工单。在服务器上运行 sudo flowx support-bundle 并附上文件：其中只有脱敏日志和检查结果，绝不包含工作区内容，并会在写入前先向您展示收集了什么。