在您自己的服务器上安装 FlowX

开始之前

自托管是 Business、Professional 和 Enterprise 套餐的附加服务。请在云端工作区的“设置 → 自托管”中添加。付款后，所有者或管理员即可创建安装命令。请准备一台服务器：

• Linux：Ubuntu 22.04 或 24.04、Debian 12，或 RHEL 9 系列。
• 推荐 4 核 CPU、8 GB 内存和 50 GB SSD。2 核、4 GB、20 GB 也能运行，但负载较高时会变慢。
• 一个域名（例如 flowx.yourcompany.com），并有指向该服务器的 DNS 记录。
• 向使用 FlowX 的人员开放 80 和 443 端口。
• 允许出站 HTTPS 访问 license.flowx.ninja 和 get.flowx.ninja。FlowX 不会主动连入您的服务器。
• 开启时间同步（NTP）。Docker 可选：安装程序会提示为您安装。

仅能在公司内网访问的服务器同样可用：安装时选择您自己的证书，或选择内部网络选项。

四步完成安装

• 1. 在云端工作区打开“设置 → 自托管”，选择“创建安装命令”。命令只能使用一次，24 小时内有效，且仅显示一次。新建命令会作废之前的命令。
• 2. 以可使用 sudo 的用户登录服务器，粘贴命令并按回车。安装程序会先检查服务器，并告诉您需要修复的问题。
• 3. 回答三个问题：用户访问的地址；证书（自动免费证书，需要 80 和 443 端口可从互联网访问；您自己的证书；或内部网络，浏览器会显示警告）；以及文件存放位置（本服务器磁盘，或您已有的兼容 S3 的存储桶）。
• 4. 保持“设置 → 自托管”页面打开：它会实时显示服务器连接、定期报到和首次登录。之后打开您的地址，用平常的 FlowX 账户登录。

新服务器初始为空。云端工作区的任务、请求和文件不会自动迁移过去；如需迁移，请在切换前联系支持团队。

安装完成后

• 将安装程序写入 /opt/flowx/RECOVERY.txt 的恢复单保存到密码管理器或打印出来，然后删除该文件。它包含唯一能解密备份的密钥，FlowX 没有副本。
• 在服务器上的 FlowX 中打开“设置 → 服务器”，完成检查清单：邮件发送（SMTP）、可选的邮件接收（IMAP）、文件、备份、更新时间窗口和安全。每一步都有“测试”按钮。

日常命令

在服务器上使用 sudo 运行：

• flowx status — 正在运行的服务、版本和最近一次备份。
• flowx doctor — 全面检查，并针对发现的每个问题给出修复方法。
• flowx logs api --tail 200 — 查看某个服务最近的日志。
• flowx backup now — 立即执行经过校验的加密备份。
• flowx upgrade — 先进行经过校验的备份；如果新版本无法启动，会自动回滚。flowx rollback 可手动回到上一版本。
• flowx export — 以标准格式导出全部内容，便于迁出或留存副本。

遇到问题时

• 安装程序卡在域名检查：DNS 记录必须指向此服务器的地址。更改最多可能需要一小时生效。
• 证书失败：80 和 443 端口必须可从互联网访问，或改用您自己的证书。
• “令牌已过期或已使用”：请在“设置 → 自托管”中新建安装命令。
• 签名或时间错误：请在服务器上开启时间同步（NTP）。
• 无法访问 FlowX 登录：已打开的会话仍可继续使用。可选的只读应急管理员（flowx break-glass）让您在此期间仍能查看和导出。

获取帮助

使用 FlowX 中的“支持”按钮提交工单。在服务器上运行 sudo flowx support-bundle 并附上生成的文件：其中只有脱敏日志和健康检查结果，绝不包含工作区内容；写入前您可以先查看其内容。