🛠️
设备端 agent
一行命令,自动装、自动注册、自动等主理人确认。Linux 全平台兼容。
v3
~12 KB
RK3568 / x86_64 / WSL / 树莓派
设备跑命令
→
屏幕显示 6 位配对码
→
把 6 位码告诉主理人
→
设备自动上线 ✅
1在设备上打开终端
需要 联网 + Python 3.7+。RK3568 默认都有;树莓派可能要 sudo apt install python3。WSL 任意发行版都行。
2复制下面这行命令,粘到终端,回车
bash <(curl -sL https://www.frd19.com/download/fedai-install-v3)
💡 不知道什么是"终端"?
• 安卓/手机:装 Termux,打开后粘贴命令
• 树莓派/RK3568:插显示器键盘,登录后开终端;或 SSH 进去
• WSL:开始菜单搜 WSL / Ubuntu,打开就是终端
• 服务器:SSH 登录后就是终端
💡 如果 curl 下载慢,把 curl 换成 wget:
bash <(wget -qO- https://www.frd19.com/download/fedai-install-v3)
3脚本跑完,屏幕上会弹出一个黄色大框(配对码)
脚本在 6/6 完成后会自动 生成 6 位配对码 + 上传给服务器,然后在终端打印一个黑底黄字的大框:
==> 1/6 Python 依赖
==> 2/6 安装客户端 (/opt/fedai-device-agent)
==> 3/6 配置 (/etc/fedai_device_agent.json)
==> 4/6 日志目录 + 空间下限检查
==> 5/6 系统服务 + logrotate
==> 6/6 完成
==> 7/7 生成配对码 + 上送服务器...
✓ 配对码已暂存到服务器(2 小时内有效)
┌──────────────────────────────────────────────────┐
│ 配对码: A3F7K2 │
│ (2 小时内有效,只显示这一次) │
│ 把这 6 位发给主理人,他会去: │
│ https://www.frd19.com/FederatedAI/master │
│ → 我的通道 → + 添加设备 → 填这 6 位 │
└──────────────────────────────────────────────────┘
⏳ 脚本会停在这里等主理人填码...
配对成功后此窗口会自动关闭
如果要取消: 按 Ctrl+C
还在等主理人... (已等 30 秒, 共 600 秒)
💡 黄色框里的 6 位大写字母+数字就是配对码(A3F7K2 只是个例子,你的会不一样)
💡 怎么发给主理人:
• 截图整个终端(发微信/飞书都行)
• 或者口述 6 位码
💡 不要关掉这个终端窗口!脚本会在这里等 10 分钟,主理人填码后会自动继续
⚠️ 如果 10 分钟内主理人没填码,脚本会退出,但配对码仍有效 2 小时。重新跑命令会拿到新码。
4把 6 位码发给主理人(微信/飞书/电话都行)
主理人在网页后台填入这 6 位码,你的设备会在 30 秒内自动上线,屏幕会显示:
✅ 已配对,host_id: h-xxxxxxxxxxxx
设备已加入联邦AI,正在等主理人调度...
🔍 没看到 6 位配对码?对照检查:
✅设备能 ping 通 www.frd19.com?在终端跑 ping www.frd19.com
✅设备有 python3?跑 python3 --version
✅防火墙没拦出站 HTTPS?443 端口要通
✅如果显示 "Permission denied",命令前加 sudo bash 重试
👑
主理人工作台
设备操作者跑完命令后,屏幕会显示 6 位配对码。你拿到码后,在这里填一下,设备 30 秒内自动上线。
需要 master 权限
配对码 5 分钟内有效
操作者在设备跑命令
→
他给你 6 位配对码
→
你填码
→
设备自动上线 ✅
1让设备操作者跑命令
把下面这行命令发给操作者,让他在设备终端跑:
bash <(curl -sL https://www.frd19.com/download/fedai-install-v3)
操作者跑完会把 6 位配对码 发给你。如果他不知道怎么跑,把本页地址发给他(设备操作者那一栏有详细指引)。
2拿到配对码后,在这里填
6 位配对码(大写字母+数字):
3设备 30 秒内会自动上线
认领成功后,去「我的通道」看,设备会出现在列表里。
✅ 认领成功后设备自动获得 host_token,主理人可调它的能力、传文件给它、配白名单等。
❓ 常见问题
❓"认领失败:配对码不存在" — 码已过期(5 分钟)或打错,让操作者重跑命令拿新码
❓"认领失败:此设备已被认领" — 码被别人用了,让操作者重跑命令拿新码
❓"设备已认领但没上线" — 等 1-2 分钟,设备需要重启服务;或让操作者重跑命令
❓想批量认领多台设备 — 每台设备独立跑命令,独立填码