常见问题

安装与启动

Windows 安装后无法启动？

通常是缺少 WebView2 运行时。Windows 11 和较新的 Windows 10 版本已内置，较旧系统需要手动安装：

macOS 打不开 / 提示"已损坏"或"无法验证开发者"？

由于苹果开发者账号正在更换，当前版本未完成签名。macOS 的 Gatekeeper 会阻止未签名应用运行。

解决方法：打开「终端」应用，执行以下命令：

sudo xattr -rd com.apple.quarantine /Applications/iShell\ Pro.app

输入系统密码后回车，之后即可正常双击打开 iShell Pro。此命令只需执行一次。

此问题将在新开发者证书签发后的下一版本中自动修复，届时无需再执行上述命令。

Linux 启动报错？

确保已安装 WebKitGTK 依赖：

# Ubuntu / Debian
sudo apt install libwebkit2gtk-4.1-0

# Fedora
sudo dnf install webkit2gtk4.1

SSH 连接

连接超时怎么办？

检查目标服务器地址和端口是否正确
确认 SSH 服务已运行：systemctl status sshd
检查防火墙是否放行端口：sudo ufw status
如使用跳板机，逐级排查连接链路
在主机设置中增大连接超时时间

连接后经常断开？

在主机设置中配置 Keep-Alive 保活间隔，建议设为 30~60 秒，并设置最大重试次数为 3~5 次。这样即使网络短暂波动也不会断开连接。

终端中文显示乱码？

两步解决：

在 iShell Pro 主机设置中将终端编码切换为 UTF-8（或服务器实际使用的编码如 GBK）
检查服务器端环境变量：echo $LANG，确认为 zh_CN.UTF-8

SFTP

上传大文件失败？

SFTP 编辑器的默认在线编辑文件大小限制为 1MB，可在 SFTP 设置中调大。如果是纯粹的文件传输（非在线编辑），不受此限制。对于超大文件推荐使用 scp 或 rsync 命令。

AI 助手

内置 AI 通道无法使用？

确认已注册并登录账号（内置通道需要登录）
检查网络连接是否正常
尝试切换到其他模型提供商

如何在企业内网使用 AI？

安装 Ollama
在内网服务器上安装 Ollama（ollama.com）
部署模型
运行 ollama pull llama3 下载模型（可离线导入）
配置 iShell Pro
在设置中选择 Ollama 提供商，填入服务地址 http://your-server:11434

工具迁移

如何从 XShell / SecureCRT 等工具迁移？

主机管理面板 → 点击 「导入」 → 选择工具类型 → 选择文件 → 确认导入。

支持 8 种来源：XShell、SecureCRT、MobaXterm、FinalShell、XTerminal、PuTTY、CSV、SSH Config。

政企版

政企版和标准版有什么区别？

功能上：两者核心功能完全一致。区别在于政企版从源码级移除了所有联网模块（云同步、自动更新等），实现纯离线运行。AI 可通过 Ollama 离线使用。

如何获取政企版？

通过官网 ishell.cc 联系商务团队，了解报价和部署方案。

其他

数据存储在哪里？

所有数据存储在用户本地应用目录中。凭据使用 AES-256-GCM 加密存储，密钥与设备硬件指纹绑定。

支持哪些平台？

平台	最低版本
Windows	10 (1809+)
macOS	Catalina 10.15+（Intel & Apple Silicon）
Linux	Ubuntu 20.04+ / Debian 11+
Android	8.0+
iOS	14+