myvpn 安装 / 升级指南
================================

【首次安装】

1) 进入安装目录:
   cd ~/myvpn-setup

2) 安装(自动找同目录下的二进制):
   sudo bash myvpn-install-mac.sh

3) 启动(首次会问邮箱+密码;登录后可选开启「登录长期有效」):
   sudo myvpn-up

4) 开机自启(可选,推荐):
   sudo myvpn autostart on

或一行复制执行:
   sudo bash myvpn-install-mac.sh && sudo myvpn-down && sudo myvpn-up && sudo myvpn autostart on

【已安装,需要升级到新版本】

   sudo myvpn upgrade

会自动:查最新版本 → 下载 → 校验 → 替换 → 重启 → 健康检查 → 失败自动回滚。
升级后本目录(~/myvpn-setup/)会刷新到最新版。

【日常】

   sudo myvpn-up                连接 mesh
   sudo myvpn-down              断开
   sudo myvpn status            状态
   sudo myvpn peers             列对端
   sudo myvpn longlived on      登录长期有效(NAS/服务器等常开设备)
   sudo myvpn upgrade --check   仅查询有无新版,不升级
   sudo myvpn help              全部命令

【账号】

   sudo myvpn login             登录(交互式输入邮箱+密码)
   sudo myvpn passwd            改密码

如果忘记密码:让 admin 在 web 控制台帮你重置。

【如果 sudo myvpn upgrade 失败怎么办】

退出码:
   2  没用 sudo:加 sudo 重试
   3  网络不通:检查能否连 coord
   5  本机版本过旧:用 manual install(bash myvpn-install-mac.sh)
   6/7 下载或校验失败:重试一次;持续失败联系 admin
   10/11/12 升级失败但已 rollback 回旧版:看 agent log
   20 严重(升级+回滚都失败):看屏幕指引手动恢复

手动 rollback(任何时候都能用):
   sudo cp /usr/local/bin/myvpn-agent.bak /usr/local/bin/myvpn-agent
   sudo cp /usr/local/bin/myvpn.bak /usr/local/bin/myvpn
   sudo myvpn-down && sudo myvpn-up

【macOS 14+ 首次启动遇到 Gatekeeper 阻塞】

install 脚本已经给 binary ad-hoc 签名,但 macOS Gatekeeper 仍可能在首次启动弹窗
"Apple 无法验证 'myvpn' 是否包含恶意软件"。处理:

1. 弹窗选【取消】(不要选【移到废纸篓】会删 binary)
2. 系统设置 → 隐私与安全性 → 滚到下半部分
3. 看到 "myvpn 已被阻止..." → 点【仍要打开】→ Touch ID
4. terminal 重跑命令,会弹第二次确认窗 → 点【打开】
5. 之后这台机器永久 trust 这只 binary

快捷打开"隐私与安全性"页面:
   open "x-apple.systempreferences:com.apple.preference.security?Privacy_GateKeeperAllow"