安装桌面客户端

OrcaTerm 目前提供 Windows 与 macOS 客户端，在浏览器版本的基础上扩展了本地终端、本地凭据存储、RDP 虚拟磁盘、系统级窗口管理等能力，适合需要在本机直接操作、离线使用或追求原生体验的用户。

Note

Linux 客户端即将支持，暂时可使用浏览器访问 OrcaTerm Web。移动端目前支持微信小程序

下载与安装

系统要求

平台	最低系统版本	架构
Windows	Windows 10/11	x64
macOS	MacOS 13+	Apple Silicon（arm64）、Intel（x64）

下载入口

通过以下任一渠道获取安装包：

官网：访问 OrcaTerm 官网下载。
控制台：访问 OrcaTerm Web，在顶部导航或侧边栏菜单中找到 下载客户端 入口。
自动更新：已安装的旧版本客户端启动后会自动检测并下载新版本（详见下文「自动更新」）。

Windows 安装

下载 .exe 安装包后双击运行。
按安装向导选择安装目录与快捷方式位置。
安装完成即可启动；首启会出现引导动画并引导您完成主题与默认 Shell 选择。

macOS 安装

下载 .dmg 镜像后双击打开。
将 OrcaTerm 拖入 Applications 文件夹。

命令行安装

除下载安装包外，也可以在终端中执行一条命令完成安装，适合习惯使用命令行的用户或批量部署场景。脚本会自动识别系统架构、下载当前最新版本并完成安装。

macOS —— 打开「终端」，粘贴执行：

curl -fsSL https://orcaterm.run/scripts/install.sh | bash

Windows —— 打开 PowerShell，粘贴执行：

irm https://orcaterm.run/scripts/install.ps1 | iex

若使用命令提示符（CMD）：

powershell -NoProfile -Command "iex(irm https://orcaterm.run/scripts/install.ps1)"

看到下面这行输出即表示安装成功：

[OrcaTerm] Install success: /Applications/OrcaTerm.app

安装前请先退出正在运行的 OrcaTerm，否则客户端运行中会导致安装中止，以避免未保存的会话丢失。

先确认脚本内容

上述命令是将官方脚本直接交给终端执行。如果希望先确认脚本做了什么，可先下载查看再执行：

curl -fsSL https://orcaterm.run/scripts/install.sh -o install.sh
less install.sh          # 查看内容，按 q 退出
sh install.sh            # 确认无误后再执行

自定义安装位置（仅 Windows）

命令行安装默认装到当前用户目录，无需管理员权限。如需安装到其他磁盘：

iex "& { $((New-Object System.Net.WebClient).DownloadString('https://orcaterm.run/scripts/install.ps1')) } -Location 'D:\Apps\OrcaTerm'"

Note

路径请不要包含空格，安装程序对带空格的路径支持有限。

Tip

命令行安装的版本与安装包安装的版本共用同一套本机数据（登录状态、凭据、会话记录），换用另一种方式安装不会丢失数据。

首次启动引导

首次启动客户端会进入引导流程：

欢迎动画：播放 Logo 与主题预览动画。
主题选择：选择深色或浅色主题（后续可在设置中切换，主题会同步到 Windows 标题栏与窗口装饰）。

桌面端专属能力

本地终端

客户端可在不连接任何远程服务器的情况下，直接打开本机 Shell 终端：

打开方式：在顶部中导航栏中点击 + 按钮。
自动打开终端：在通用设置-基础设置下，开启 启动时打开终端。
Shell 选择：在通用设置-终端设置中，设置 新建 Shell 连接类型。系统会自动检测当前可用的 Shell 列表，跨平台同步时如所选 Shell 在当前系统不存在会自动回退到系统默认 Shell，避免启动失败。

Note

本地终端仅桌面端可用，Web 端因浏览器沙箱限制无法直接启动本机 Shell。

本地凭据存储

客户端除云端凭据托管外，还支持将凭据保存在本机：

未登录腾讯云账号时，凭据默认存储在本地，不占用云端托管配额。
已登录且云端配额已满时，可手动选择 本地存储 创建凭据，配额不受限。
本地凭据可随时通过列表中的 上传至云端 迁移到云端（需登录且云端配额充足）。

