装了 electerm,我把好几个远程工具都删了

简介

什么是 electerm ?

electerm 是一个开源的终端/文件管理器,支持 SSH、SFTP、FTP、telnet、serialport、RDP、VNC、Spice 等多种远程连接协议。除了主流系统,electerm 还支持 Ubuntu 18、Windows 7、macOS 10+ 等旧系统,以及 UOS、麒麟、龙芯(新旧世界)等国产系统和 RISC-V、PowerPC 64 等特殊平台。可以帮助用户在 多个平台上一站式管理远程服务器连接和文件传输。

主要特点

  • 多协议支持:作为终端/文件管理器,支持 ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice 客户端,一个工具搞定多种远程连接。
  • 多平台覆盖:支持 Windows/macOS/Linux/Android/HarmonyOS/iOS,还适配龙芯、RISC-V、PowerPC 等特殊架构 Linux。
  • 全局热键:支持类似 guake 的全局快捷键切换窗口显示,默认是 ctrl + 2,操作高效便捷。
  • 多种认证方式:支持 publicKey、密码、ssh agent、证书、OTP、netbird 等认证方式,安全可靠。
  • 文件编辑与传输:双击即可直接编辑远程小文件,支持 Zmodem(rz, sz) 和 Trzsz(trz/tsz) 传输。
  • 强大的 SSH 特性:支持隧道(tunnel)和连接跳板(hopping)。
  • 数据同步:可将书签等数据同步到 GitHub/Gitee secret gist、WebDAV、自定义服务器或 electerm 云。
  • AI 助手集成:支持多种 LLM API 格式(OpenAI Chat Completions、OpenAI Responses、Anthropic Messages),可提供命令建议、脚本编写、终端内容解释等功能。
  • 可定制 UI:支持主题、背景图、透明窗口(Mac、Win),外观自由定制。
  • 开源免费:基于 MIT 协议开源,可免费使用和修改。

应用场景

  • 远程运维:系统管理员使用 electerm 连接多台 Linux 服务器,统一管理 SSH/SFTP 会话,高效传输文件。
  • 家庭 NAS 管理:借助 Docker 部署 Web 版,随时随地通过浏览器管理家中群晖等 NAS 设备,无需安装客户端。
  • 移动办公:支持 Android、HarmonyOS、iOS,配合 Web 版可在手机、平板上远程连接服务器处理紧急事务。
  • 跨平台开发:开发人员在 Windows、macOS、Linux 之间切换时保持一致的终端使用体验。
  • 开发者测试:开发人员可以快速搭建测试环境,通过多协议连接调试各类服务。

electerm界面截图

electerm 是一个集终端、文件管理、多协议远程连接于一体的跨平台开源利器,凭借丰富的协议支持和极强的平台兼容性深受开发者喜爱。

安装

在群晖上以 Docker 方式安装的是 electerm 的 Web 版本

在注册表中搜索 zxdong262,选择镜像 zxdong262/electerm-web,版本选择 latest。

本文写作时,latest 版本对应为 5.5.76

卷

在 docker 文件夹中,创建一个新文件夹 electerm,并在其中建一个子文件夹 data

文件夹 装载路径 说明
docker/electerm/data /home/electerm/data 存放数据库与配置数据

端口

本地端口不冲突就行,不确定的话可以用命令查一下

1
2
# 查看端口占用
netstat -tunlp | grep 5577
本地端口 容器端口
5577 5577

默认没有对外暴露端口

需要点 + 号自行添加

环境

可变 值
DB_PATH /home/electerm/data
HOST 0.0.0.0

环境变量说明:HOST=0.0.0.0 使服务监听所有网络接口,这样局域网内的设备都能访问。

如需启用登录认证,还可额外设置以下环境变量:

可变 值
SERVER_SECRET some_server_secret
SERVER_PASS password_to_login
ENABLE_AUTH 1

提示:ENABLE_AUTH=1 时启用登录认证,需同时设置 SERVER_SECRET(服务端密钥)和 SERVER_PASS(登录密码)。部署到公网时强烈建议启用。

docker cli 安装

