网云穿 Linux 客户端使用教程

持续稳定运行8年，更快更稳更省心官网：wangyunchuan.com

一、软件简介

网云穿是一款专业的内网穿透工具，可以将您本地的服务（如网站、数据库、SSH 等）安全地暴露到公网，实现外网访问内网的需求。

适用场景

本地开发调试，外网访问测试
远程 SSH 连接内网服务器
搭建个人网站或博客
微信/支付宝等第三方回调调试
NAS、监控摄像头等设备远程访问
Docker 容器、K8s 服务外网访问

二、获取隧道令牌

访问网云穿官网并登录您的账号
在控制台中创建隧道，配置本地端口和域名
创建成功后，复制隧道对应的 令牌（Token）

三、下载客户端

1. 确认系统架构

uname -m

输出 x86_64：选择 amd64 版本
输出 aarch64 或 arm64：选择 arm64 版本

2. 下载对应版本

# x86_64 架构
wget -O wyc_client-linux-amd64 'https://api.wangyunchuan.com/app/cms/linux/app_download?cpuArch=x86&osBit=64&type=app'

# ARM64 架构
wget -O wyc_client-linux-arm64 'https://api.wangyunchuan.com/app/cms/arm/app_download?cpuArch=ARM&osBit=64&type=app'

注意：URL 必须用引号包裹，否则 & 符号会被 Shell 误解析。

3. 添加执行权限

chmod +x wyc_client-linux-*

四、运行方式

网云穿 Linux 客户端支持两种运行方式：

方式一：单次运行（推荐调试使用）

适合临时使用或调试场景，退出终端后隧道停止。

通过菜单运行：

./wyc_client-linux-amd64

在菜单中输入 3 选择「单次启动隧道」
输入您的隧道令牌，按回车确认
看到「隧道连接成功」提示后即可使用

通过命令行直接运行：

# 直接运行，无需菜单交互
./wyc_client-linux-amd64 -token=您的令牌 -run

后台运行（可选）：

# 使用 nohup 后台运行
nohup ./wyc_client-linux-amd64 -token=您的令牌 -run > /dev/null 2>&1 &

# 或使用 screen
screen -S wyc
./wyc_client-linux-amd64 -token=您的令牌 -run
# 按 Ctrl+A 然后按 D 分离会话

方式二：安装为系统服务（推荐生产环境）

适合服务器长期运行场景，开机自动启动，稳定可靠。

sudo ./wyc_client-linux-amd64

在菜单中输入 1 选择「安装为系统服务」
输入您的隧道令牌，按回车确认
看到「服务已启动」提示，安装完成

或通过命令行直接安装：

sudo ./wyc_client-linux-amd64 -token=您的令牌 -service=install

服务特性：

开机自动启动，无需人工干预
后台静默运行，不占用终端
断线自动重连，保障服务稳定
支持 systemd 管理

重要提示：安装系统服务 必须使用 sudo，否则服务将安装在用户级别，重启后可能无法自动启动。

五、快捷方式：文件名识别令牌

为方便使用，您可以将客户端文件名直接改为您的令牌，程序将自动识别。

# 重命名文件为您的令牌
mv wyc_client-linux-amd64 gS2oWgd7b4R1GPi4
chmod +x gS2oWgd7b4R1GPi4

# 运行时自动识别令牌，加 -run 直接启动
./gS2oWgd7b4R1GPi4 -run

运行后直接选择运行方式即可，无需再输入令牌。

注意：文件名必须为 16 位字母数字组合才能自动识别为令牌。

六、服务管理命令

安装为系统服务后，可使用以下命令管理：

# 查看服务状态
sudo systemctl status WangYunChuan_<令牌前8位>

# 启动服务
sudo systemctl start WangYunChuan_<令牌前8位>

# 停止服务
sudo systemctl stop WangYunChuan_<令牌前8位>

# 重启服务
sudo systemctl restart WangYunChuan_<令牌前8位>

# 查看服务日志（systemd 日志）
sudo journalctl -u WangYunChuan_<令牌前8位> -f

七、日志查看

服务模式日志

使用 sudo 安装为系统服务后，日志保存在：

/var/log/wangyunchuan/<令牌前8位>/

常用命令：

# 查看今日日志
sudo cat /var/log/wangyunchuan/<令牌前8位>/$(date +%Y-%m-%d).log

# 实时查看日志
sudo tail -f /var/log/wangyunchuan/<令牌前8位>/$(date +%Y-%m-%d).log

# 查看最近 100 行
sudo tail -n 100 /var/log/wangyunchuan/<令牌前8位>/$(date +%Y-%m-%d).log

单次运行日志

单次运行（非服务模式）时，日志保存在用户目录：