凭据管理细节请参阅管理登录凭据。

本地直连远程服务器

通过本机 SSH 客户端直连远程服务器（绕过 OrcaTerm 中转），降低延迟、提升传输性能：

适用场景：SSH 协议且使用公网 IP 登录的连接配置、或任意有公网 IP 的自建服务器。
自动启用：满足条件的连接在桌面端登录时自动走本地直连通道，无需额外配置。
SFTP 文件传输：本地直连模式下，文件上传 / 下载直接走本机网络，速度更快。

Important

本地直连要求本机能够直接访问服务器 IP 与端口。若服务器位于内网且本机无法直连，请改用云端中转方式登录。

RDP 虚拟磁盘

客户端的远程桌面（RDP）会话支持挂载本机目录为虚拟磁盘：

挂载：在 RDP 会话的文件管理器面板中点击 挂载虚拟磁盘，选择本机目录。
自动恢复：登录 RDP 后会自动恢复上次挂载的磁盘列表，无需重复挂载。
持久化：挂载列表按实例或 IP 持久化保存，重连后自动恢复。

Note

RDP 虚拟磁盘仅桌面端可用，Web 端 RDP 会话不支持挂载本机目录。

静默自动更新

客户端内置自动更新能力：

启动检查：应用启动时自动检查新版本。
定时检查：每 4 小时定时检查一次。
可见性恢复检查：从后台切回前台、网络恢复时立即触发检查。
静默下载：检测到新版本后在后台静默下载，不打断当前操作。
重启提示：下载完成后弹出提示卡片，点击 重启升级 完成安装并重启。
菜单手动检查：在应用菜单选择 检查更新 可手动触发检查，目前支持MacOS版本。

Note

Windows 端安装新版本时会由 installer 完成替换并自动重启；macOS 端在 install 完成后由应用主动 relaunch。更新失败时会静默记录日志，不影响当前使用。

版本回退（降级）

当服务端发布版本低于本地版本时（如灰度回滚），客户端支持自动降级到服务端发布版本：

桌面端与 Web 端能力对比

能力	Web 端	桌面端
远程服务器连接（TAT / SSH / RDP）	✅	✅
会话管理、分屏、多标签	✅	✅
凭据云端托管	✅	✅
凭据本地存储	❌	✅
本地终端（本机 Shell）	❌	✅
本地直连远程服务器（绕过中转）	❌	✅
RDP 虚拟磁盘挂载	❌	✅
系统级窗口与全屏	❌（仅浏览器全屏）	✅
离线使用	✅ （公网IP服务器SSH、RDP连接）	✅（本地终端 / 本地凭据）
跨设备数据同步	✅（云端）	✅（云端）+ ✅（本地）

Tip

桌面端与 Web 端共享同一套云端数据（连接配置、云端凭据、设置项），登录同一账号即可在两端同步。

常见问题

Windows 安装时提示「SmartScreen 已阻止启动」

点击 更多信息 → 仍要运行 即可继续安装。

命令行安装时 PowerShell 提示「禁止运行脚本」

这是 PowerShell 执行策略限制，不是安装脚本的问题。改用下面这条命令，它只在本次执行时临时放开限制，不会修改系统设置：

powershell -NoProfile -ExecutionPolicy Bypass -Command "iex(irm https://orcaterm.run/scripts/install.ps1)"

公司网络下安装失败

安装包从公网下载，部分企业网络会拦截。请联系网络管理员放行以下域名，或向管理员索取离线安装包：

orcaterm.run
orcaterm-desktop-1258344699.cos.accelerate.myqcloud.com

自动更新失败

检查网络连接是否正常。
若长期无法更新，可前往官网下载最新安装包覆盖安装，配置与数据不受影响。
更新失败详情会写入客户端日志，可在 设置 → 关于 中查看日志或联系支持。

本地终端 Shell 启动失败

在设置中切换默认 Shell 为系统存在的 Shell。
跨设备同步的 Shell 设置可能在当前系统不存在，系统会自动回退到默认 Shell；如仍失败请手动选择。