选择适合你的版本

确认芯片

点按屏幕左上角苹果菜单 →“关于本机”：“芯片”显示 Apple M 系列选择 Apple Silicon，显示 Intel 选择 Intel。也可以在“终端”执行下面的命令，arm64 为 Apple Silicon，x86_64 为 Intel。

uname -m

安装工具和后台服务

打开“终端”（启动台或聚焦搜索中输入“终端”），粘贴下面的命令并回车。脚本自动选择芯片对应的版本、核对 SHA-256 后安装后台服务。提示 Password 时输入这台 Mac 的登录密码，输入时屏幕不显示字符，输完按回车。

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

接入网络：方式一，设备令牌（二选一）

此方式与下一步账号登录二选一。在本页上方登录并生成命令，点“只复制设备令牌”；在终端执行下方命令，看到提示后只粘贴令牌本身并回车，不粘整行安装命令。令牌 1 小时内有效、只能使用一次。

sudo wangyunlian up --token-stdin

接入网络：方式二，账号登录并连接网络

需要同时连接多个网络时使用账号登录。执行第一条命令后，用浏览器打开终端显示的授权网址，核对设备和验证码后批准。登录只验证账号，还需要执行 networks connect 连接网络，设备才会出现在控制台。把“网络ID”替换为列表里的实际 ID；要同时连接另一张网络，再用它的 ID 执行一次 connect，已有连接保留。没有网络时可执行 networks create 创建。

sudo wangyunlian login --name "我的 Mac"
sudo wangyunlian login-status
sudo wangyunlian networks list
sudo wangyunlian networks connect 网络ID
sudo wangyunlian status --all

确认连接

status 显示网云连地址即已接入；peers 列出同一网络的其他设备，direct 为直连，relay 为中继。用另一台设备的网云连地址替换 100.x.x.x 检查连通。

sudo wangyunlian status
sudo wangyunlian peers
ping -c 4 100.x.x.x

临时断开（按需操作）

仅需临时停止连接时执行，身份保留。多网络设备请按完整教程指定要断开的网络；不需要暂停时跳过本步。

sudo wangyunlian disconnect

恢复连接（按需操作）

之前已经接入且只是断开时，可恢复保存的连接，无需新令牌。

sudo wangyunlian connect

升级工具（按需操作）

正常升级重新运行通用安装命令，保留已有账号和设备身份。升级不需要执行后面的卸载命令。

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

卸载后台服务（仅停用设备时）

只有决定移除本机后台时才执行。GUI 与 CLI 共用服务，会影响本机网云连连接；不再使用时还需在控制台撤销相应设备。

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

确认 CPU 架构

SSH 登录服务器后执行下面的命令：x86_64 / amd64 选择 x64，aarch64 / arm64 选择 ARM64，i386 / i686 选择 x86（32 位），armv5 / armv6 / armv7 选择对应 ARM 32 位版本；还提供 RISC-V 64、龙芯 LoongArch 64、MIPS / MIPS64 大小端、PowerPC 64 与 s390x。

uname -m

下载安装包并核对

在上方下载卡片中找到对应架构，复制“下载安装包”的链接，在服务器上下载并保存为 wangyunlian.tar.gz。展开卡片的“文件校验与大小”，确认下面命令输出的 SHA-256 与卡片一致；不一致时不要安装。

curl -fL -o wangyunlian.tar.gz '下载链接'
sha256sum wangyunlian.tar.gz

解压

解压到独立目录。看到 usr、architecture 和 install.sh 后再安装，不要单独移动 usr 里的文件。

mkdir -p ~/wangyunlian-install
tar -xzf wangyunlian.tar.gz -C ~/wangyunlian-install
cd ~/wangyunlian-install

安装并用设备令牌接入

执行下面的命令安装服务，看到提示后粘贴设备令牌并回车（输入不回显）。令牌可在本页上方登录后复制，或在控制台“生成一键接入命令”获得；1 小时内有效、只能使用一次。

sudo sh ./install.sh --join

或：安装后用账号登录并连接网络

需要同时连接多个网络时，先只安装，再登录账号。授权网址可以在你的电脑或手机浏览器中打开，服务器不需要桌面。把“网络ID”替换为列表里的实际 ID；再用另一张网络的 ID 执行 connect 即可同时连接。

sudo sh ./install.sh
sudo wangyunlian login --name "我的服务器"
sudo wangyunlian login-status
sudo wangyunlian networks list
sudo wangyunlian networks connect 网络ID
sudo wangyunlian status --all

检查服务和连接

