常见问题 FAQ

1. 首次运行提示 SmartScreen「已保护你的电脑」，安全吗？

EasySSH 的 exe 未做代码签名，Windows SmartScreen 对未签名程序会提示一次。确认文件来自官网 easyssh.cn 且 sha256 与下载页一致后，点击「更多信息」→「仍要运行」即可，之后不会再提示。

2. 终端中文显示乱码怎么办？

在设置中心将编码改为 GBK 或 GB18030（与服务器实际编码保持一致）。注意：编码设置只对新建立的连接生效，改完后请断开并重连。

3. 连接时报 "Cannot parse privateKey: Unsupported key format"

你使用的可能是 v2.3.0/2.3.1 生成的 PKCS#8 格式私钥。请升级到 v2.3.2 及以上版本：新版生成的私钥为标准 OpenSSH 格式，且连接时会自动把旧 PKCS#8 私钥转换为可解析格式，旧密钥无需重新生成。

4. 如何卸载 EasySSH？

EasySSH 是绿色版软件，无需卸载程序：直接删除 exe 所在文件夹即可。会话、设置（config.json）与密钥（keys/）都在该文件夹内，删除即彻底清除。若担心密码泄露，删除前可先清空「保存会话」的密码。

5. EasySSH 免费吗？开源吗？

完全免费且开源，采用 MIT 协议，源码全部公开，可自由使用、修改与分发。技术栈（Electron、xterm.js、ssh2、iconv-lite）均为开源组件。

6. 我的密码保存在哪里，安全吗？

保存在 exe 同目录的 config.json 中，为明文保存，随文件夹携带。请在可信环境中使用；公共电脑等不可信环境请勿勾选「保存会话」。

7. 勾选「保存会话」后连接总是用旧密码？

保存会话的密码会在下次连接时覆盖你新输入的密码。若服务器密码已修改，请删除或编辑该会话记录后重新连接并保存新密码。

8. 会话断开后如何重连？

标签不会关闭，在终端中按回车即自动重连；重连失败可继续按回车重试。

9. 换电脑/重装系统后配置和会话还在吗？

在。会话、设置、密钥都随 exe 所在文件夹携带，把整个文件夹拷贝到新电脑即可继续使用，无需任何导入导出操作。

10. SFTP 传文本文件到 Windows 后换行符不对 / 乱码？

使用「文本转换」传输模式：下载时自动把服务器编码转为 UTF-8 并统一为 CRLF 换行，上传时反向转换。二进制模式为原样传输，不会做任何转换，程序/压缩包请务必使用二进制模式。

11. 一键生成的密钥如何装到服务器上？

两种方式：① 复制界面显示的公钥内容，手工追加到服务器 ~/.ssh/authorized_keys；② 在已用密码连接的会话中点击「安装到当前已连服务器」，自动写入并设置好权限（700/600），之后即可改用私钥登录。

12. 提示「文件被占用」无法运行？

v1.4.1 起已有单实例锁防止残留进程。若仍出现，请打开任务管理器结束残留的 EasySSH 进程后再启动。