注意：说明：
注意：Linux 客户端即将支持，暂时可使用浏览器访问 OrcaTerm Web。移动端目前支持微信小程序。
一、系统要求
| 平台 | 最低系统版本 | 架构 |
| Windows | Windows 10/11 | x64 |
| macOS | macOS 13+ | Apple Silicon（arm64）、Intel（x64） |
二、下载入口
通过以下任一渠道获取安装包：
·页面：访问 OrcaTerm 页面 下载。
·控制台：访问 OrcaTerm Web，在顶部导航或侧边栏菜单中找到下载客户端入口。
·自动更新：已安装的旧版本客户端启动后会自动检测并下载新版本，详情请参见 自动更新。
三、Windows 安装
1. 下载 .exe 安装包后双击运行。
2. 按安装向导选择安装目录与快捷方式位置。
3. 安装完成即可启动；首启会出现引导动画并引导你完成主题与默认 Shell 选择。
四、macOS 安装
1. 下载 .dmg 镜像后双击打开。
2. 将 OrcaTerm 拖入 Applications 文件夹。
五、首次启动引导
首次启动客户端会进入引导流程：
1. 欢迎动画：播放 Logo 与主题预览动画。
2. 主题选择：选择深色或浅色主题（后续可在设置中切换，主题会同步到 Windows 标题栏与窗口装饰）。
六、本地终端
客户端可在不连接任何远程服务器的情况下，直接打开本机 Shell 终端：
·打开方式：在顶部中导航栏中单击 + 按钮。
·自动打开终端：在通用设置-基础设置下，开启启动时打开终端。
·Shell 选择：在通用设置-终端设置中，设置新建 Shell 连接类型。系统会自动检测当前可用的 Shell 列表，跨平台同步时如所选 Shell 在当前系统不存在会自动回退到系统默认 Shell，避免启动失败。
注意：说明：
注意：本地终端仅客户端可用，Web 端因浏览器沙箱限制无法直接启动本机 Shell。
七、本地凭据存储
客户端除云端凭据托管外，还支持将凭据保存在本机：
·未登录腾讯云账号时，凭据默认存储在本地，不占用云端托管配额。
·已登录且云端配额已满时，可手动选择本地存储创建凭据，配额不受限。
·本地凭据可随时通过列表中的上传至云端迁移到云端（需登录且云端配额充足）。
凭据管理详情请参见 管理登录凭据。
八、本地直连远程服务器
通过本机 SSH 客户端直连远程服务器（绕过 OrcaTerm 中转），降低延迟、提升传输性能：
·适用场景：SSH 协议且使用公网 IP 登录的连接配置、或任意有公网 IP 的自建服务器。
·自动启用：满足条件的连接在客户端登录时自动走本地直连通道，无需额外配置。
·SFTP 文件传输：本地直连模式下，文件上传 / 下载直接走本机网络，速度更快。
注意：本地直连要求本机能够直接访问服务器 IP 与端口。若服务器位于内网且本机无法直连，请改用云端中转方式登录。
九、RDP 虚拟磁盘
客户端的远程桌面（RDP）会话支持挂载本机目录为虚拟磁盘：
·挂载：在 RDP 会话的文件管理器面板中单击挂载虚拟磁盘，选择本机目录。
·自动恢复：登录 RDP 后会自动恢复上次挂载的磁盘列表，无需重复挂载。
·持久化：挂载列表按实例或 IP 持久化保存，重连后自动恢复。
注意：说明：
注意：RDP 虚拟磁盘仅客户端可用，Web 端 RDP 会话不支持挂载本机目录。
十、静默自动更新
客户端内置自动更新能力：
·启动检查：应用启动时自动检查新版本。
·定时检查：每 4 小时定时检查一次。
·可见性恢复检查：从后台切回前台、网络恢复时立即触发检查。
·静默下载：检测到新版本后在后台静默下载，不打断当前操作。
·重启提示：下载完成后弹出提示卡片，单击重启升级完成安装并重启。
·菜单手动检查：在应用菜单选择检查更新可手动触发检查，目前支持 macOS 版本。
注意：说明：
注意：Windows 端安装新版本时会由 installer 完成替换并自动重启；macOS 端在 install 完成后由应用主动 relaunch。更新失败时会静默记录日志，不影响当前使用。
十一、版本回退（降级）
当服务端发布版本低于本地版本时（如灰度回滚），客户端支持自动降级到服务端发布版本。
十二、客户端与 Web 端能力对比
| 能力 | Web 端 | 客户端 |
| 远程服务器连接（TAT / SSH / RDP） | √ | √ |
| 会话管理、分屏、多标签 | √ | √ |
| 凭据云端托管 | √ | √ |
| 凭据本地存储 | × | √ |
| 本地终端（本机 Shell） | × | √ |
| 本地直连远程服务器（绕过中转） | × | √ |
| RDP 虚拟磁盘挂载 | × | √ |
| 系统级窗口与全屏 | ×（仅浏览器全屏） | √ |
| 离线使用 | √ （公网 IP 服务器 SSH、RDP 连接） | √（本地终端 / 本地凭据） |
| 跨设备数据同步 | √（云端） | √（云端）+ √（本地） |
注意：说明：
注意：客户端与 Web 端共享同一套云端数据（连接配置、云端凭据、设置项），登录同一账号即可在两端同步。
十三、Windows 安装时提示 SmartScreen 已阻止启动
单击更多信息 > 仍要运行即可继续安装。
十四、自动更新失败
·检查网络连接是否正常。
·若长期无法更新，可前往页面下载最新安装包覆盖安装，配置与数据不受影响。
·更新失败详情会写入客户端日志，可在设置 > 关于中查看日志或联系支持。
十五、本地终端 Shell 启动失败
·在设置中切换默认 Shell 为系统存在的 Shell。
·跨设备同步的 Shell 设置可能在当前系统不存在，系统会自动回退到默认 Shell；如仍失败请手动选择。