EasyTier 客户端使用教程

本文介绍客户端如何接入已经部署好的 EasyTier 公网中继节点。
你需要提前从管理员处拿到下面几项信息:
本文不会展示真实公网 IP 和真实网络密码。网络密码是加入 EasyTier 网络的凭证,请妥善保管。

1. Linux / AutoDL 客户端 Docker 方式

这种方式适合 Linux 服务器、AutoDL、云主机等需要长期在线的客户端。

1.1 检查 Docker 和 Compose

如果普通用户执行 Docker 命令出现权限错误,例如:
先用 sudo 执行:
后续命令也统一使用 sudo docker compose。

1.2 检查 TUN 设备

EasyTier 需要使用 TUN 设备。执行:
正常输出应类似:
如果没有 /dev/net/tun,需要先解决系统 TUN 支持问题。

1.3 创建客户端目录

1.4 写入环境变量

创建 .env:
字段说明:
  • ET_NETWORK_NAME:必须和公网中继服务器一致。
  • ET_NETWORK_SECRET:必须和公网中继服务器一致,不要公开。
  • ET_RELAY_HOST:公网服务器 IP 或域名。
  • ET_IPV4:当前客户端在 EasyTier 虚拟网络里的 IPv4 地址。每台客户端都要不同。
如果有多台客户端,可以按顺序设置:
不要让多台客户端使用同一个 ET_IPV4。

1.5 写入 Docker Compose 配置

如果 Docker Hub 访问正常,可以使用官方镜像:
如果 Docker Hub 拉取超时,建议直接使用下面的镜像源配置。
创建 docker-compose.yml:
这里同时添加了 TCP 和 UDP 初始节点。公网服务器端也需要同时放行 TCP/UDP 11010。

1.6 启动客户端

如果遇到 Docker Hub 超时错误,例如:
确认 docker-compose.yml 里的镜像已经改成:
然后重新执行:

1.7 验证客户端状态

如果容器已经启动,并且日志里没有持续报错,就说明客户端已经在尝试加入 EasyTier 网络。

2. Windows GUI 客户端方式

Windows 用户推荐使用 EasyTier GUI。

2.1 下载 Windows 安装包

打开 EasyTier Release 页面:
或者直接下载 Windows x64 安装包:
下载后双击安装。

2.2 创建或编辑网络

打开 EasyTier GUI 后,点击 创建新网络,或者选择已有网络后点击编辑。
基础设置按下面方式填写:
  • 虚拟 IPv4 地址:可以先勾选 DHCP。
  • 网络名称:填写管理员提供的网络名称,例如 your-network-name。
  • 网络密码:填写管理员提供的网络密码,不要截图公开。
  • 初始节点:添加两条。
初始节点填写:
填写完成后点击 保存配置。
EasyTier GUI 客户端脱敏配置示例
EasyTier GUI 客户端脱敏配置示例

2.3 启动网络

保存配置后,回到顶部网络列表,把状态从 已停止 切换为启动。
如果启动成功,状态会变成运行中。此时 Windows 机器已经加入同一个 EasyTier 网络。

2.4 Windows 客户端注意事项

  • 网络名称必须和服务器端一致。
  • 网络密码必须和服务器端一致。
  • 初始节点 IP 或域名填写公网中继服务器地址。
  • TCP 和 UDP 两条初始节点都建议添加。
  • 端口保持和服务器端一致,本文示例是 11010。
  • 如果选择手动虚拟 IPv4,每台机器必须使用不同地址。

3. 常见问题

3.1 Docker 权限不足

如果出现:
直接使用:
如果你希望普通用户也能运行 Docker,可以把用户加入 docker 组,但这会增加权限风险,按需处理。

3.2 Docker Hub 拉取超时

如果出现:
把镜像改成:
然后重新启动。

3.3 TUN 设备不存在

执行:
如果仍然不存在,说明当前系统或容器环境没有启用 TUN,需要先开启相关内核模块或换支持 TUN 的环境。

3.4 客户端连不上中继

按顺序检查:
  • 公网服务器 EasyTier 容器是否在运行。
  • 公网服务器安全组是否放行 TCP/UDP 11010。
  • 客户端网络名称是否一致。
  • 客户端网络密码是否一致。
  • 客户端初始节点是否填写公网服务器 IP 或域名。
  • 多个客户端的虚拟 IPv4 是否冲突。

3.5 不要泄露的信息

不要公开下面这些内容:
  • 网络密码。
  • 真实公网服务器 IP。
  • 私有网络里每台机器的用途和地址规划。
  • 含有网络密码的配置文件或截图。
公开写教程时,统一使用: