ubuntu安装easytier

发表于

🤖 Assistant

EasyTier 在 Ubuntu 的安装与后台运行说明

本文档涵盖：下载与安装、前台/后台运行、查看状态、开机自启与停止方法。示例均基于你的参数。

  • 可执行文件示例路径：/usr/local/bin/easytier-core
  • 示例启动参数：--network-name dn-t --network-secret G******************g -p tcp://2:1002

1. 环境与下载

1.1 检查架构

1
2
uname -m
# x86_64/amd64 继续；若 aarch64/arm64 请换用对应包

1.2 安装 unzip

1
2
sudo apt update
sudo apt install -y unzip

1.3 下载并解压

1
2
3
4
5
6
7
8
# 下载
wget https://github.com/EasyTier/EasyTier/releases/download/v2.4.3/easytier-linux-x86_64-v2.4.3.zip -O easytier.zip

# 解压
unzip easytier-linux-x86_64-v2.4.3.zip -d easytier

# 查看内容
ls -l easytier

1.4 安装到系统路径

1
2
3
4
5
6
# 假设解压后产生 easytier-core 可执行文件
sudo mv easytier/easytier-core /usr/local/bin/
sudo chmod +x /usr/local/bin/easytier-core

# 验证
easytier-core --version

如果你的文件名不同，请将命令中的 easytier-core 替换为实际文件名。

2. 直接运行（前台）

用于快速验证是否工作正常：

1
2
3
4
/usr/local/bin/easytier-core -d \
  --network-name dn-works-net \
  --network-secret GiaekVJSm5T66OjDKC7v433qdr8xO2Ag \
  -p tcp://23.26.125.53:12810

说明：

  • -d：以守护/后台模式运行（前台调试时可去掉）。
  • 若要查看更详细日志，临时去掉 -d 直接前台运行，按 Ctrl-C 结束。

3. 后台运行方式一：nohup（简便）

适合临时后台运行；重启不会自启。

3.1 后台启动并写入日志、PID

1
2
3
4
5
nohup /usr/local/bin/easytier-core -d \
  --network-name dn-et \
  --network-secret GAg \
  -p tcp://3:120 \
  > ~/easytier.log 2>&1 & echo $! > ~/.easytier.pid

3.2 查看是否在运行

1
2
3
4
5
# 方法一（通过 PID 文件）
ps -p "$(cat ~/.easytier.pid)"

# 方法二（按名称）
pgrep -af easytier-core

3.3 查看日志

1
tail -f ~/easytier.log

3.4 停止进程

1
2
3
4
5
# 推荐使用 PID 文件停止
kill "$(cat ~/.easytier.pid)"

# 或按名称停止（可能影响同名其他进程）
pkill -f easytier-core

4. 后台运行方式二：systemd（推荐，支持开机自启）

适合长期运行与重启自启。注意：systemd 下不要使用 -d，保持前台模式由 systemd 接管守护。

4.1 创建服务文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
sudo tee /etc/systemd/system/easytier.service >/dev/null <<'EOF'
[Unit]
Description=EasyTier Core
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/root/easytier/easytier-linux-x86_64/easytier-core --network-name ts-net --network-secret UV --hostname blt -i 10.218/24 -p tcp://124.12:110
Restart=on-failure
RestartSec=3
# 可选：环境变量、工作目录、资源限制等
# WorkingDirectory=/var/lib/easytier
# User=easytier

[Install]
WantedBy=multi-user.target
EOF

如实际路径不是 /usr/local/bin/easytier-core，请相应修改 ExecStart。

4.2 启用并立即启动（含开机自启）

1
2
sudo systemctl daemon-reload
sudo systemctl enable --now easytier

4.3 查看状态与日志

1
2
systemctl status easytier
journalctl -u easytier -f

4.4 停止与取消自启

1
2
sudo systemctl stop easytier
sudo systemctl disable easytier

4.5 修改参数后的重载与重启

1
2
3
# 修改 /etc/systemd/system/easytier.service 后
sudo systemctl daemon-reload
sudo systemctl restart easytier

4.6 可选：无 root 的用户级自启

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 创建用户服务文件
mkdir -p ~/.config/systemd/user
tee ~/.config/systemd/user/easytier.service >/dev/null <<'EOF'
[Unit]
Description=EasyTier Core (User)
After=network-online.target

[Service]
ExecStart=/usr/local/bin/easytier-core --network-name det --network-secret Gg -p tcp://23.53:110
Restart=on-failure

[Install]
WantedBy=default.target
EOF

# 使能并启动（当前用户）
systemctl --user daemon-reload
systemctl --user enable --now easytier

# 允许用户在未登录也自启（一次性）
sudo loginctl enable-linger "$USER"

5. 后台运行方式三：tmux（或 screen）

适合手动管理的长期会话；重启后不会自启。

5.1 启动会话并运行

1
2
3
4
sudo apt install -y tmux
tmux new -s et
# 会话内运行你的命令（建议去掉 -d 便于观察）：
/usr/local/bin/easytier-core --network-name det --network-secret GAg -p tcp://23:120

5.2 脱离与进入

1
2
# 脱离：按 Ctrl-b 然后 d
tmux attach -t et

5.3 停止

  • 回到会话内按 Ctrl-C，或：
    1
    tmux kill-session -t et

6. 常见操作速查

6.1 检查进程

1
pgrep -af easytier-core

6.2 查看网络监听

1
ss -lntp | grep easytier-core

6.3 升级或卸载

1
2
3
4
5
6
7
8
9
10
11
# 升级：停止后替换二进制，再按相应方式启动
sudo systemctl stop easytier  # 若用 systemd
sudo mv /path/to/new/easytier-core /usr/local/bin/
sudo chmod +x /usr/local/bin/easytier-core
sudo systemctl start easytier

# 卸载（按你的方式停止后删除）：
sudo systemctl disable --now easytier  # 若用 systemd
sudo rm -f /etc/systemd/system/easytier.service
sudo systemctl daemon-reload
sudo rm -f /usr/local/bin/easytier-core

7. 说明与建议

  • systemd 模式支持开机自启与自动拉起，推荐用于生产/长期运行。
  • --network-secret 属于敏感参数，不要公开分享；可考虑写入受限权限的环境文件。
  • 网络不稳定时建议搭配 Restart=on-failure 和 RestartSec，systemd 会自动重试。
  • 若需更多节点或路由配置，参考 EasyTier 官方文档并根据你的拓扑调整参数。