Mac 安装与使用

先在图形版和命令行版之间选一种主流程

想像普通软件一样点选网络，使用 macOS 图形客户端，当前要求 macOS 13 或更新版本；Intel 与 Apple Silicon 共用一个通用 DMG。只需要终端或无界面接入时，命令行工具适用于 macOS 12 或更新版本，安装脚本会识别芯片。

在 Mac 左上角苹果菜单打开“关于本机”，查看 macOS 版本和芯片。“Apple M…”表示 Apple Silicon，“Intel”表示 Intel。下载独立二进制时按芯片选；图形通用包不必分别找两个安装器。

准备 Mac 本机管理员密码和图奕账号。网页授权使用图奕账号，本地安装服务的密码提示使用这台 Mac 的管理员凭据。自己的第二台 Mac 继续使用同一个图奕账号，不要为了安装再注册一个不同账号。

使用图形客户端

1. 在下载页选择“macOS 图形客户端”，适用于 macOS 13 或更新版本，Intel 与 Apple Silicon 共用一个安装包。
2. 打开 DMG，将“网云连”拖入“应用程序”，再从应用程序打开。
3. 首次安装或升级网络服务时，确认系统管理员授权，输入 Mac 本机管理员密码。
4. 登录图奕账号，在“我的网络”创建网络或接受邀请，点击“加入该网络”。同一台 Mac 可同时连接多张网络。
5. 在“网络与设备”选择具体网络或“全部已连接网络”，查看设备地址和链路状态。切换查看范围不会断开其他网络。

升级前请从菜单栏退出旧版网云连，再替换应用并重新打开。GUI 与命令行共用后台服务、账号和设备身份；已通过一键命令接入的设备会直接复用，不必重复添加。

首次使用推荐从控制台复制专属命令：它会自动安装后台服务，并把这台 Mac 加入你选定的网络。需要 macOS 12 或更新版本，以及本机管理员密码。

1. 一条命令安装并接入

1. 打开 网云连控制台，注册或登录图奕账号。
2. 创建或选择一张网络，在“添加我的设备”选择“Mac / Linux / 路由器”，点击“生成一键接入命令”。
3. 点击“复制完整命令”，在这台 Mac 的“终端”粘贴并回车。命令已经包含绑定所选网络的单次令牌，不用再在终端登录。
4. 系统询问密码时，输入 Mac 本机管理员密码。输入时不显示字符，输完按回车。
5. 看到网络 ID、设备 ID 和网云连地址后，返回控制台相同网络的设备列表查看设备。安装完成后可以关闭终端。

专属命令只可使用一次，有效期 1 小时。每台设备分别生成，不要把命令发到公开群聊。安装器自动识别 Intel / Apple Silicon 并核对下载文件；已有账号和其他保存网络保留。

curl -fsSL https://wangyunlian.com/install.sh | sh
sudo wangyunlian login --name "我的 Mac"

sudo wangyunlian login-status
sudo wangyunlian networks list
sudo wangyunlian networks connect 网络ID

2. 确认双方连接

sudo wangyunlian status
sudo wangyunlian peers

另一台设备连接同一网络后，用它的实际网云连地址替换下面的 100.x.x.x：

ping -c 4 100.x.x.x

再访问对方开启的远程桌面、SSH 或网页。Ping 不通时也可检查实际服务端口及防火墙。direct 为直连，relay 为中继；查看连接和带宽规则。

只需要干净的二进制？

Apple Silicon 与 Intel 下载卡片均提供独立二进制，以及只含以下两个文件的压缩包：

• wangyunlian：登录、创建网络、连接或断开各网络、查看状态的命令行工具。
• wangyunlian-agent：后台组网服务，不含 GUI，不需要额外运行时。

普通使用选上面的一键安装；自行管理服务时，两个文件需保留执行权限。单独下载命令行工具不会自动启动后台组网服务。

已经安装图形客户端，还能用命令行吗？

