NAS 与运维

Termix:用浏览器管理 SSH 与 SFTP

  • 0 次阅读
  • 0 条评论
文章摘要

Termix 是自托管的服务器管理界面,可在浏览器中使用终端与文件管理。适合集中保存常用主机入口;因为它处理服务器访问凭据,应限制管理页面访问范围。 浏览器提供 SSH 终端和 SFTP 文件操作,主机配置集中保存。终端命令仍在远程服务器执行,操作前核对用户与路径。 适合个人服务器入口管理。管理端具有访问主机的能力,应通过受控网络使用。

项目介绍

Termix 是自托管的服务器管理界面,可在浏览器中使用终端与文件管理。适合集中保存常用主机入口;因为它处理服务器访问凭据,应限制管理页面访问范围。

浏览器提供 SSH 终端和 SFTP 文件操作,主机配置集中保存。终端命令仍在远程服务器执行,操作前核对用户与路径。

适合个人服务器入口管理。管理端具有访问主机的能力,应通过受控网络使用。

核心功能

功能 作用与使用方式
主机管理 保存连接与分组
终端会话 查看与操作远端
分屏标签 组织多个连接
SFTP 传输和编辑文件
隧道管理 按版本设置转发

界面展示

Termix 官方项目配图

图 1:官方仓库提供的项目示意图,用于说明功能与布局。

项目信息

项目 说明
类型 Docker
分类 NAS 与运维
项目仓库 Termix-SSH/Termix
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 创建 /volume1/docker/termix/data 目录,按下面配置启动。示例使用宿主端口 8086,打开 http://NAS_IP:8086 完成初始化。
  2. 创建自己的管理账号,再添加一台测试主机,填写该主机的 SSH 地址、端口和独立账号。首次连接核对主机指纹。
  3. 在终端执行 whoami 与 pwd 确认用户和目录,再用 SFTP 上传一个测试文件,检查传输权限和中文文件名。
  4. 需要远程访问时通过 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 许可 保留来源与许可;图片只做等比例缩小和压缩。