EasyTier Linux VPS 升级操作手册

作者
28 次阅读

本文最后更新于 2026年10月30日。

EasyTier Linux VPS 升级操作手册

适用环境：Linux VPS、root 权限、systemd 服务、EasyTier 独立二进制安装。

适用场景：国内及国外 VPS、多台服务器逐台升级、可选 GitHub 镜像。

官方项目：https://github.com/EasyTier/EasyTier

官方安装脚本：https://raw.githubusercontent.com/EasyTier/EasyTier/main/script/install.sh

官方版本列表：https://github.com/EasyTier/EasyTier/releases

一、升级前检查

建议先 SSH 登录目标 VPS，执行以下命令。

# 1. 查看系统架构
uname -m

# 2. 查看当前版本
/opt/easytier/easytier-core --version

# 3. 查看服务状态
systemctl status easytier@default --no-pager

# 4. 查看实际服务配置
systemctl cat easytier@default

# 5. 确认必要工具
command -v curl
command -v unzip

默认假定安装目录为 /opt/easytier，服务名称为 easytier@default.service。

如果其他 VPS 的安装目录或服务名称不同，先确认实际配置，不要直接套用默认路径。

二、备份程序和配置

执行：

BACKUP_DIR="/root/easytier-backup/$(date +%Y%m%d-%H%M%S)"

mkdir -p "$BACKUP_DIR"

cp -a /opt/easytier "$BACKUP_DIR/"

if [ -f /etc/systemd/system/easytier@.service ]; then
    cp -a /etc/systemd/system/easytier@.service "$BACKUP_DIR/"
fi

echo "备份位置：$BACKUP_DIR"

确认备份存在：

ls -lah "$BACKUP_DIR"
ls -lah "$BACKUP_DIR/easytier"

建议记录输出中的备份路径，以便发生故障时恢复。

三、下载官方升级脚本

curl -fL \
  https://raw.githubusercontent.com/EasyTier/EasyTier/main/script/install.sh \
  -o /tmp/easytier-install.sh

国内下载命令

curl -fL \
  https://ghfast.top/https://raw.githubusercontent.com/EasyTier/EasyTier/main/script/install.sh \
  -o /tmp/easytier-install.sh

检查脚本：

head -n 5 /tmp/easytier-install.sh

bash -n /tmp/easytier-install.sh

正常情况下，第一条检查应显示 #!/bin/bash，第二条检查没有语法错误输出。

查看脚本支持的参数：

bash /tmp/easytier-install.sh help

注意：这一步只是下载和检查脚本，尚未执行升级。

四、选择下载通道并升级

根据 VPS 所在网络环境选择一种方式。

方案 A：直连 GitHub

适合能够稳定访问 GitHub API 和 Release 下载地址的 VPS，例如部分国外服务器。

bash /tmp/easytier-install.sh update --no-gh-proxy

方案 B：使用 GitHub 下载镜像

适合直连 Release 下载不稳定的 VPS。

bash /tmp/easytier-install.sh update \
  --gh-proxy https://ghfast.top/

该镜像地址是脚本当前提供的默认代理地址之一。镜像可能发生变化，若不可用，应检查其可用性或换用可信的下载渠道。

重要说明

  • --no-gh-proxy：下载 Release 文件时不使用脚本代理。

  • --gh-proxy URL：指定 Release 下载代理。

  • 脚本获取最新版本号时仍会访问 GitHub API，因此仅设置下载镜像并不能保证完全解决 GitHub API 无法访问的问题。

  • 使用镜像不等于验证文件真实性。生产服务器建议核对官方发布信息及校验值。

  • 升级过程中 EasyTier 服务可能短暂中断。若 SSH 本身依赖 EasyTier，请先准备公网 SSH 或 VPS 控制台作为备用通道。

五、升级完成后验证

执行：

# 查看新版本
/opt/easytier/easytier-core --version

# 检查服务状态
systemctl status easytier@default --no-pager

# 检查最近的运行日志
journalctl -u easytier@default -n 50 --no-pager

# 检查进程
ps aux | grep '[e]asytier-core'

确认以下事项：

  1. 程序版本符合预期。

  2. systemd 服务为 active (running)。

  3. 日志中没有持续出现启动错误。

  4. EasyTier 节点能够重新连接。

  5. 通过 EasyTier 访问的内网服务、SSH 或其他业务恢复正常。

如果有多个服务实例，应逐一检查对应服务。

六、升级失败时恢复

先查看升级前记录的备份路径。假设备份目录为：

/root/easytier-backup/20261029-093000

将下面的路径替换成实际目录。

BACKUP_DIR="/root/easytier-backup/20261029-093000"

# 停止服务
systemctl stop easytier@default

# 保存升级后的目录，避免丢失故障现场
mv /opt/easytier "/opt/easytier.failed-$(date +%Y%m%d-%H%M%S)"

# 恢复旧程序和配置
cp -a "$BACKUP_DIR/easytier" /opt/easytier

# 如有备份的 systemd 单元文件，再恢复它
if [ -f "$BACKUP_DIR/easytier@.service" ]; then
    cp -a "$BACKUP_DIR/easytier@.service" \
      /etc/systemd/system/easytier@.service
fi

systemctl daemon-reload
systemctl start easytier@default

systemctl status easytier@default --no-pager

如果升级前服务单元文件并不在上述路径，或原先使用了自定义启动参数，请先恢复原始服务配置，再启动服务。

七、多台 VPS 的推荐升级流程

建议逐台执行，不要同时升级所有节点。

  1. 先选一台非关键 VPS 作为测试节点。

  2. 检查架构、版本、服务名称和配置路径。

  3. 备份程序、配置和 systemd 单元。

  4. 下载并检查官方脚本。

  5. 根据网络情况选择直连或镜像。

  6. 执行升级并确认服务正常。

  7. 验证节点互通、路由和业务访问。

  8. 再逐台升级其他服务器。

  9. 所有节点完成后，统一记录版本号和升级时间。

建议维护一份简单的升级记录：

服务器 升级前版本 升级后版本 通道 结果
VPS-A 待记录 待记录 直连 / 镜像 待验证
VPS-B 待记录 待记录 直连 / 镜像 待验证

八、常见问题

1. 报错 **Failed to get latest version**

可能是 GitHub API 无法访问。检查网络、DNS 和 GitHub API 连通性。单纯更换 Release 下载镜像不一定能解决。

2. 报错 **unzip is not installed**

先通过当前系统的软件包管理器安装 unzip，再重试。

3. 服务升级后无法启动

检查 systemctl status 和 journalctl 输出，确认服务单元、配置文件路径和权限是否正确。必要时使用备份恢复。

4. 国内服务器是否必须使用镜像？

不一定。以实际网络连通性为准：直连可用就优先直连；Release 下载不稳定时再尝试镜像。

5. 是否每次升级都需要重新配置 EasyTier？

正常情况下，官方 update 流程会保留安装目录中的 config 配置。但仍应提前备份，并在升级后确认实际配置和网络身份没有变化。

官方参考：