正常安装的 Mac 图形客户端和命令行共用同一个系统网络后台、设备身份与网络配置。打开 GUI 不需要再注册一台设备；不要另外手动启动第二个 Agent。图形客户端提示更新系统服务时，由你本人确认管理员授权。

3. 断开、升级和卸载

临时断开

sudo wangyunlian disconnect

恢复保存的连接

sudo wangyunlian connect

断开会保留配置。退出账号使用 sudo wangyunlian logout，再次使用时需要重新授权。

升级时运行通用安装命令 curl -fsSL https://wangyunlian.com/install.sh | sh，无需重新生成接入令牌，现有账号和设备身份保留。

卸载服务和命令入口：

curl -fsSL https://wangyunlian.com/install.sh | sh -s -- --uninstall

卸载保留账号和设备身份；不再使用该设备时，还应在控制台逐网移除，撤销网络访问权限。图形客户端和命令行共用后台服务，移除服务后两者都无法组网。查看卸载验证、图形版处理与保留配置说明。

常见问题

• 找不到 wangyunlian：先用完整路径 sudo /usr/local/bin/wangyunlian status 检查安装结果。
• 无法连接本机服务：执行 sudo launchctl print system/com.too1.wangyunlian.agent 查看；不要同时启动第二个 Agent。
• 已登录但控制台没有设备：账号方式还需要执行 sudo wangyunlian networks connect 网络ID；也可直接从控制台复制一键接入命令。核对控制台选择的网络与终端显示的网络 ID 相同。
• 网络列表为空：网页与 Mac 应使用同一账号，并已创建网络或接受邀请。
• 授权过期：重新运行 login，使用新授权链接。
• 系统阻止运行：先核对官网来源与 SHA-256，再参照 Apple 安全打开说明，由本人检查决定是否允许。

Mac 用作终端访问同网设备和已批准子网；发布整个局域网请使用 Linux/OpenWrt 网关。更多问题见 连接诊断。

终端在哪里打开，命令在哪里粘贴

按 Command＋空格打开聚焦搜索，输入“终端”并打开，或在“访达 → 应用程序 → 实用工具”中找到。终端窗口才是粘贴安装命令的位置，浏览器地址栏不是。复制时保留完整一行，粘贴后按回车。

提示 Password 时输入 Mac 本机管理员密码，屏幕可能不显示字符，输入后按回车。只在确认是你刚发起的可信安装时提供授权；不要把图奕短信验证码填到终端管理员密码提示中。

专属接入命令包含单次设备令牌，生成后一小时内有效。看到网络 ID、设备 ID 和地址后，返回控制台相同网络核对设备；设备成功登记后无需再用同一令牌重做一次账号登录。

浏览器账号授权和设备令牌，怎样二选一

账号方式适合列出和连接多个可访问网络：先安装工具，再执行 login，打开终端给出的授权网址并核对设备及代码，由本人批准；回到终端执行 login-status，再用 networks list 和 networks connect 连接。登录成功本身不会自动把设备加入某张网络。

设备令牌方式适合直接接入选定网络：在控制台选网络，生成完整安装命令并在这台 Mac 执行；或已安装工具时手工执行 up --token-stdin。手工提示只接受令牌本身，不要把整行 curl 命令再粘进去。

两种方式可以按设备用途选择。图形客户端与正常安装的命令行共用系统后台，不必再启动第二个 Agent，也不需要为了从终端切到图形界面而把设备删除重加。

图形版升级和服务授权怎样处理

从菜单栏退出旧版图形程序，再用官方新包替换“应用程序”中的网云连并重新打开。提示更新网络服务时阅读系统授权，完成后核对原账号和网络。只替换下载文件夹里的副本，而继续打开旧的应用程序副本，会让人误以为升级没有生效。

被系统阻止打开时，先核对官网来源、版本和完整性，再按 Apple 自己的安全说明处理；不要从聊天群下载所谓关闭保护的脚本。GUI 无法连接后台时，使用本页的 launchctl 检查和诊断方式，不要手动运行多个 Agent。

遇到这些情况，怎样继续？