安装

安装之前请先检查硬件及依赖符合系统需求

一键安装

在 Linux 服务器上执行，按提示完成安装：

shell

curl -fsSL https://f.next-terminal.com/next-terminal/install.sh | sudo bash

安装成功后

访问 http://{ip}:8088/setup 进行用户初始化设置

访问 http://{ip}:8088/login 进行登陆

停止所有服务，保留配置和数据：

shell

sudo /opt/next-terminal/crt.sh stop

shell

sudo /opt/next-terminal/crt.sh start

shell

sudo /opt/next-terminal/crt.sh upgrade

升级会拉取当前 Compose 配置中全部服务的镜像，并更新需要重建的容器，包括 Next Terminal、PostgreSQL 和 Guacd。保留现有配置和数据，不修改镜像标签。升级期间连接可能中断，请提前备份重要数据。使用固定版本标签时，需要先修改配置中的标签才能升级到其他版本。

PostgreSQL 16 和 PostgreSQL 18 均受支持。现有 PostgreSQL 16 部署可以继续使用，无需为了升级 Next Terminal 而迁移到 PostgreSQL 18。

请确保 PostgreSQL 服务端与 Next Terminal 镜像内置的 PostgreSQL client 主版本一致：

PostgreSQL 服务端	Next Terminal 镜像
`postgres:16`	`dushixiang/next-terminal:latest`
`postgres:18`	`dushixiang/next-terminal:latest-pg18`

如果使用阿里云镜像，请保留原有镜像仓库地址，并使用对应的标签。

仅在迁移到 PostgreSQL 18 时需要注意

如果现有 docker-compose.yaml 使用的是 postgres:16，请勿直接将其修改为 postgres:18。PostgreSQL 的主版本不能通过更换容器镜像直接升级，PostgreSQL 18 也无法直接使用 PostgreSQL 16 的数据目录。

如需迁移到 PostgreSQL 18，请按照从 PostgreSQL 16 迁移到 PostgreSQL 18完成数据库迁移；不需要迁移时，请继续保留现有 PostgreSQL 16 配置。