v0.21.0

新功能

• 主面板无法访问时，页面提示转到备用面板，并列出备用面板的地址，可复制或打开。绑定域名后，主面板所在机器离线时新打开或刷新页面也会显示此提示。

修复

• 修复了节点恢复其他节点传来的副本时，可能写入容器目录以外文件的问题。
• 修复了面板从节点缓存恢复项目时，可能按节点上报的数据连接两个无关项目的问题。
• 修复了操作员可将容器接入其他项目的容器、卷或网络的问题。
• 修复了限定了节点范围的成员可将范围外的节点设为入口节点的问题。

行为变更

• 开启两步验证前，以及在授权页允许 OAuth 访问前，需先验证身份。
• 操作员保存的 compose 中，network_mode、pid、ipc 等只能指向同一 compose 中的服务；为 volume 或网络指定 name 仅限管理员。

升级说明

• 副本恢复的修复需将节点升级到 v0.21.0。

安装与升级

全新安装或升级面板（在面板服务器上以 root 执行）：

curl -fsSL https://github.com/SIPC/Nagi/releases/latest/download/install.sh | sudo sh

v0.6.0 及以后的面板也可以在「设置 → 版本更新」一键更新。面板升级后，在面板的「节点」页一键升级各节点。完整的更新日志见 CHANGELOG.md。

v0.20.0

新功能

• 支持取消节点升级。可在节点页取消全部，或在节点详情取消单个节点；正在下载的节点停止下载，保持原来的版本。

改进

• 测速改为在对话框中分步显示，QUIC 和 WireGuard 隧道的结果分别列出，并显示进度和建议。
• 经面板中转的节点间流量在概览中以虚线显示。

修复

• 修复了纠错校验包的流量未计入节点之间流量的问题。
• 修复了面板替节点中转的流量被计为面板所在节点对外流量的问题。
• 修复了面板与其所在节点之间的流量被从对外流量中扣除，导致对外流量偏小的问题。

行为变更

• 升级全部节点时，某个节点下载新版本失败或超时，会记录原因并继续升级下一个节点；替换后没有恢复时仍会停止。
• 节点下载新版本的超时由 15 分钟缩短为 10 分钟，超时后显示错误。

升级说明

• 取消正在下载的升级需将节点升级到 v0.20.0；更早版本的节点只能取消排队中的升级。
• 纠错流量的统计和分步测速需将节点升级到 v0.20.0；中转流量的统计需将面板升级到 v0.20.0。

安装与升级

全新安装或升级面板（在面板服务器上以 root 执行）：

curl -fsSL https://github.com/SIPC/Nagi/releases/latest/download/install.sh | sudo sh

v0.6.0 及以后的面板也可以在「设置 → 版本更新」一键更新。面板升级后，在面板的「节点」页一键升级各节点。完整的更新日志见 CHANGELOG.md。

v0.19.0

新功能

• 节点页「网络」视图新增节点间延迟矩阵，显示每对节点之间的当前延迟；点选一格可查看两个方向的延迟历史，最长 30 天。
• 节点的「节点网络」标签新增测速，可测量与其他节点或面板之间的上传、下载速度，并与 WireGuard 隧道对比，有更快的方式时给出提示。仅限管理员。
• 节点的「节点网络」标签显示与每个节点、面板之间两个方向的丢包率。
• 节点设置新增「QUIC 快速通道」开关，所在网络限制 UDP 时可关闭。

改进

• 节点之间直连时，容器跨节点访问、流量转移、快照同步和文件上传改经 QUIC 传输，在延迟高、有丢包的线路上速度大幅提升。
• 节点之间直连时根据丢包情况自动纠错，跨境等有丢包的线路上传输速度明显提升。「节点网络」标签显示当前的纠错强度。
• 概览的实时流量图扩大了悬停范围，较细的连线也更容易高亮。

修复

• 修复了经面板下载、上传节点文件的流量未计入概览中节点之间流量的问题。

升级说明

• 延迟历史需将节点升级到 v0.19.0。
• QUIC、自动纠错、测速和丢包率需将连接两端都升级到 v0.19.0。

安装与升级

全新安装或升级面板（在面板服务器上以 root 执行）：

curl -fsSL https://github.com/SIPC/Nagi/releases/latest/download/install.sh | sudo sh

v0.6.0 及以后的面板也可以在「设置 → 版本更新」一键更新。面板升级后，在面板的「节点」页一键升级各节点。完整的更新日志见 CHANGELOG.md。

v0.18.1

改进

• 容器组概览中的镜像按服务逐行显示，并省略镜像摘要和 Docker Hub 的默认前缀，悬停可查看完整地址。

修复

• 修复了添加节点时，较长的安装命令使对话框出现横向滚动条的问题。

安装与升级

全新安装或升级面板（在面板服务器上以 root 执行）：

curl -fsSL https://github.com/SIPC/Nagi/releases/latest/download/install.sh | sudo sh

