跳转到内容

安装 FF1 Core

FF1 Core 是装在每台节点上的转发引擎(systemd 服务 ff1-agent)。推荐用控制台 SSH 一键装机;也可手动安装。

方式 A:控制台 SSH 一键装机(推荐)

Section titled “方式 A:控制台 SSH 一键装机(推荐)”
  1. 登录 Master 控制台 → 节点添加节点
  2. 填写 SSH 地址、端口、root 密码或密钥
  3. 测试 SSH 确认连通
  4. 提交后查看进度:准备 → SSH 连通 → 安装 FF1 Core → 完成
  5. 节点上线后即可在 转发规则 中选用

Master 会为该节点签发令牌,远程执行安装并注册。

在节点上以 root 执行(<master> 换成你的 Master 地址,<token> 为控制台生成的节点令牌):

Terminal window
curl -fsSL <master>/install/agent.sh | sudo bash -s -- --master <master> --token <token>

脚本会下载对应架构的 FF1 Core、写入 ff1-agent systemd 服务,并用如下环境变量启动:

FF1_MASTER_URL=<master>
FF1_NODE_TOKEN=<token>

安装后:

Terminal window
systemctl status ff1-agent

卸载:

Terminal window
curl -fsSL <master>/install/agent.sh | sudo bash -s -- --uninstall
  • FF1 Core 需能主动连接 Master(WebSocket + HTTP/HTTPS);仅入站、不能出站的机器不适用
  • 节点二进制默认从 Master /dl/ 拉取,与 Master 版本对齐
  • 重装或换 Master 地址后,旧节点记录可能需在控制台手动下线

Q:SSH 测试通过但装机失败? A:多为节点无法出网下载或磁盘满,检查节点出站与磁盘。

Q:节点在线但转发不生效? A:查看 配置下发队列,确认下发任务未失败。