适用场景
用 install 装好的 Windows / Linux / macOS 服务版客户端，需要日常检查、排查问题、升级或卸载。
前置条件
管理员权限，以及已安装程序的写法：
| 系统 | 已安装程序 |
|---|---|
| Windows（管理员 PowerShell） | & "$env:ProgramFiles\Wangyunchuan\WYC Client\wyc-client.exe" |
| Linux | sudo /usr/local/bin/wyc-client |
| macOS | sudo /usr/local/libexec/wyc-client/wyc-client |
下文 wyc-client 按上表替换；123 是示例隧道 ID，先用 list 查看。
操作步骤
1. 日常检查
wyc-client status
wyc-client list
wyc-client doctor 123
成功后会看到：服务在运行、隧道已连接、诊断通过。最后用手机流量实际访问一次。
2. 查看日志
wyc-client logs 123 --lines 200
wyc-client logs 123 --follow
一次看一条隧道；--follow 实时滚动，按 Ctrl+C 只退出查看，不会停止隧道。
服务本身起不来时，logs 也用不了，要看系统日志：
| 系统 | 看哪里 |
|---|---|
| Windows | 事件查看器 → Windows 日志 → 系统，来源 Service Control Manager |
| Linux | sudo journalctl -u wyc-client@device.service -n 100 --no-pager |
| macOS | sudo tail -n 100 '/Library/Logs/Wangyunchuan/WYC Client/device.crash.log' |
隧道日志每个文件最大 20 MiB，最多保留 5 个、14 天，不用担心占满硬盘。
3. 导出排障材料给客服
Linux 示例（macOS 换成完整程序路径，Windows 用 & $client）：
sudo /usr/local/bin/wyc-client status --json > ./wyc-status.json
sudo /usr/local/bin/wyc-client logs 123 --lines 100 > ./wyc-tunnel-123.log
把这两个文件发给客服，并说明出问题的时间。不要打包发送整个数据目录，里面有凭据。
4. 停止一条与停止整个服务
| 命令 | 作用 |
|---|---|
wyc-client stop 123 |
只停这一条，设备重启后仍保持停止 |
wyc-client start 123 |
重新启动这一条 |
wyc-client service stop |
停止整个服务，所有隧道断开；下次开机仍自动启动 |
wyc-client service start |
启动整个服务，之前在运行的隧道自动恢复 |
5. 断网时能做什么
已添加的隧道可以在本机启动、停止；添加新令牌、绑定和解绑需要联网。网络恢复后，官网的远程操作会自动同步。
6. 升级到新版
- 从 下载页 下载与系统、架构对应的新版，解压到一个新文件夹。
- 在新文件夹里执行
version，确认是新版本。 - 在新文件夹里执行升级：Windows
.\wyc-client.exe upgrade，Linux/macOSsudo ./wyc-client upgrade。 - 用已安装程序执行
status，确认版本已更新、隧道已连接，再用手机测试访问。
升级会短暂断开，隧道列表和运行状态会保留。升级失败会自动恢复到旧版本。如果提示“上次升级尚未完成”，执行：
wyc-client upgrade --recover
7. 卸载
先确认这台设备上的隧道不再需要，或已经 切换到其他设备。建议在解压出来的程序目录里执行（Windows 尤其要这样，避免文件被占用）：
| 目的 | Windows | Linux / macOS |
|---|---|---|
| 卸载服务，保留配置 | .\wyc-client.exe uninstall |
sudo ./wyc-client uninstall |
| 卸载并清除全部数据 | .\wyc-client.exe uninstall --purge |
sudo ./wyc-client uninstall --purge |
保留配置卸载后再重新安装，可能会被提示存在旧数据，这是为了防止误覆盖。确定不要了就补做清除：
wyc-client uninstall-service --name device --purge
成功后会看到：系统服务不存在了；选择清除时，配置和日志目录也被删除。设备还绑定在官网的，请在官网设备详情里“退出此设备账号”。
8. 重启验收
- 记下当前
status和list的结果。 - 在不影响业务的时间重启设备，不要登录。
- 用手机确认隧道能访问；登录后检查：原来运行的隧道已恢复，手动停止的仍是停止。
Mac 另外检查睡眠后能否恢复；Windows 确认业务没有依赖个人账号的网络盘。
9. 信令在线与隧道连接是两回事
官网显示设备“在线”，只说明设备和官网的管理连接正常；每条隧道是否连上要单独看。
| 现象 | 优先检查 |
|---|---|
| 服务起不来 | 第 2 步的系统日志、安装包是否完整、是否用了管理员权限 |
| 本机正常，官网显示离线 | 是否已绑定账号、设备能否上网、系统时间是否正确 |
| 官网在线，某条隧道失败 | 这条隧道的日志：令牌是否更换、是否到期、是否在别的设备运行 |
| 隧道已连接，网页打不开 | 内网服务本身、内网地址和端口，见 访问故障排查 |
成功检查
- 升级后版本正确、隧道已连接、外网能访问。
- 卸载后系统服务不再存在，官网设备已按需要解除绑定。
常见错误
| 现象 | 怎么办 |
|---|---|
| 升级后版本没变 | 执行的是旧程序，要在新解压目录里执行 upgrade |
| 卸载后重新安装被拒绝 | 有保留的旧数据，按第 7 步补做清除，或保留后继续用 |
doctor 通过但网页登录失败 |
端口通了，问题在网站本身的配置 |
| 解除绑定后还有隧道在跑 | 那是别人账号的外部隧道，按规则保留，需要就手动停止 |