v0.6.0 及以后的面板也可以在「设置 → 版本更新」一键更新。面板升级后，在面板的「节点」页一键升级各节点。完整的更新日志见 CHANGELOG.md。

v0.18.0

新功能

• 添加容器新增「现有目录」，可将节点上已有的 compose 目录接入面板，数据留在原处。目录中的 .env 导入为容器组变量，原有的命名卷继续使用；部署时停止原来运行的容器并由面板接管，启动失败则自动恢复。仅限管理员。
• 现有目录可选择将其中的子目录（例如数据库目录）纳入快照，并在恢复快照时一并恢复。

修复

• 修复 compose 中使用 env_file 时在面板上无法保存的问题。

升级说明

• 现有目录需将节点升级到 v0.18.0。

安装与升级

全新安装或升级面板（在面板服务器上以 root 执行）：

curl -fsSL https://github.com/SIPC/Nagi/releases/latest/download/install.sh | sudo sh

v0.6.0 及以后的面板也可以在「设置 → 版本更新」一键更新。面板升级后，在面板的「节点」页一键升级各节点。完整的更新日志见 CHANGELOG.md。

v0.17.0

新功能

• 节点设置新增「快照仓库 → 立即清理」，立即回收快照仓库中没有快照使用的数据，包括旧版本快照失败时留下的数据。清理后检查快照是否完好。仅限管理员。

升级说明

• 立即清理需将节点升级到 v0.17.0。

安装与升级

全新安装或升级面板（在面板服务器上以 root 执行）：

curl -fsSL https://github.com/SIPC/Nagi/releases/latest/download/install.sh | sudo sh

v0.6.0 及以后的面板也可以在「设置 → 版本更新」一键更新。面板升级后，在面板的「节点」页一键升级各节点。完整的更新日志见 CHANGELOG.md。

v0.16.3

修复

• 修复定时快照失败后每分钟重试的问题。失败后改为逐级延长重试间隔，最长 60 分钟，节点重启后仍然有效。
• 修复快照失败后重试时重复写入数据、占用磁盘持续增长的问题。失败时已写入的内容会在下次快照时复用。
• 修复定时快照一直失败时快照仓库不再维护的问题。维护改为单独调度。
• 修复有状态容器快照超时后暂停时间超过 30 秒的问题，并在恢复容器失败时报错。

改进

• 磁盘剩余空间不足 2 GiB 或 5% 时跳过定时快照并告警。

升级说明

• 以上修复需将节点升级到 v0.16.3。

安装与升级

全新安装或升级面板（在面板服务器上以 root 执行）：

curl -fsSL https://github.com/SIPC/Nagi/releases/latest/download/install.sh | sudo sh

v0.6.0 及以后的面板也可以在「设置 → 版本更新」一键更新。面板升级后，在面板的「节点」页一键升级各节点。完整的更新日志见 CHANGELOG.md。

v0.16.2

改进

• node_exec 每次执行前先返回预览，经用户确认后才执行。确认后命令和参数不能再改。
• node_exec 需填写使用理由，MCP 会引导 agent 优先使用其他工具。

安装与升级

全新安装或升级面板（在面板服务器上以 root 执行）：

curl -fsSL https://github.com/SIPC/Nagi/releases/latest/download/install.sh | sudo sh

v0.6.0 及以后的面板也可以在「设置 → 版本更新」一键更新。面板升级后，在面板的「节点」页一键升级各节点。完整的更新日志见 CHANGELOG.md。

v0.16.1

新功能

• OAuth 授权页支持勾选「节点终端」，ChatGPT、Claude 网页版等客户端也可以使用 node_exec。仅限管理员。

安装与升级

全新安装或升级面板（在面板服务器上以 root 执行）：

curl -fsSL https://github.com/SIPC/Nagi/releases/latest/download/install.sh | sudo sh

v0.6.0 及以后的面板也可以在「设置 → 版本更新」一键更新。面板升级后，在面板的「节点」页一键升级各节点。完整的更新日志见 CHANGELOG.md。

v0.16.0

新功能

• MCP 支持删除项目、容器和卷中的文件，回到某次部署，以及回滚时恢复数据。
• MCP 支持设置备份节点、从备份节点恢复、迁移容器、换节点重新部署，以及设置、取消和确认顶替。
• MCP 新增 node_exec，以 root 身份在节点上执行命令。仅限管理员，需在生成访问令牌时勾选「节点终端」，每次执行都会记入日志并发送告警。
• 以上不可逆的操作都先返回预览，确认后才执行。

升级说明

• node_exec 需将节点升级到 v0.16.0。

安装与升级

全新安装或升级面板（在面板服务器上以 root 执行）：

curl -fsSL https://github.com/SIPC/Nagi/releases/latest/download/install.sh | sudo sh

v0.6.0 及以后的面板也可以在「设置 → 版本更新」一键更新。面板升级后，在面板的「节点」页一键升级各节点。完整的更新日志见 CHANGELOG.md。