适用场景
Mac 需要长期运行隧道，例如放在办公室的 Mac mini。Intel 和 Apple 芯片都支持。
前置条件
- 能使用
sudo（Mac 管理员账号）。 - 已在控制台配置好隧道，并复制了客户端令牌（“隧道”页 → “连接凭证”）。
- 在这台 Mac 上能访问要发布的内网服务。
- 在“系统设置”里关闭自动睡眠，否则睡眠时隧道会断开。
操作步骤
第 1 步：下载对应芯片的版本
点屏幕左上角苹果菜单 →“关于本机”，看“芯片”：
- Apple M 系列芯片：下载“macos arm64”
- Intel 芯片：下载“macos x86_64”
在 下载页 的“macOS 客户端”下载，保存到“下载”文件夹。
第 2 步：解压并检查
打开“终端”，执行（文件名换成你下载的实际名称）：
cd ~/Downloads/
tar -xzf wyc-client-macos-arm64-8.0.11.tar.gz
chmod +x ./wyc-client
./wyc-client version
成功后会看到 wyc-client 8.x.x …。如果系统提示无法验证开发者，请按系统弹窗的正规方式允许，不要关闭系统安全功能。
第 3 步：安装服务并添加隧道
sudo ./wyc-client install
sudo /usr/local/libexec/wyc-client/wyc-client add
sudo /usr/local/libexec/wyc-client/wyc-client list
sudo /usr/local/libexec/wyc-client/wyc-client start 123
sudo会先要求输入 Mac 的登录密码。add提示输入令牌时粘贴后回车（屏幕不显示是正常的）。start 123里的123换成list看到的隧道 ID。
成功后会看到：执行 sudo /usr/local/libexec/wyc-client/wyc-client status，这条隧道显示已连接。用手机流量打开访问地址确认。
新版安装后通常也可以直接用 sudo wyc-client；提示找不到命令时，使用上面的完整路径。
第 4 步：确认开机自启
sudo launchctl print system/net.wangyunchuan.wyc-client.device
sudo launchctl print-disabled system
成功后会看到：第一条能打印出服务信息；第二条输出里 net.wangyunchuan.wyc-client.device 不是 true（true 表示被禁用）。最后重启一次 Mac，不登录也能访问即可。
日常维护
下表的命令前面都要加上 sudo /usr/local/libexec/wyc-client/wyc-client 再执行：
| 要做的事 | 在程序路径后面加 |
|---|---|
| 查看状态 | status |
| 看某条隧道日志 | logs 123 --lines 100 |
| 检查内网服务能否连通 | doctor 123 |
| 停止一条隧道 | stop 123 |
| 重启整个服务 | service restart |
service stop 只是这次停止，开机还会自动启动。要取消开机启动：
sudo launchctl disable system/net.wangyunchuan.wyc-client.device
恢复：
sudo launchctl enable system/net.wangyunchuan.wyc-client.device
sudo /usr/local/libexec/wyc-client/wyc-client service start
服务起不来时看错误日志
sudo tail -n 100 '/Library/Logs/Wangyunchuan/WYC Client/device.crash.log'
文件不存在说明还没有记录到崩溃，继续看 launchctl print 的输出。
升级与卸载
- 升级：下载新版解压到新目录，在新目录执行
sudo ./wyc-client upgrade。 - 卸载：在解压目录执行
sudo ./wyc-client uninstall（保留配置）；确定不再使用并清除数据：sudo ./wyc-client uninstall --purge。
文件位置
| 内容 | 位置 |
|---|---|
| 程序 | /usr/local/libexec/wyc-client/wyc-client |
| 开机启动配置 | /Library/LaunchDaemons/net.wangyunchuan.wyc-client.device.plist |
| 日志 | /Library/Logs/Wangyunchuan/WYC Client |
路径中有空格，在终端里要加引号。
成功检查
- 隧道已连接，手机流量能访问。
- 重启 Mac 且不登录，仍能访问。
- 长时间放着不动也不断线（确认已关闭睡眠）。
常见错误
| 现象 | 怎么办 |
|---|---|
Bad CPU type 或 Exec format error |
芯片和下载包不匹配，回到第 1 步 |
| 运行一段时间后离线 | 多半是 Mac 睡眠了，在系统设置中关闭自动睡眠 |
| 提示找不到命令 | 用完整路径 /usr/local/libexec/wyc-client/wyc-client |
| 手动运行正常，装成服务后内网服务连不上 | 服务在无人登录时运行，访问不到需要登录用户才能打开的程序或网络盘 |
| 提示检测到旧版安装 | 看 旧版客户端维护 |