适用场景
已经会用命令行客户端，想快速查某个命令怎么写。第一次使用请先看 命令行客户端入门。
前置条件
下文的 wyc-client 要换成你系统上的实际写法：
| 系统 | 解压目录中（安装前） | 安装后 |
|---|---|---|
| Windows（管理员 PowerShell） | .\wyc-client.exe |
& "$env:ProgramFiles\Wangyunchuan\WYC Client\wyc-client.exe" |
| Linux | sudo ./wyc-client |
sudo wyc-client |
| macOS | sudo ./wyc-client |
sudo /usr/local/libexec/wyc-client/wyc-client |
123、456 是示例隧道 ID，以 list 显示的为准；<令牌>、<文件> 要替换成实际内容，尖括号不要输入。
操作步骤
第 1 步：临时运行（关掉终端就停）
| 命令 | 作用 |
|---|---|
wyc-client version |
查看版本 |
wyc-client --help |
查看全部命令 |
wyc-client run |
临时运行，提示输入令牌 |
wyc-client run --token-file <文件> |
从文件读取令牌运行，适合脚本 |
wyc-client run --token <令牌> |
直接带令牌运行（令牌会留在命令历史里） |
成功后会看到终端打印“隧道已连接”和访问地址。按 Ctrl+C 停止。
也可以把程序文件名改成完整的令牌（Windows 保留 .exe），双击或直接运行就会临时连接。文件名里就是令牌，不要把这种文件发给别人。
第 2 步：安装成服务
| 命令 | 作用 |
|---|---|
wyc-client install |
安装服务并开机自启，不需要令牌 |
wyc-client install --enroll-key-file <文件> |
安装并用注册密钥绑定账号 |
wyc-client service start |
启动整个服务 |
wyc-client service stop |
停止整个服务（所有隧道断开，开机仍会自启） |
wyc-client service restart |
重启整个服务 |
第 3 步：管理隧道（服务需在运行）
| 命令 | 作用 |
|---|---|
wyc-client add |
添加一条隧道，提示输入令牌，添加后是停止状态 |
wyc-client start --token <令牌> |
添加并立即启动 |
wyc-client list |
列出所有隧道和 ID |
wyc-client start 123 456 |
启动一条或多条 |
wyc-client stop 123 |
停止（设备重启后仍保持停止） |
wyc-client remove 123 |
从本机移除，不删除账号里的隧道和套餐 |
成功后会看到每条操作的结果。多条一起操作时逐条显示，某条失败不影响其他条。
第 4 步：查看状态、日志和诊断
| 命令 | 作用 |
|---|---|
wyc-client status |
查看服务和隧道状态 |
wyc-client logs 123 --lines 100 |
查看一条隧道最近 100 行日志（最多 500） |
wyc-client logs 123 --follow |
实时查看，Ctrl+C 只退出查看 |
wyc-client doctor 123 |
检查设备能否连到这条隧道的内网服务 |
doctor 通过只说明端口能连上，网页能否登录、外网能否访问还要实际测试。
第 5 步：绑定官网账号
| 命令 | 作用 |
|---|---|
wyc-client bind |
显示配对码，到网页确认绑定 |
wyc-client bind --enroll-key <注册密钥> |
用官网生成的注册密钥直接绑定 |
wyc-client unbind |
解除绑定，本账号隧道停止并清除，外部隧道保留 |
第 6 步：升级与卸载
| 命令 | 作用 |
|---|---|
wyc-client upgrade |
在新版解压目录执行，升级已安装的服务 |
wyc-client upgrade --recover |
提示上次升级没完成时用来恢复 |
wyc-client uninstall |
卸载服务，保留配置 |
wyc-client uninstall --purge |
卸载并清除全部本机数据 |
给脚本用的 JSON 输出
list、status、logs、doctor、add、start、stop、remove、bind、unbind 可加 --json 输出结构化结果；install、service、upgrade、uninstall 不支持。脚本里请同时检查命令退出码（非 0 表示失败）和结果中每一项的状态。
成功检查
status显示服务运行，list中需要的隧道已连接。- 外网实际访问正常。
常见错误
| 现象 | 怎么办 |
|---|---|
| 提示“缺少隧道令牌” | 非交互环境不能手动输入，用 --token-file |
| 提示 ID 不存在 | 重新 list 查看，用 ID 而不是隧道名称 |
logs 带多个 ID 报错 |
一次只能看一条 |
| 提示无法连接本机客户端服务 | 服务没运行或终端没有管理员权限，先 service start |
帮助里没有 install |
程序是旧版，从下载页重新下载 |
旧版的 install-service --name 等命令见 旧版客户端维护。