EasyTier 自建服务器完整教程

📋 前提条件

准备工作
拥有一台公网服务器或电脑，需要外网能够访问到（云服务器或家庭宽带有公网IP并做好端口转发均可）。

📥 第一步：获取安装包

下载 EasyTier Linux 版本

在 Linux 系统中执行以下命令下载安装包：

终端

# 直接下载（网络正常时）
wget https://github.com/EasyTier/EasyTier/releases/download/v2.6.0/easytier-linux-x86_64-v2.6.0.zip

# 网络较慢时，使用 ghfast.top 代理加速
wget https://ghfast.top/https://github.com/EasyTier/EasyTier/releases/download/v2.6.0/easytier-linux-x86_64-v2.6.0.zip

解压安装包

终端

unzip easytier-linux-x86_64-v2.6.0.zip

# 进入目录查看
cd easytier-linux-x86_64
ls -la

⚠️ 注意：如果提示没有 unzip 命令，先执行 apt install unzip 安装。

📁 第二步：可执行文件说明

解压后目录下有四个可执行文件，每个文件作用如下：

文件名	作用	说明
easytier-core	核心服务程序	组网核心引擎，负责网络连接和数据转发，需要长期运行
easytier-cli	命令行管理工具	用于查看节点状态、管理连接等命令行操作
easytier-web	Web 控制台API（不带界面）	PAI接口能力，界面要另外安装web
easytier-web-embed	Web 控制台（内置版）	带数据库的完整 Web 管理界面，推荐使用，包含配置存储

部署建议

终端

# 建议创建一个专门目录存放
mkdir -p /opt/easytier/server

# 将文件复制过去
cp easytier-* /opt/easytier/server/

# 或者直接复制到环境变量目录（可选）
cp easytier-* /usr/local/bin/

🔌 第三步：端口说明

easytier-web-embed 会监听以下端口：

参数	默认端口	说明
--config-server-port	22020	可配置为：26020，配置服务器端口，用于客户端连接获取配置
--api-server-port	11211	可配置为：26010，API 服务端口，Web 界面调用接口
--web-server-port	11211	可配置为：26010，Web 服务端口，浏览器访问界面
独立节点端口	11011	可配置为：26030，独立节点提供端口给任何一个客户端链接组网

⚠️ 重要：请确保服务器防火墙和安全组放行了这些端口（TCP 协议）。

⚙️ 第四步：创建 systemd 服务

在 /etc/systemd/system/ 目录下创建服务文件，实现开机自启和进程管理。

创建 easytier-core.service

/etc/systemd/system/easytier-core.service

[Unit]
Description=easytier-core Service
After=network.target

[Service]
Type=simple
ExecStart=/opt/easytier/server/easytier-core --config-server tcp://127.0.0.1:26020/admin --relay-network-whitelist myeasytier --machine-id easytier-server-id --hostname easytier-server-name -l 26030
User=root
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

创建 easytier-web-embed.service

/etc/systemd/system/easytier-web-embed.service

[Unit]
Description=easytier-web-embed-Service
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/opt/easytier/server/easytier-web-embed --db /opt/easytier/easytier-web-embed/web-embed.db --config-server-port 26020 --config-server-protocol tcp --api-server-port 26010 --web-server-port 26010 --api-host "https://easytier-web.yuming.cc"
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

参数说明

参数	说明
--config-server	配置服务器地址，格式：协议://IP:端口/网络名称
--relay-network-whitelist	允许中继的网络名称（白名单）
--machine-id	机器唯一标识符，用于区分不同节点
--hostname	节点主机名，便于识别
-l / --listen	监听端口，用于接收其他节点连接
--db	Web 界面数据库存储路径
--api-host	API 主机地址（公网访问地址，用于 Web 回调）
--config-server-protocol	配置服务器协议类型（tcp/udp）

🚀 第五步：启动服务与开机自启

设置开机自启

终端

# 重新加载 systemd 配置
systemctl daemon-reload

# 设置开机自启
systemctl enable easytier-core.service
systemctl enable easytier-web-embed.service

启动/停止服务

终端

# 启动服务
systemctl start easytier-core.service
systemctl start easytier-web-embed.service

# 停止服务
systemctl stop easytier-core.service
systemctl stop easytier-web-embed.service

# 重启服务
systemctl restart easytier-core.service
systemctl restart easytier-web-embed.service

# 查看服务状态
systemctl status easytier-core.service
systemctl status easytier-web-embed.service

# 查看日志
journalctl -u easytier-core.service -f
journalctl -u easytier-web-embed.service -f

✅ 成功：服务启动后，访问 http://你的服务器IP:26010 即可打开 Web 管理界面。

🌐 第六步：Web 端配置

1. 访问 Web 界面

浏览器打开 http://你的服务器IP:26010

2. API 主机地址填写

💡 说明
API 主机地址是客户端访问服务端的地址，填写你服务器的公网访问地址。

例如：
- 如果使用域名：https://easytier-web.yuming.cc
- 如果直接用 IP：http://服务器公网IP:26010

3. 修改默认密码

首次登录后，务必修改默认用户密码：

默认管理员账号：admin
默认普通账号：user
请立即修改密码，确保安全

4. 配置服务端设备

登录后按以下步骤操作：

点击「服务端」设备
在设备列表中找到你的服务器节点

设置组网名称
配置网络名称（Network Name），用于标识这个网络

设置为独立节点
开启独立节点模式，这样客户端可以连接到此服务器

📱 第七步：客户端安装与连接

1. 下载 Windows GUI 客户端

访问 GitHub Releases 页面下载 Windows 安装包，或者使用代理：

PowerShell（管理员）

# 使用代理下载 Windows 版本
irm "https://ghfast.top/https://github.com/EasyTier/EasyTier/releases/download/v2.6.0/easytier-windows-x86_64-v2.6.0.zip" | iex

2. 安装并打开 GUI

双击安装包完成安装，打开 EasyTier GUI 程序。

3. 添加自建服务器

点击「添加服务器」或「+」按钮

填写服务器信息
- 服务器地址：填写你搭建的服务器 IP 或域名
- 端口：填写你在服务端设置的监听端口（26030）

进行网络配置
- 设置网络名称（与服务端一致）
- 设置网络密钥（与服务端一致）
- 设置本机虚拟 IP

点击连接
连接成功后，你就可以与网络中其他设备通信了

✅ 完成！
现在你的设备和服务器已经处于同一个虚拟局域网中，可以像在本地一样互相访问。

❓ 常见问题

Q1: 连接失败怎么办？

检查服务器防火墙是否放行了端口（26010、26020、26030）
确认服务器公网 IP 是否正确
检查网络名称和密钥是否与服务端一致
查看服务端日志排查问题：journalctl -u easytier-core.service

Q2: 如何查看客户端连接状态？

在服务端 Web 界面可以查看所有已连接的客户端设备、IP 地址、连接状态等信息。

Q3: 如何让多台设备加入同一个网络？

所有客户端使用相同的：服务器地址 + 网络名称 + 网络密钥，即可加入同一个虚拟局域网。

Q4: 支持哪些操作系统？

Windows (x86_64)
Linux (x86_64, ARM, MIPS)
macOS
Android
OpenWrt 路由器