如果你熟悉命令行,可能用 docker cli 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 新建文件夹 electerm 和 子目录
mkdir -p /volume1/docker/electerm/data

# 进入 electerm 目录
cd /volume1/docker/electerm

# 运行容器
docker run --init \
--restart unless-stopped \
--name electerm-web \
-p 5577:5577 \
-v $(pwd)/data:/home/electerm/data \
-e "DB_PATH=/home/electerm/data" \
-e "HOST=0.0.0.0" \
zxdong262/electerm-web

若需要认证,可追加 -e SERVER_SECRET=your_secret -e SERVER_PASS=your_password -e ENABLE_AUTH=1。

1
2
3
4
5
6
7
8
9
10
11
12
# 带认证
docker run --init \
--restart unless-stopped \
--name electerm-web \
-p 5577:5577 \
-v $(pwd)/data:/home/electerm/data \
-e "DB_PATH=/home/electerm/data" \
-e "HOST=0.0.0.0" \
-e "SERVER_SECRET=Trc3czQyPnJPBSAGTj2hokSPdSv7gpDa" \
-e "SERVER_PASS=laosu123" \
-e "ENABLE_AUTH=1" \
zxdong262/electerm-web

docker-compose 安装

将下面的内容保存为 docker-compose.yml 文件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
version: '3.8'

services:
electerm-web:
image: zxdong262/electerm-web:latest
container_name: electerm-web
restart: unless-stopped
init: true
ports:
- "5577:5577" # 左侧为宿主机端口,右侧为容器端口
volumes:
- ./data:/home/electerm/data # 数据持久化目录
environment:
- DB_PATH=/home/electerm/data # 数据库路径
- HOST=0.0.0.0 # 监听地址
# 可选启用认证:
# - SERVER_SECRET=some_server_secret
# - SERVER_PASS=password_to_login
# - ENABLE_AUTH=1

然后通过 SSH 登录到您的群晖,执行下面的命令:

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 electerm 和 子目录
mkdir -p /volume1/docker/electerm/data

# 进入 electerm 目录
cd /volume1/docker/electerm

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中访问 http://<群晖IP>:5577 即可进入 Web 界面,无需安装任何客户端

如果设置了认证,还需要用 SERVER_PASS 设置的值登录一下

登录之后也是一样的

中文

进入 Setting –> Common –> Language

选择 简体中文,不需要重启即可切换到中文

书签

点 + 新建书签,可以看到支持 ssh、telnet 、vnc、rdp 等协议

以 ssh 为例,设置完成后,可以测试一下连接

保存之后可以直接连接

AI

左下角 AI ,老苏还是选择的 SiliconFlow

目前硅基流动(SiliconFlow)注册就送 16 元代金券的活动还在

注册地址:

https://cloud.siliconflow.cn/i/NkUiXVhQ

只要设置 API Key 就行

查个命令还是很方便的

注意事项

  1. 数据持久化:务必挂载 /home/electerm/data 数据卷,否则容器重建后数据会丢失。
  2. 容器端口:镜像内部服务监听 5577 端口,宿主端口 8082 可按需修改,但注意不要与已有服务冲突。
  3. 权限问题:在 Linux 上运行建议使用 --user 参数以当前用户身份运行,避免文件权限问题。
  4. 安全建议:部署到公网时务必启用 ENABLE_AUTH 认证并设置强密码,避免服务暴露给未授权访问。
  5. 认证依赖:启用认证时 SERVER_SECRET 和 SERVER_PASS 需同时设置,缺一不可。
  6. Web 版与桌面版差异:Docker 部署的是 electerm 的 Web 版本,功能与桌面版几乎一致,但若需要桌面独立应用,可直接下载对应平台的客户端安装包。

参考文档

electerm: Free and open-sourced terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(Linux, Mac, Windows, Android, HarmonyOS, iOS)
地址:https://github.com/electerm/electerm

electerm-web-docker: docker image of electerm-web
地址:https://github.com/electerm/electerm-web-docker

zxdong262/electerm-web - Docker Hub
地址:https://hub.docker.com/r/zxdong262/electerm-web

electerm 官方主页
地址:https://electerm.org