Linux 与服务器接入

先确认系统条件和你能提供的权限

本页用于具备 systemd 的普通 Linux 服务器或电脑，安装和管理网络服务需要 root 或 sudo。OpenWrt 使用 procd，请直接看路由器教程；容器中即使叫 Linux，也可能没有 systemd、没有 TUN 或没有网络管理权限，不能直接套用宿主机安装步骤。

先确认服务器本身能联网、系统时间正确，并准备 SSH 或现场终端。没有图形桌面也可以操作：网页控制台可以在你自己的电脑上打开，真正的安装命令则在目标服务器终端执行。

管理员权限、图奕账号和目标应用账号是三回事。sudo 提示通常要求当前 Linux 用户的本机密码；root 会话直接执行相应命令。SSH 登录账号也不一定叫 root，按你实际获得的服务器权限使用。

推荐：直接安装并加入目标网络

1. 在电脑浏览器登录控制台，选择这台服务器要加入的网络。
2. 右侧“添加我的设备”选择“Mac / Linux / 路由器”，点击“生成一键接入命令”。
3. 复制完整命令，在这台 Linux 服务器的 SSH 终端执行；需要 root 或 sudo 权限。
4. 看到网络 ID、设备 ID 和网云连地址后，回到相同网络的设备列表确认上线。服务已开机启动，可以退出 SSH。

专属命令已包含单次令牌，1 小时内有效，每台设备单独生成；不用再执行 login 或手动输入令牌。

只升级已有设备

原来的设备身份和网络配置保留，不要为普通升级重新签发令牌：

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

选择安装包

推荐使用一键安装命令，脚本会自动识别 CPU 与 MIPS 字节序。手动选择时，uname -m 显示 x86_64 / amd64 选择 x64（Intel、AMD 通用），aarch64 / arm64 选择 ARM64，i386 / i686 选择 x86 32 位，armv5 / armv6 / armv7 选择对应 ARM 32 位版本；另外提供 RISC-V 64、龙芯 Loong64、MIPS / MIPS64 大小端、PowerPC 64 大小端和 s390x。不要混用不同 CPU 的二进制。安装脚本要求 Linux、systemd 和 root 权限；OpenWrt 使用 专用教程。

需要账号登录并切换多个网络？

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

自动识别系统与架构，核对摘要并安装 systemd 服务。需要 root 或 sudo 权限。安装后使用下方账号登录或设备令牌接入。

手动下载与安装

从 下载页 复制对应包的下载链接，在服务器下载。用 sha256sum 安装包.tar.gz 对照下载卡片的摘要，再解压。将下方“你下载的安装包.tar.gz”替换为实际下载的文件名：

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

看到 usr、architecture 和 install.sh 后再安装，不要单独搬动 usr 内文件。

方式一：单次令牌接入

1. 网页登录 控制台，创建或选择网络，点击“生成一键接入命令”。
2. 生成这台服务器专用的设备令牌。有效期 1 小时，只能使用一次。
3. 在服务器执行下方命令，在提示后粘贴令牌回车。交互输入不回显，专属一键命令已包含单次令牌，也可以手动输入令牌。

sudo sh ./install.sh --join
sudo wangyunlian status
sudo wangyunlian peers

安装后再加入可执行 sudo wangyunlian up --token-stdin。设备已经加入后用 sudo wangyunlian connect 重连，无需重复生成令牌。

方式二：账号授权，同时连接多个网络

sudo sh ./install.sh
sudo wangyunlian login --name "我的服务器"

把终端输出的授权网址在可信浏览器打开，核对码并批准。浏览器可以位于你的电脑或手机，不要求服务器有桌面。

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

网络ID替换为列表中的实际 id。没有网络时可先在控制台创建或接受邀请。再次指定另一张网络 ID 执行 connect 即可同时连接；也可以分别执行各网络的一键令牌接入命令。查看多网络、路由与 DNS 冲突说明。

服务和连接检查

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

安装后服务自动开机启动。另一台设备加入同一网络后，使用其网云连地址访问已开启的服务；防火墙应允许实际业务端口。direct 为直连，relay 为共享中继。

断开、升级和停止使用

sudo wangyunlian disconnect 断开并保留身份，sudo wangyunlian connect 重连。升级时下载新包、核验并解压，在新包目录重新运行安装脚本；已有配置与身份保留。

停止使用时执行 sudo systemctl disable --now wangyunlian-agent，并在控制台移除设备，撤销其凭据。不要把删除身份目录作为网络排障的第一步。

下一步

需要访问 NAS、摄像头或整段内网，请继续 配置子网网关与审批；不能连接时查看 诊断步骤。

卸载命令行和后台服务

官网脚本和通用包安装后，需要停止并禁用 systemd 服务，再移除服务文件和二进制。查看 Linux 完整卸载命令、配置保留和验证方法。

SSH 登录后，先读系统信息再选包

使用你的 SSH 工具连接目标服务器，核对连接的主机身份。用 uname -m 查看 CPU；x86_64 对应 Linux x64，aarch64 对应 ARM64，其他架构按官方目录。普通一键安装器会自动识别，手动包则必须自己选对。

检查 /dev/net/tun 是否由系统提供，并确认 systemd 正在作为服务管理方式运行。容器或受限托管环境缺少这些条件时，联系宿主维护者提供适用环境；不要为了安装把容器直接改为无限制特权模式。

Ubuntu/Debian、RHEL 系等发行版的包管理方式不同。下载需要 curl、有效 CA 证书和 sha256sum；缺少时使用当前发行版自己的包管理器准备，不能把 OpenWrt 的 opkg/apk 命令粘到普通 Linux。

第一次推荐用专属命令，已有设备升级不用令牌

在自己电脑浏览器的控制台选择目标网络，为服务器生成一条专属接入命令。切到服务器的 SSH 终端粘贴完整命令，按提示提供本机权限。命令会安装并接入那张网络，成功后记录网络 ID、设备 ID 和地址，再回控制台确认。

命令一小时内有效且只能用一次，每台服务器单独生成。遇到过期或已消费提示，先检查这台服务器是否已成功登记；不要把同一个令牌转给另一台。正常升级同一台设备使用不带令牌的通用安装命令，保留原身份。

手动包里的文件和两种接入方式

手动下载时核对完整 SHA-256，再在空目录解压，保留 usr、architecture、architecture.sh、install.sh 等完整内容。不要只复制其中一个二进制后仍期待安装器完成服务注册。

在解压目录运行 sh ./install.sh 只安装工具；加 --join 会在服务就绪后要求你输入单次设备令牌。账号方式则先安装，再执行 login，在可信浏览器本人批准后查询 login-status，列出 networks list 并连接真实网络 ID。两种方式按用途选择，不必都执行。

下面命令中的文件名和“网络ID”都是需要替换的示意内容。先确认终端当前位于正确解压目录，再运行安装脚本；提示找不到 install.sh 时先检查路径，不要连续换命令碰运气。

服务启动成功后，还要验证实际业务

systemctl 显示 active 说明后台服务在运行，wangyunlian status 显示网络状态，控制台在线说明设备有联系；最后还需从另一台同网设备访问目标实际端口。SSH、网页或数据库本来没有启动时，不会因为组网成功就自动出现。

服务器用于网关时，继续按子网路由教程发布真实网段并审批。不要把“服务器接入”误认为“服务器后面的整个局域网都已共享”。

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