跳到主要内容

常见问题

本文汇总 XTerminal 使用过程中的常见问题及解决方案。

连接相关​

Q: 连接超时，无法连接到服务器？​

可能原因：

  1. 网络问题 - 本地网络不通或服务器不可达
  2. 端口错误 - SSH 端口不是默认的 22
  3. 防火墙拦截 - 服务器或本地防火墙阻止了连接
  4. 代理问题 - 需要通过代理才能访问

解决方案：

  1. 检查网络连接，尝试 ping 服务器地址
  2. 确认 SSH 服务端口号是否正确
  3. 检查服务器防火墙设置，确保 SSH 端口开放
  4. 如需代理，在连接的 代理设置 中配置代理地址
  5. 尝试增加超时时间：在连接的 连接设置 中调整超时时间

Q: 密码正确但认证失败？​

可能原因：

  1. 用户名错误 - 用户名大小写敏感
  2. 密码含特殊字符 - 某些特殊字符可能导致问题
  3. 账户被锁定 - 多次失败后账户可能被锁定
  4. SSH 配置限制 - 服务器禁止了密码认证

解决方案：

  1. 仔细核对用户名，注意大小写
  2. 尝试使用密钥认证替代密码认证
  3. 联系服务器管理员检查账户状态
  4. 检查服务器 /etc/ssh/sshd_config 中 PasswordAuthentication 是否为 yes

Q: 密钥认证失败？​

可能原因：

  1. 私钥路径错误 - 指定的私钥文件不存在
  2. 公钥未部署 - 公钥未添加到服务器的 ~/.ssh/authorized_keys
  3. 私钥密码错误 - 如果私钥有密码保护，需要正确输入
  4. 文件权限问题 - 服务器上 .ssh 目录或文件权限不正确
  5. 密钥格式不支持 - 使用了不兼容的密钥格式

解决方案：

  1. 确认私钥文件路径正确且文件存在
  2. 将公钥内容添加到服务器 ~/.ssh/authorized_keys 文件
  3. 正确输入私钥密码（如有）
  4. 检查服务器上的权限： 
    chmod 700 ~/.ssh
    chmod 600 ~/.ssh/authorized_keys
  5. 推荐使用 ED25519 或 RSA 格式的密钥

Q: 如何连接需要跳板机的服务器？​

XTerminal 支持多跳代理连接。

配置步骤：

  1. 先创建跳板机的 SSH 连接并保存
  2. 创建目标服务器连接
  3. 在目标服务器连接的配置中，找到 代理设置 > 代理服务器
  4. 选择已保存的跳板机连接
  5. 保存并连接

支持链式跳板，可以配置多级跳板机。

详见 多跳代理 文档。

Q: 连接经常自动断开？​

可能原因：

  1. 网络不稳定 - 网络波动导致连接中断
  2. 服务器超时 - 服务器设置了空闲超时
  3. 心跳间隔过长 - Keep Alive 设置不合适

解决方案：

  1. 调整心跳时间：在连接的 连接设置 中设置较短的心跳时间（如 5000 毫秒）
  2. 检查服务器的 ClientAliveInterval 和 ClientAliveCountMax 设置
  3. 开启自动重连：在 设置 > SSH 服务 中开启相关选项

认证相关​

Q: 如何配置双因素认证（2FA）？​

XTerminal 支持 keyboard-interactive 认证方式，可以处理 2FA 场景。

配置步骤：

  1. 在连接配置中，将 验证方式 设置为 交互认证
  2. 连接时，XTerminal 会弹出对话框让你输入各项认证信息
  3. 依次输入密码和 2FA 验证码

详见 双因素认证 文档。

Q: 密码保存在哪里？是否安全？​

存储位置：

  • 本地仓库：存储在本地数据库中
  • 云端仓库：使用同步密码加密后存储在云端

安全措施：

  1. 云端同步需要设置同步密码，数据端到端加密
  2. 可以开启锁屏密码，保护应用访问
  3. 支持「每次询问」模式，不保存密码
提示

对于高安全要求的场景，推荐使用密钥认证或设置「每次询问」模式。

Q: 如何管理多个服务器使用的相同凭证？​

使用 登录凭证 功能可以复用相同的认证信息。

配置步骤：

  1. 打开 设置 > SSH 服务 > 身份管理
  2. 添加新的身份凭证（用户名+密码 或 用户名+密钥）
  3. 在创建连接时，验证方式 选择 登录凭证
  4. 选择已保存的凭证

详见 密钥认证 文档中的身份管理部分。

传输相关​

Q: 文件上传或下载失败？​

可能原因：

  1. SFTP 未启用 - 服务器未开启 SFTP 服务
  2. 权限不足 - 没有目标目录的读写权限
  3. 磁盘空间不足 - 服务器或本地磁盘空间不足
  4. 连接中断 - 网络问题导致传输中断

解决方案：

  1. 确认服务器开启了 SFTP 子系统
  2. 检查目标目录的权限
  3. 清理磁盘空间
  4. 检查网络连接，尝试重新传输

Q: 传输大文件时速度很慢？​

优化建议：

  1. 检查网络带宽，传输速度受限于网络
  2. 对于大量小文件，可以先压缩成单个文件再传输
  3. 避免同时进行多个大文件传输
  4. 检查是否有代理或 VPN 影响速度

Q: 如何修改默认下载目录？​

设置路径：

设置 > 传输设置 > 默认下载目录

可以选择：

  • 固定目录：所有下载保存到指定目录
  • 每次询问：每次下载时选择保存位置

Q: 传输队列在哪里查看？​

点击应用底部状态栏的传输图标，可以查看当前的传输队列，包括：

  • 正在进行的传输
  • 等待中的任务
  • 已完成的传输

