跳转到内容

升级

  1. 打开 设置 → 更新。
  2. 点击 检查更新——Pier 会将已安装的二进制与 GitHub 最新发行版进行比较。
  3. 如果有更新的构建,点击 更新并重启。

自 1.4.3 起,该按钮会请求一个小型 root 服务 pier-updater 在服务器上重新运行官方安装程序, 从而更新安装程序负责的全部内容:

  • pier 二进制;
  • pier-net-helper(特权辅助程序)和 pier-agent;
  • 它们的 systemd 单元,包括更新器本身。

过程中 Pier 会重启;页面会跟踪进度,若失败则显示安装程序日志。.env 和 /opt/pier/data 会被保留。

面板只能请求更新——请求不携带任何参数。安装什么由服务器决定:最新发行版,并经过 sha256 校验。

旧安装没有更新器,面板会显示提示横幅。在安装更新器之前,该按钮只能通过 pier-net-helper 替换 pier 二进制;如果辅助程序未运行(例如重启后:旧的辅助程序单元没有 [Install] 段), 更新会直接失败。请通过 SSH 运行一次安装程序,之后每次从仪表盘更新都会覆盖全部组件:

终端窗口
curl -fsSL https://pier.team/install | sudo bash
# 检查:两行均为 "enabled",且文件存在
systemctl is-enabled pier-net-helper pier-updater.path
ls -l /usr/local/sbin/pier-update
终端窗口
cat /var/lib/pier-updater/status.json # 最近一次运行:running / success / failed
cat /var/lib/pier-updater/last.log # 安装程序完整输出
journalctl -u pier-updater -n 50 --no-pager

重新运行一行命令始终是安全的——它会手动执行同样的更新。如果在新提交后约 10 分钟内出现 404 失败,说明 CI 正在重新发布 latest:请稍候重试。

上面的一行命令就是手动升级:它会下载最新发行版、校验 sha256、保留端口和数据,并重启 Pier。

安装指定的发行版而不是 latest:

终端窗口
curl -fsSL https://pier.team/install | sudo bash -s -- --release-tag v1.4.2

发行版列表见 github.com/joveptesg/pier/releases。 数据库迁移只会向前,回滚不会撤销迁移。如果可能需要回退,请在升级前备份 /opt/pier/data。