~/.wangyunchuan/logs/<令牌前8位>/

常用命令：

# 查看今日日志
cat ~/.wangyunchuan/logs/<令牌前8位>/$(date +%Y-%m-%d).log

# 实时查看日志
tail -f ~/.wangyunchuan/logs/<令牌前8位>/$(date +%Y-%m-%d).log

日志按日期分文件存储，格式为 YYYY-MM-DD.log。

八、卸载服务

如需卸载已安装的系统服务：

方法一：通过菜单卸载

sudo ./wyc_client-linux-amd64  # 或您重命名后的文件名

在菜单中输入 2 选择「卸载系统服务」
输入要卸载的隧道令牌，按回车确认
看到「服务已卸载」提示，卸载完成

方法二：通过命令行卸载

sudo ./wyc_client-linux-amd64 -token=您的令牌 -service=uninstall

九、Docker 部署（可选）

如需在 Docker 中运行，可参考以下示例：

FROM alpine:latest
COPY wyc_client-linux-amd64 /app/wyc_client
RUN chmod +x /app/wyc_client
CMD ["/app/wyc_client", "-token=您的令牌", "-run"]

# 构建镜像
docker build -t wyc_client .

# 运行容器
docker run -d --name wyc --restart=always wyc_client

十、常见问题

Q1：提示「permission denied」？

请确保已添加执行权限：

chmod +x wyc_client-linux-*

Q2：提示「安装服务失败」？

请确保使用 sudo 或 root 权限运行。

Q3：如何在无图形界面的服务器上使用？

直接通过 SSH 连接服务器，在终端中运行即可。建议安装为系统服务以确保稳定运行。

Q4：amd64 和 arm64 如何选择？

amd64：适用于常见的 x86 架构服务器、PC
arm64：适用于 ARM 架构设备，如树莓派、部分云服务器

Q5：防火墙设置？

客户端使用外连方式，通常无需开放入站端口。如遇连接问题，请检查出站网络是否正常。

Q6：如何查看所有已安装的服务？

systemctl list-units --type=service | grep WangYunChuan

十一、一键安装脚本（高级用户）

注意：此脚本需要以 root 权限运行（使用 sudo bash 脚本名.sh）。

#!/bin/bash

# 网云穿一键安装脚本
# 使用方法: sudo bash install.sh

# 检查是否为 root 用户
if [ "$EUID" -ne 0 ]; then
    echo "错误：请使用 sudo 运行此脚本"
    echo "示例: sudo bash $0"
    exit 1
fi

# 设置您的令牌（请修改为您的实际令牌）
TOKEN="您的令牌"

# 检查令牌是否已设置
if [ "$TOKEN" = "您的令牌" ]; then
    echo "错误：请先编辑脚本，将 TOKEN 设置为您的实际令牌"
    exit 1
fi

ARCH=$(uname -m)

if [ "$ARCH" = "x86_64" ]; then
    URL="https://api.wangyunchuan.com/app/cms/linux/app_download?cpuArch=x86&osBit=64&type=app"
elif [ "$ARCH" = "aarch64" ]; then
    URL="https://api.wangyunchuan.com/app/cms/arm/app_download?cpuArch=ARM&osBit=64&type=app"
else
    echo "不支持的架构: $ARCH"
    exit 1
fi

echo "正在下载客户端..."
wget -q -O /usr/local/bin/wyc_client "$URL"
if [ $? -ne 0 ]; then
    echo "下载失败，请检查网络连接"
    exit 1
fi
chmod +x /usr/local/bin/wyc_client

echo "正在安装服务..."
/usr/local/bin/wyc_client -token="$TOKEN" -service=install

# 获取令牌前8位用于日志路径
TOKEN_PREFIX=${TOKEN:0:8}

echo ""
echo "========================================"
echo "安装完成！"
echo "========================================"
echo ""
echo "服务名称: WangYunChuan_${TOKEN_PREFIX}"
echo ""
echo "日志路径: /var/log/wangyunchuan/${TOKEN_PREFIX}/"
echo ""
echo "常用命令："
echo "  查看服务状态: systemctl status WangYunChuan_${TOKEN_PREFIX}"
echo "  查看实时日志: tail -f /var/log/wangyunchuan/${TOKEN_PREFIX}/\$(date +%Y-%m-%d).log"
echo "  重启服务:     systemctl restart WangYunChuan_${TOKEN_PREFIX}"
echo "  停止服务:     systemctl stop WangYunChuan_${TOKEN_PREFIX}"
echo ""

十二、技术支持

如遇到其他问题，请通过以下方式获取帮助：

官网：wangyunchuan.com
在线客服：官网右下角在线咨询
邮箱：support@wangyunchuan.com

感谢您选择网云穿，祝您使用愉快！