原生安装升级到 v3.2.0 及以上版本

从 v3.2.0 开始，Next Terminal 调整了原生安装包结构。安全网关和前端页面不再打包进 next-terminal 二进制文件，而是从本地 bin 和 web 目录读取。

这个调整将服务端内存占用从约 200 MB 降低到约 80 MB，但也意味着旧版单文件部署方式不能直接替换二进制文件完成升级。升级到 v3.2.0 及以上版本时，需要同时更新 next-terminal、bin 和 web。

适用范围

本文适用于通过原生安装方式部署的 Next Terminal，并且当前安装目录中只有旧版 next-terminal 单个二进制文件，或者缺少新版所需的 bin、web 目录。

如果你使用的是 Docker 或 Docker Compose 部署，请按照容器部署方式更新镜像，不需要执行本文步骤。

升级前准备

升级前建议先完成以下检查：

1. 确认当前安装目录，默认是 /usr/local/next-terminal。
2. 备份当前的 config.yaml、数据库文件和其他自定义文件。
3. 确认服务启动用户对安装目录下的 next-terminal、bin、web 有读取和执行权限。

升级步骤

1. 下载最新原生安装包：

   wget https://f.typesafe.cn/next-terminal/servers/next-terminal.tar.gz

2. 解压安装包：

   tar -zxvf next-terminal.tar.gz

3. 解压后应能看到以下文件和目录：

   drwxr-xr-x  bin
   -rw-r--r--  config.yaml
   -rwxr-xr-x  next-terminal
   drwxr-xr-x  web

4. 停止当前服务：

   systemctl stop next-terminal

5. 将 next-terminal、bin、web 复制到 Next Terminal 安装目录。默认安装目录为 /usr/local/next-terminal：

   cp -r next-terminal bin web /usr/local/next-terminal/

   如果你修改过安装目录，请替换为实际路径。

6. 确认 next-terminal 具有执行权限：

   chmod +x /usr/local/next-terminal/next-terminal

7. 重启服务：

   systemctl restart next-terminal

升级后检查

升级完成后，可以通过以下方式确认服务是否正常：

systemctl status next-terminal
journalctl -u next-terminal -n 100 --no-pager

如果页面资源加载异常、前端页面空白，或安全网关相关功能异常，优先检查安装目录下是否存在 web 和 bin 目录，以及服务启动用户是否有权限读取这些目录。