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。
- 网络密码:填写管理员提供的网络密码,不要截图公开。
- 初始节点:添加两条。
初始节点填写:
填写完成后点击
保存配置。
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。
- 私有网络里每台机器的用途和地址规划。
- 含有网络密码的配置文件或截图。
公开写教程时,统一使用: