命令行客户端入门：临时运行与安装成服务

适用场景

• Linux 服务器、Windows Server、门店主机、Mac 等没人盯着的设备。
• 想用一条命令快速试一下隧道能不能通。

喜欢用鼠标操作的 Windows 用户请用 图形客户端；NAS 用 Docker 的请看 Docker 部署。

前置条件

• 已在控制台配置好隧道，并在这台设备上能访问内网服务。
• 已复制隧道的客户端令牌：控制台“隧道”页 → 隧道右侧“连接凭证”。
• 安装成服务需要管理员权限：Windows 用“以管理员身份运行”的 PowerShell，Linux/macOS 命令前加 sudo。

先分清两种用法：

操作步骤

第 1 步：下载并解压

在 下载页 选择：

• Windows：“Windows 服务端”下的便携版 zip，解压后进入有 wyc-client.exe 的文件夹，在地址栏输入 powershell 回车打开 PowerShell。
• Linux：“Linux 服务端”，按 uname -m 的结果选架构，见 Linux 客户端 第 1 步。
• macOS：“macOS 客户端”，Apple 芯片选 arm64，Intel 芯片选 x86_64。

检查版本：

.\wyc-client.exe version

Linux/macOS：

chmod +x ./wyc-client
./wyc-client version

成功后会看到：wyc-client 8.x.x … 的版本信息。

第 2 步：先临时运行试通

Windows：

.\wyc-client.exe run

Linux/macOS：

./wyc-client run

看到“请输入隧道令牌（输入不会显示）”时，粘贴令牌后回车（屏幕上不显示是正常的）。

成功后会看到：

10:30:12  隧道已连接：办公网站
           访问地址：https://xxxx.example.com
           内网地址：127.0.0.1:8080

用手机流量打开访问地址确认能用，然后按 Ctrl+C 停止。

第 3 步：安装成服务（长期使用）

Windows（管理员 PowerShell，在解压目录执行）：

.\wyc-client.exe install
.\wyc-client.exe add
.\wyc-client.exe list

Linux/macOS：

sudo ./wyc-client install
sudo ./wyc-client add
sudo ./wyc-client list

• install：安装服务并设为开机自启，不需要令牌。
• add：提示输入令牌，把这条隧道加进服务（加完默认是停止状态）。
• list：列出已添加的隧道，记下隧道的 ID。

第 4 步：启动隧道

把 123 换成上一步 list 看到的 ID。安装后可直接用已安装的程序：

成功后会看到：命令提示启动成功。再执行 status 或 logs 123（用法同上）查看连接情况，确认已连接后用手机流量测试。

还有其他隧道，继续 add 再 start，不用重复 install。

第 5 步（可选）：在官网管理这台设备

想在官网“设备”页远程启停、查看日志，需要把设备绑定到账号：执行 bind（用法同上），按提示用浏览器打开地址并确认。详见 官网设备管理。

也可以直接在官网“设备 → 添加设备 → 命令行安装”生成一条命令，下载、安装、绑定一步完成，见 一键安装。

成功检查

• status 显示服务在运行，list 里这条隧道已连接。
• 手机流量能访问。
• 重启一次设备，不登录也能访问；之前手动停止的隧道重启后仍保持停止。

常见错误

相关教程

Windows 无界面服务 · Linux 客户端 · macOS 客户端 · 一键安装 · 命令参考