服务已设为开机自启。前两条查看服务状态和最近日志，后两条确认网云连地址和同网设备。业务访问不通时，检查服务器防火墙是否放行实际端口。

sudo systemctl status wangyunlian-agent --no-pager
sudo journalctl -u wangyunlian-agent -n 80 --no-pager
sudo wangyunlian status
sudo wangyunlian peers

升级工具（按需操作）

升级时运行通用安装命令，或下载新包核对后在新目录重新安装。已有配置和身份保留，无需重新生成令牌，也无需停用服务。

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

停止服务（仅暂停或停用时）

这条命令会停止服务并取消开机启动，不是升级步骤。不再使用时还需在控制台移除对应设备。

sudo systemctl disable --now wangyunlian-agent

确认架构

SSH 登录路由器后执行 uname -m，按结果在上方选择 OpenWrt x64、ARM64、ARMv6/v7、RISC-V 64 或 MIPS 大小端版本。

uname -m

先确认固件支持 TUN

最后一条命令若列出字符设备，可先跳过内核模块安装；若提示不存在，暂停安装并向固件维护者核对兼容 TUN。定制固件可能需要在构建固件时预装；不能用另一版固件的 kmod-tun 代替，也不要强制处理依赖。

uname -r
cat /etc/openwrt_release
ls -l /dev/net/tun

准备普通工具（opkg 固件）

只有使用 opkg 的固件执行这一组。curl 用于下载，ca-bundle 用于验证 HTTPS，ip-full 提供路由工具；不把 kmod-tun 列入通用安装命令。已有工具不必反复重装。

opkg update
opkg install curl ca-bundle ip-full

或：准备普通工具（apk 固件）

只有使用 apk 的固件执行这一组。它与上一组二选一；任一步报错先处理提示，不要继续复制后面的接入命令。

apk update
apk add curl ca-bundle ip-full

上传并核对安装包

下载对应架构的通用 tar.gz 包，上传到路由器的 /tmp（例如用 scp）。先用 df -h 确认 /tmp 空间足够，再核对 SHA-256 与下载卡片一致。把文件名替换为实际下载的文件名。

df -h /tmp
sha256sum /tmp/你下载的安装包.tar.gz

解压、安装并接入网络

解压后执行安装脚本，看到提示后粘贴设备令牌并回车。安装程序自动启用开机服务，已有配置和设备身份保留。

mkdir -p /tmp/wangyunlian-install
tar -xzf /tmp/你下载的安装包.tar.gz -C /tmp/wangyunlian-install
cd /tmp/wangyunlian-install
sh ./install.sh --join

或：使用 IPK 安装（仅 opkg 固件）

IPK 会由 opkg 处理依赖。固件须有匹配的模块包；定制固件已内置 TUN、但未登记 kmod-tun 包时请选择通用 tar.gz，避免包管理器尝试补装模块。确认依赖兼容后再使用本方式；apk 系固件使用 tar.gz。

opkg install /tmp/你下载的安装包.ipk
/etc/init.d/wangyunlian setup
wangyunlian up --token-stdin

验证连接

先确认路由器自己取得网云连地址并能访问同网设备。要访问路由器后面的 NAS、摄像头等设备，还需要发布局域网网段并由网络所有者审批。

wangyunlian status
wangyunlian peers
logread -e wangyunlian

升级与停止

升级时下载新包、核对后在新目录再次运行 sh ./install.sh。停止服务并取消开机启动执行下面两条命令；不再使用时在控制台移除设备。

/etc/init.d/wangyunlian stop
/etc/init.d/wangyunlian disable

下载并解压

在上方选择对应架构的“Windows 命令行版”ZIP（ARM64 设备请选原生 ARM64 包），解压到一个固定目录并保留全部文件。普通电脑更推荐图形客户端。

以管理员身份安装

右键开始菜单 →“终端（管理员）”或“Windows PowerShell（管理员）”，用 cd 进入解压目录后执行下面的命令。服务安装后随 Windows 自动启动。

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

接入方式一：设备令牌（二选一）

新开管理员终端。为这台设备生成独立令牌，在下方命令提示后只粘贴令牌本身。此方式与下一步账号登录二选一。

wangyunlian up --token-stdin

或：接入方式二，账号授权

执行 login 后，在可信浏览器本人确认授权，再查询结果和网络列表。将“网络ID”替换为实际 ID 后连接；继续连接另一张网络时再使用它的 ID。

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

确认连接

显示网云连地址即已接入。命令行版与图形客户端共用同一个网络服务和设备身份，不会同时运行两个组网引擎。

wangyunlian status
wangyunlian peers