批量接入 Mac、Linux 与网关

先做一台试点，再按清单批量接入

批量接入是一次准备多条独立接入命令，不是远程自动升级所有设备。你仍需通过现有的终端、SSH 或受控部署方式在每台目标设备执行。先选一台同类型设备完成依赖准备、接入和业务验证，再推广到其他设备。

准备一份部署清单，至少记录地点、用途、系统与 CPU、负责人员、目标网络 ID、接入后的设备 ID 和结果。清单不要直接公开保存有效令牌；每条命令只分发给确实要执行它的设备维护者。

先检查网络所有者的剩余设备额度。生成命令不预留设备名额，正式接入时仍会检查。OpenWrt 的 TUN 和软件源兼容性需逐台或按固件批次确认，不能因为第一台 x64 通过，就假定所有定制固件都满足条件。

准备工作

网络所有者准备目标网络、设备数量和部署清单。Mac、Linux和OpenWrt均可使用独立设备令牌；每台设备单独生成令牌。员工的个人电脑应由本人登录账号连接，其他账号先接受成员邀请。

生成与分发命令

1. 登录控制台，在“网络与设备”选择你创建的网络，核对网络名称和ID。
2. 点击“批量接入设备”，选择本批数量（1–20台），点击“生成接入命令”。
3. 按部署清单为每台目标设备复制一条完整命令；不要在多台设备上重复使用同一条命令。
4. 在目标设备终端执行，按提示确认本机管理员授权。命令自动识别系统与芯片，安装并加入指定网络，无需再次登录账号。
5. 如果部分命令生成失败，已生成的仍保留。点击“继续生成剩余命令”；未使用或请求结果不明的令牌可在令牌列表检查并撤销。

命令含单次设备令牌，生成后一小时内有效。关闭弹窗后已生成的令牌不会自动撤销，可从“管理服务器设备令牌”撤销。设备接入时会核对套餐额度，生成命令不代表预留了设备名额。

每台设备接入后检查

1. 终端完成后记录设备ID、目标网络ID和网云连地址；确认目标网络与部署清单一致。
2. 刷新控制台，打开设备详情，把名称改成“地点＋用途”，补充负责人、备注与标签。
3. 确认设备后台服务运行并显示在线。现场网关按教程发布真实网段，所有者核对后批准。
4. 从另一台已连接的设备访问目标应用，例如SSH、内部网页或NAS；验证权限允许和拒绝的方向。

避免重复安装与身份混乱

同一台电脑的GUI与命令行共用网络服务。已有设备无需重复领取令牌；先查看现有状态和设备ID，升级使用官方安装流程。需要更换归属时，先处理原网络设备与运行中的业务，再重新接入。

Mac步骤 · Linux步骤 · OpenWrt步骤 · 分支网关

如何把命令准确对应到每台设备

在控制台选择具体网络后，按实际本批数量生成命令。第一条只给清单中的第一台，第二条给第二台，逐台记录分配结果。不要把一条单次命令写进所有机器共用的安装脚本。

执行前由现场人员再次核对目标网络名称和执行设备。命令包含一小时有效的单次令牌，临近过期才分发的设备应重新生成；不能靠反复粘贴同一条让多台机器接入。

部分生成失败时，保留已成功的条目，通过页面“继续生成剩余命令”补足。遇到请求结果不明，先在令牌列表和部署清单核对，不要把整个批次全部重做。

每台设备的验收记录怎样填写

执行完成后记录终端给出的网络 ID、设备 ID 和地址；再刷新控制台，在同一网络中确认在线，补充名称和备注。建议使用“地点＋用途＋编号”，例如“杭州办公室网关-01”，而不是所有机器都叫默认主机名。

从已接入的测试电脑验证实际业务。作为网关的设备还要单独发布并批准真实网段，核对 SNAT、防火墙和返回路径；“批量接入成功”不会自动完成这些步骤。

最后在清单标注“安装完成”“设备在线”“业务可用”三个检查结果。遇到失败时记录原始报错和时间，避免只有一个笼统的“失败”让后续维护无法判断进行到哪一步。

遇到这些情况，怎样继续？