项目介绍
Termix 是自托管的服务器管理界面,可在浏览器中使用终端与文件管理。适合集中保存常用主机入口;因为它处理服务器访问凭据,应限制管理页面访问范围。
浏览器提供 SSH 终端和 SFTP 文件操作,主机配置集中保存。终端命令仍在远程服务器执行,操作前核对用户与路径。
适合个人服务器入口管理。管理端具有访问主机的能力,应通过受控网络使用。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 主机管理 | 保存连接与分组 |
| 终端会话 | 查看与操作远端 |
| 分屏标签 | 组织多个连接 |
| SFTP | 传输和编辑文件 |
| 隧道管理 | 按版本设置转发 |
界面展示

图 1:官方仓库提供的项目示意图,用于说明功能与布局。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | NAS 与运维 |
| 项目仓库 | Termix-SSH/Termix |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 创建
/volume1/docker/termix/data目录,按下面配置启动。示例使用宿主端口8086,打开http://NAS_IP:8086完成初始化。 - 创建自己的管理账号,再添加一台测试主机,填写该主机的 SSH 地址、端口和独立账号。首次连接核对主机指纹。
- 在终端执行
whoami与pwd确认用户和目录,再用 SFTP 上传一个测试文件,检查传输权限和中文文件名。 - 需要远程访问时通过 VPN 或 HTTPS 受控入口接入;按使用者分配权限,删除不再使用的主机凭据。
首次使用与操作检查
连接测试主机运行 whoami 和 pwd,再上传一个临时文件核对权限。
多主机窗口标清名称。备份面板数据时保护连接凭据,撤销不再使用的主机密钥。
Docker Compose
依据官方 README 的镜像、8080 容器端口和 /app/data 目录整理,宿主端口改为 8086。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/termix/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/termix /volume1/docker/termix/data
cd /volume1/docker/termix
HALO_PREPARE
cd /volume1/docker/termix
services:
termix:
image: ghcr.io/termix-ssh/termix:latest
restart: unless-stopped
ports:
- "8086:8080"
environment:
PORT: "8080"
volumes:
- /volume1/docker/termix/data:/app/data
在项目目录保存为 compose.yaml 后,先检查配置,再启动:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
配置与常见问题
- 网页终端的权限由远程 SSH 账号决定,不必为了方便统一使用 root。
- 连接失败要区分 Termix 服务本身、NAS 到目标主机的网络和目标 SSH 认证。
- 页面无法打开:先用
docker compose ps检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。 - 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。
更新与备份
备份数据目录,并按敏感凭据处理;恢复到另一环境后重新检查账号、密钥和主机指纹。
更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。
参考资料
配图来自 Termix-SSH/Termix 官方仓库,按 Apache-2.0 许可 保留来源与许可;图片只做等比例缩小和压缩。