electerm 快速上手指南：从安装到拖拽传文件只需 5 步
【免费下载链接】electerm📻Free and open-sourced terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(Linux, Mac, Windows, Android, HarmonyOS, iOS)项目地址: https://gitcode.com/GitHub_Trending/el/electerm
electerm 是一款免费开源的终端客户端，把 SSH、SFTP、Telnet、串口、RDP、VNC 连接收进同一个窗口，支持 Windows、macOS、Linux、Android、iOS、HarmonyOS，连 Windows 7 和老款 Linux 都能跑。这篇指南带你从安装、建连接、传文件到导入现有 SSH 配置，5 个步骤走一遍，读完你就能用它的终端 + 文件面板完成一次完整的远程操作。
一个终端替代三件工具：适合谁用
想象一下凌晨修线上问题：你要登服务器、把补丁文件传上去、再执行命令验证。传统做法要开着本地终端、再开一个 sftp 会话、文件管理器来回切。用 electerm，连上 SSH 后终端旁边就是文件面板，同一个窗口里完成登录、传文件、执行命令三件事。如果你要维护十几台机器，书签 + 分组 + 搜索还能让每台机器一找就到；全局热键（默认 Ctrl+2）随时呼出隐藏的主窗口，类似 Guake 的用法。
electerm 安装与首次连接：5 步跑通
- 安装：按系统选一条——macOS 执行
brew install --cask electerm；Windows 用winget install electerm.electerm或去 Microsoft Store 搜索；Linux 执行sudo snap install electerm --classic或npm i -g electerm。想读源码可以git clone https://gitcode.com/GitHub_Trending/el/electerm后执行npm i && npm start（需 Node.js 24）。 - 新建书签：界面左侧书签区点击新建，选择 SSH 类型，填主机名、端口、用户名，认证方式选密码或密钥。
- 连接：单击书签即可进入终端，直接敲
whoami验证。SSH 会话的握手逻辑在 会话实现 src/app/server/session-ssh.js。 - 打开文件面板：连接成功后，终端旁会出现 SFTP 文件面板，左边本地、右边远程，见 文件面板入口 src/client/components/sftp/sftp-entry.jsx。
- 拖拽传文件：把本地文件拖进远程目录，传输队列里出现进度条，完成即结束。
三个高频操作：导入配置、拖拽传输、rz/sz
一键导入现有 ~/.ssh/config
如果你已经维护了多年的~/.ssh/config，不必手敲一遍：在书签面板的 SSH 配置加载入口里选择文件，它会把里面的 Host 解析成书签。解析逻辑见 ssh-config 解析 src/app/lib/ssh-config.js，导入界面在 加载入口 src/client/components/ssh-config/load-ssh-configs.jsx。
拖拽传文件，重名自动问
本地文件拖到远程目录（反向也行），整文件夹可以直接拖。所有传输走统一队列排队，速度实时可见；目标端已有同名文件时会弹冲突对话框，选覆盖、跳过还是改名，由你定。队列与速度展示在 传输队列 src/client/components/file-transfer/transfer-queue.jsx。
终端里直接用 rz/sz
在终端输入sz 文件名（或远端执行rz），electerm 会自动识别 Zmodem 协议并弹出文件选择框，不用切到文件面板。传输卡住时看门狗会自动复位会话，终端不会假死，实现见 Zmodem 协议处理 src/app/server/zmodem.js。
把重复命令存成快捷指令
每次都要跑同一组命令（查负载、清日志、看进程），把它存为快捷指令，之后点一下即可执行，还能绑定键盘快捷键。界面组件在 快捷指令 src/client/components/quick-commands/quick-commands-box.jsx。
进阶入口：数据同步与主题
不想换电脑就重输一遍书签？设置里的同步功能支持把书签、设置推送到 Gist、WebDAV 或 electerm 云，多台设备共用一份连接列表。终端配色和背景图可在主题页自定义。想深入代码，看目录结构：
src/ ├── app/ # 主进程：会话、SFTP、rz/sz ├── client/components/ │ ├── sftp/ # 文件管理面板 │ └── file-transfer/ # 传输队列与冲突处理连接与传输排障速查表
| 现象 | 可能原因 | 解决办法 |
|---|---|---|
| 连接提示 Permission denied | 密钥没选对或密码已改 | 编辑书签检查密钥路径，或改回密码认证 |
| 中文输出乱码 | 终端 locale 不一致 | 终端内执行locale确认，并在设置中调整语言 |
| 传输进度停在 0% | 网络抖动或目标文件正被写入 | 在传输队列中重试；大文件先传小样验证 |
| rz/sz 无反应 | 中途协议被打断 | 重新执行 sz；终端卡住时重置会话再试 |
| 导入 SSH 配置缺项 | config 里用了少见的指令 | 对照~/.ssh/config手动补全书签表单 |
收个尾
- 安装 electerm 并成功启动
- 建一个 SSH 书签并连上，执行
whoami - 拖一个文件到远程服务器，在传输队列看到完成
- 导入现有的
~/.ssh/config - 存一条你每天会跑的快捷指令
勾完这 5 项，electerm 就真正长在你的工作流里了。
【免费下载链接】electerm📻Free and open-sourced terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(Linux, Mac, Windows, Android, HarmonyOS, iOS)项目地址: https://gitcode.com/GitHub_Trending/el/electerm
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
