一键安装：从官网复制一条命令装好并绑定

适用场景

• 给一台新服务器或门店主机装客户端，并希望在官网远程管理。
• 一批设备用同一条命令批量部署。

Windows 办公电脑直接装 图形客户端 登录即可，不需要本文的命令。

前置条件

• 用将来管理这些设备的账号登录官网控制台。
• 目标设备能上网，并有管理员权限：Windows 用管理员 PowerShell，Linux/macOS 用有 sudo 权限的账号。Linux 需要 systemd。
• 设备上没有装过旧版服务（装过的先看 旧版客户端维护）。

操作步骤

第 1 步：生成安装命令

1. 控制台左侧点“设备”，点“添加设备”，切换到“命令行安装”。
2. 选择目标系统：Windows、Linux 或 macOS。
3. “部署方式”选“单台设备”或“批量部署”，“密钥名称”填一个好认的名字，例如“杭州门店”。
4. 点“生成安装命令”。

成功后会看到：提示“命令已生成，等待在目标设备执行”，下面是完整的安装命令。命令里 wyce_ 开头的一串是设备注册密钥，只在这个窗口显示一次，关掉后无法再查看，不要发给别人。

第 2 步：在目标设备执行命令

1. 打开目标设备的终端：
   • Windows：开始菜单搜索“PowerShell”，右键“以管理员身份运行”，不要用 CMD。
   • Linux/macOS：用有 sudo 权限的账号登录，打开终端。
2. 点页面上的复制按钮，复制完整命令，粘贴到终端回车。按提示输入系统密码。
3. 等待命令执行完毕。它会自动下载、核对 SHA-256、安装服务、设置开机自启并绑定账号。

成功后会看到：终端提示安装和绑定成功。

第 3 步：确认设备在线

回到官网“设备”页（可点“查看设备列表”），刷新。

成功后会看到：列表中出现这台设备，状态“在线”。可以点“修改名称”改成好认的名字，例如“杭州门店收银机”。

第 4 步：给设备添加隧道并启动

新装的设备里没有隧道，需要手动添加：

1. 在设备右侧点“查看详情”，点“添加隧道”。
2. 选择本账号的隧道（别人提供的隧道选“凭 Token 添加”）。
3. 添加后点“启动所选”，或在添加时勾选立即启动。

成功后会看到：这条隧道显示已连接。用手机流量打开访问地址确认。

已经装好客户端，只想绑定账号

在“命令行安装”生成命令后，展开“已安装命令行客户端？只绑定账号”，复制里面的绑定命令到设备上执行即可，例如：

wyc-client bind --enroll-key wyce_你的注册密钥

Windows 用已安装的程序路径执行，Linux/macOS 前面加 sudo。

批量部署要注意

• 同一条命令可以在多台设备上执行，每台新设备占用一个名额；同一台设备重复执行不会重复占名额，也不会创建第二份安装身份。
• 不要把装好的系统做成镜像再复制到别的设备，那样多台设备会共用同一个身份。
• 在“设备 → 部署密钥”里可以查看每个密钥已注册多少台、有效期，点“使用记录”看是哪些设备；不再需要时点“撤销”。撤销密钥只是不能再装新设备，已经装好的设备不受影响。

安装命令里含有密钥，属于敏感信息。安装用的临时文件会在结束后自动清理，但你的终端历史、部署工具记录里仍可能留着它，分享截图前请遮住。

成功检查

• 设备在官网显示“在线”。
• 部署密钥的使用记录与实际设备一致。
• 添加并启动一条隧道后，外网能访问。

常见错误

相关教程

命令行客户端入门 · 官网设备管理 · 多账号隧道与解绑 · 日志、升级与卸载