可以暂停、继续或取消传输任务。

界面相关​

Q: 终端显示乱码？​

可能原因：

  1. 字符编码不匹配 - 终端编码与服务器不一致
  2. 字体不支持 - 当前字体不包含某些字符

解决方案：

  1. 调整字符编码：在连接的 高级设置 > 终端显示编码 中选择正确的编码（通常为 UTF-8）
  2. 更换支持更多字符的字体
  3. 确保服务器的 LANG 环境变量设置正确

Q: 如何更换终端主题？​

设置路径：

设置 > 通用终端 > 终端配色

提供数十种预设主题，也支持自定义配色。

详见 主题定制 文档。

Q: 字体显示不正确或模糊？​

解决方案：

  1. 更换字体：在 设置 > 通用终端 > 基础配置 > 字体 中更换
  2. 推荐使用等宽字体：Ubuntu Mono、Menlo、Monaco、Consolas
  3. 如果字体模糊，尝试关闭硬件加速：设置 > 系统配置 > 禁用硬件加速
  4. 调整字号到合适大小

Q: 如何调整界面透明度？​

设置路径：

设置 > 外观设置

可以调整：

  • 全局透明度：整体窗口透明度
  • 背景图片：设置自定义背景
  • 背景模糊：背景图片模糊程度

Q: 终端颜色与预期不符？​

可能原因：

  1. 终端主题配色影响
  2. 自定义高亮规则覆盖
  3. 应用使用了自己的配色

解决方案：

  1. 在 设置 > 通用终端 > 终端配色 中更换或调整主题
  2. 检查 自定义高亮 规则是否影响显示
  3. 某些应用（如 vim）有自己的配色，需要在应用内调整

性能相关​

Q: 应用启动或运行时卡顿？​

解决方案：

  1. 禁用硬件加速：设置 > 系统配置 > 禁用硬件加速
  2. 切换渲染模式：设置 > 通用终端 > 高级配置 > 渲染模式 选择 最佳兼容（DOM）
  3. 减少同时打开的连接数
  4. 清理历史数据：减少终端保存行数
  5. 关闭不需要的功能：如服务器监控、命令补全等

Q: 内存占用过高？​

优化建议：

  1. 减少终端 保存行数（默认 3000 行）
  2. 关闭不使用的连接标签页
  3. 关闭 会话录制 功能
  4. 适当减少同时打开的分屏数量

Q: 如何查看应用日志排查问题？​

方法一：调试台

  1. 打开 设置 > 系统配置
  2. 点击 打开调试台
  3. 查看控制台输出

方法二：日志文件

  1. 打开 设置 > 系统配置
  2. 点击 打开日志目录
  3. 查看日志文件

功能相关​

Q: 如何批量管理多个服务器？​

XTerminal 提供多种批量管理方式：

  1. 分组管理：创建分组，将连接归类
  2. 导入导出：批量导入连接配置
  3. 云端同步：多设备同步连接配置
  4. 快速命令：创建通用命令，一键执行

Q: 如何实现端口转发？​

XTerminal 支持三种端口转发：

  • 本地转发（-L）：将本地端口转发到远程
  • 远程转发（-R）：将远程端口转发到本地
  • 动态转发（-D）：创建 SOCKS5 代理

详见 端口转发 文档。

Q: 命令补全功能如何使用？​

开启方式：

设置 > 通用终端 > 命令提示 > 是否启用

开启后，输入命令时会显示补全建议。支持：

  • 600+ 常用命令补全
  • 历史命令补全
  • 包管理器安装包补全

详见 命令补全 文档。

Q: 如何录制和回放终端会话？​

开启录制：

设置 > 通用终端 > 会话记录 > 是否录制终端数据

回放方式：

  1. 点击 查看日志 打开录制目录
  2. 点击 打开工具 启动回放器
  3. 选择录制文件进行回放

详见 会话录制与回放 文档。

Q: 如何使用 AI 功能？​

XTerminal 集成了 AI 辅助功能：

  1. AI 命令补全：在 设置 > 通用终端 > AI 模式 中开启
  2. AI 聊天：在 设置 > 小工具配置 > AI 聊天设置 中配置 API Key
  3. 问问小易：右键菜单中使用 AI 解答问题

数据相关​

Q: 如何备份和恢复数据？​

自动备份：

设置 > 备份恢复 > 每日自动备份

手动备份：

  1. 打开 设置 > 备份恢复
  2. 点击 立即备份

恢复数据：

  1. 打开 设置 > 备份恢复
  2. 点击 导入备份
  3. 选择备份文件

Q: 数据存储在哪里？​

  • macOS: ~/Library/Application Support/XTerminal
  • Windows: %APPDATA%/XTerminal
  • Linux: ~/.config/XTerminal
注意

直接修改数据目录可能导致应用异常，建议使用应用内的导入导出功能。

Q: 如何在多台设备间同步数据？​

使用 云端同步 功能：

  1. 登录 XTerminal 账户
  2. 设置同步密码（用于加密数据）
  3. 在其他设备登录相同账户
  4. 使用相同的同步密码解密

详见 云端同步 文档。

其他问题​

Q: 如何反馈问题或建议？​

访问 XTerminal 官方反馈论坛：https://host.terminal.icu/

反馈时请提供：

  • 操作系统版本
  • XTerminal 版本
  • 问题的详细描述
  • 相关的日志信息

Q: 如何获取最新版本？​

自动更新：

在 设置 > 软件更新 中开启 自动更新

手动更新：

  1. 打开 设置 > 软件更新
  2. 点击 检查更新
  3. 如有新版本，点击下载安装

相关文档​