opsxshell/homepage/dist/docs/search-data.json

[{"Slug":"overview","Title":"概述","Group":"开始使用","Text":"OpsXShell 是 原生桌面 运维终端：SSH 多标签分屏、SFTP 双栏传输、端口转发、RDP / VNC 远程桌面、串口调试与可选的终端 AI 助手收在同一个窗口里。 它为「一个人日常远程干活」设计——常用流程保持短路径，高级配置默认收起； 不做 堡垒机、审计审批、录像和插件市场。 能力总览 功能域 能做什么 授权 SSH 终端 密码 / 私钥 / SSH Agent 认证，多标签、最多 4 分屏、命令片段、广播输入 免费 SFTP 本地 / 远程双栏，拖拽互传、断点续传、原子替换、远程文本编辑 免费 本地终端 系统 zsh / bash / sh，开箱即用 免费 会话管理 分组、标签、拖拽排序、 导入、 加密清单导出 免费 端口转发 本地 / 远程 / 动态 SOCKS5，规则持久化、运行态不落盘 专业版 远程桌面 RDP / VNC 远程桌面，剪贴板同步、RDP 共享盘 专业版 批量执行 多主机同命令、多屏广播同步输入 专业版 串口终端 波特率 / 数据位 / 停止位 / 校验可调，适配网络设备与开发板 专业版 连接代理 / 跳板 HTTP CONNECT、SOCKS5 代理与跳板机 专业版 终端 AI 助手 自然语言排障：真实取证、五级风险确认、危险命令硬拒绝 专业版 界面提供七种语言（简体 / 繁体中文、English、日本語、한국어、Tiếng Việt、Русский）与深浅色主题。 系统要求与安装 macOS 13+（Apple Silicon） ：从 下载 （约 48 MB），拖入「应用程序」即可。 当前版本未做开发者签名与公证：首次打开请右键点击 →「打开」，或在系统设置中允许。 Windows 与 Linux 内核已具备跨平台设计，安装包将在对应平台实机验收后发布。 安全模型 会话密码、私钥口令、代理密码与 AI API Key 使用 AES 256 GCM 加密落盘；主密钥在 （目录 、文件 ）。 主机指纹走 校验，首次连接确认、变更即告警。 不保存终端命令历史 ；批量结果与 AI 对话只保留在当前窗口。 转发、RDP / VNC 的运行态只在原生内存中，断开即清理；界面的「停止」关闭的是真实原生资源。 授权形态 下载即含 30 天专业版全功能试用 （首次启动自动开始，无需注册）。试用结束后免费层继续可用；专业版按包年（¥99 / 2 台设备）或永久买断（¥199 / 5 台设备）授权，详见 与 。 下一步 五分钟连上第一台服务器： 想了解 AI 如何在终端里安全干活： 购买与激活疑问："},{"Slug":"quickstart","Title":"快速上手","Group":"开始使用","Text":"从下载到连上第一台服务器，通常不超过五分钟。 1. 安装（macOS） 从 下载 ，打开后把 OpsXShell 拖到「应用程序」。 当前版本未做开发者签名与公证，首次打开若被 Gatekeeper 拦截：右键点击 →「打开」→ 再点「打开」；或在「系统设置 → 隐私与安全性」中点「仍要打开」。 首次启动会： 按系统语言选择界面语言（之后可在设置中切换七语种）； 自动开始 30 天专业版全功能试用 ——无需注册、无需信用卡； 生成 本地加密主密钥，用于加密保存的凭据。 2. 快速连接一台主机 按 打开快速连接，输入： 默认端口 。首次连接会要求确认主机指纹（写入 ），之后指纹变更会告警。快速连接适合临时使用，不会自动保存会话。 也可以直接点击系统中的深链，唤起已填好目标的快速连接窗口： 链接中禁止携带密码、远程路径等参数，且连接前需要你手动确认——网页无法静默连上陌生服务器。 3. 保存会话，长期使用 在会话侧栏「新建会话」： 认证方式选密码或私钥；留空时会自动尝试本机 SSH Agent 与常见默认密钥（ 等）。 按需设置分组、标签和启动命令。 密码与私钥口令保存前经 AES 256 GCM 加密，也可完全不保存密码。 已有大量主机？用「文件 → 导入会话」直接读 ，支持 / / / / / 单个 。详见 。 4. 界面速览 左侧会话侧栏 ：分组、搜索、批量多选； 折叠。 中央工作区 ：多标签终端， 分屏，SFTP 双栏与远程桌面也是标签页。 状态栏「转发」 ：SSH 连上后在这里管理本地 / 远程 / SOCKS5 转发（专业版）。 终端工具栏「AI 助手」 ：当前连接上的自然语言排障入口（专业版）。 5. 常用快捷键 快捷键 作用 快速连接 折叠 / 展开会话侧栏 分屏当前终端 关闭当前标签 下一步 管理几十台主机： 多机批量操作与广播输入： 传文件："},{"Slug":"sessions","Title":"会话与主机管理","Group":"开始使用","Text":"从几台到上百台主机：分组、排序、导入导出与连接路径管理。 分组与排序 侧边栏按分组组织主机；分组内可上下 拖拽 调整顺序，拖到另一分组标题上会放到该组末尾，展开后也可以直接插到某台主机的上方或下方。 分组标题右键 →「按名称排序」可一次性重排。 顺序会保存；新建的主机排在组末尾。搜索过滤和批量多选模式下暂不可拖拽。 认证方式 方式 说明 密码 保存前经 AES 256 GCM 加密落盘，也可选择不保存、每次输入 私钥 支持口令；未填口令时尝试常见默认密钥 SSH Agent 本机 agent 自动尝试；完全可以做到「客户端不存任何密码」 主机指纹统一走 ：首次连接确认，之后变更即告警，不静默接受陌生主机。 代理与跳板（专业版） 会话的高级选项支持： HTTP CONNECT 代理 SOCKS5 代理（可带用户名 / 密码） 选择一个已保存会话作为 跳板机 代理与跳板互斥——选择其中一个会清除另一个，避免连接路径含糊。界面保持单跳操作；导入的配置文件中最多可识别 8 层跳板链。 导入 OpenSSH 配置 「文件 → 导入会话」读取 ，当前解析 、 、 、 、 与单个 别名。 包含 、 或 的 Host 模式不会生成会话。导入后请检查目标、用户名、密钥路径和跳板关系再连接。 主机清单导出（专业版） 会话导出保存为 ——密码加密的主机清单，格式定位类似 KeePass 、MobaXterm ： 导出包含主机分组、密钥和密码， 务必保管备份密码 。 旧版 备份与 OpenSSH 仍可作为导入源。 深链唤起 安装版注册了系统链接，浏览器或文档中的： 会唤起 OpsXShell 并打开已填好目标的快速连接窗口。链接中禁止携带密码、远程路径、查询参数或片段；为防网页静默连接陌生服务器，仍需用户确认后才连接。"},{"Slug":"terminal","Title":"终端与批量执行","Group":"功能指南","Text":"多标签、分屏、广播与多主机批量命令——一个窗口干完日常远程操作。 日常工作区一屏可见：会话栏分组管理主机，双击即连；SSH 终端与 SFTP 共用同一条连接，互不影响。 标签与分屏 分屏当前终端，最多 4 分屏； 关闭当前标签。 终端 右键菜单 ：复制、粘贴、全选、清屏、向右 / 向下分屏、最大化 / 恢复、关闭当前分屏。 没有选区时「复制」保持禁用——不会一次右键就把剪贴板粘进 Shell。 广播输入 工具栏「广播」作用于 所有已打开且已连接的 SSH 终端标签和分屏 ，按钮实时显示目标数；敲一遍、处处生效。 本地 Shell 不加入远程广播；远程桌面会话也不参与。 目标不足两个时广播自动关闭。 适合多机同步改配置、批量重启服务等场景。 批量命令（专业版） 会话侧栏进入 批量模式 后，可以： 同时打开多台主机的终端或 SFTP； 在多个主机执行 同一条命令 。 批量命令弹框中可再次搜索、全选或调整主机；执行区逐主机显示连接 / 运行状态、输出、耗时与总进度。 结果只保留在当前弹窗。OpsXShell 不持久化终端命令历史。 连接保活与重连 默认对齐常见 SSH / RDP 客户端，分三层——「窗口还开着」不等于无视服务器超时： 层 行为 链路心跳 空闲时发 SSH 协议 keep alive（不向 Shell 灌回车空格）。挡 NAT / 防火墙丢空闲 TCP，挡不住 Bash 意外断线重连 终端、SFTP 或远程桌面标签还开着时，有限次自动重连。SSH 重连后是新 Shell；SFTP 回到断线前的远程目录 会话策略 远端 / 只关掉那一格 Shell；尊重服务器，客户端不伪造按键 设置里的「保持心跳」和「自动重连」对应前两层。 长任务建议在服务器上跑 / ，客户端重连后 attach 即可。 遇到 远端 Bash 因 超时会退出 那一格 Shell ：SSH 连接、其他分屏、SFTP 和隧道仍然可用，点击「重新打开 Shell」即可继续。"},{"Slug":"sftp","Title":"SFTP 文件传输","Group":"功能指南","Text":"本地 / 远程双栏文件管理器：拖拽互传、断点续传、失败不伪装成功。 SSH 连上后打开 SFTP 标签即是双栏视图：左边自己电脑、右边远程服务器，选中文件点中间箭头即可互传，也可以直接左右拖拽。 基本操作 SSH 连接后即可打开 SFTP 标签，左栏为本机、右栏为远程： 上传 ：左侧选中文件后点中间「上传」箭头；未选择文件时会打开系统文件选择器。 下载 ：右侧选中远程文件后点中间「下载」箭头。 文件右键菜单同样提供「上传」「下载」。 支持 拖拽 ：本地文件拖到远程栏即上传，远程文件拖到本地栏即下载；拖到目录行时以该目录为目标并显示落点高亮。系统未提供拖拽路径时（如某些网络卷），改用中间箭头或文件选择器。 当前拖拽只支持单个文件，不递归传输目录；同侧拖拽不会执行移动或重命名。 断点续传与原子替换 上传和下载先写入 临时文件： 传输中断后，再次传输 同一路径 会从已有字节继续。 传输完成并通过大小校验后才替换正式文件——失败传输不会伪装成完整文件。 目标已存在同名项时询问「覆盖」或「跳过」；失败或取消的任务可在传输队列一键重试。 远程文本编辑 双击远程文本文件直接读写远程文件， 不会 在本地创建同名文件，也不等同于上传 / 下载： 可编辑类型按扩展名排除归档 / 二进制。 单文件约 2 MB 上限；超限、二进制或非 UTF 8 会提示并拒绝打开，请下载后用本地编辑器处理。 重命名与权限 右键菜单支持远程文件重命名与权限（chmod）修改。 断线行为 SSH 断线后，SFTP 按与终端相同的有限次自动重连，并优先回到断线前的远程目录；进行中的传输会标为失败、可重试。也可一键手动重连。刷新时状态栏显示「正在刷新…」，传输忙时浏览类操作立即返回忙提示而不是卡住界面。 当前目标文件采用覆盖语义；内容哈希校验与显式冲突选择在路线图中。"},{"Slug":"forwarding","Title":"端口转发与 SOCKS5","Group":"功能指南","Text":"SSH 连上后，状态栏点击「转发」打开右侧抽屉，统一管理本地转发、远程转发与动态 SOCKS5（专业版）。 每条规则独立启停：本地转发把远程服务映射到本机端口，动态转发让本机流量经 SSH 服务器出口。 动态转发（SOCKS5） 本机成为 SOCKS5 代理，流量经当前 SSH 服务器出口 IP 访问外网： 每台 SSH 主机仅一条动态规则，端口固定 ，抽屉中直接启停。 状态栏「转发」右键可复制代理地址。 需要远程 DNS 解析的命令行工具用 ： SOCKS5 默认仅监听本机；当前不提供局域网开放和客户端密码认证。 本地转发（ ） 本机监听默认只需填端口（绑定 ，等同 ）；需要局域网访问时再展开高级项改为内网 IP 或 。 目标主机 相对当前 SSH 服务器 （常用 或内网 IP），不是会话页的主机名，且不能填 。 远程转发（ ） 远端监听填： ——仅 SSH 服务器本机可访问； ——远端内网其它主机也可访问（需 sshd 或 ）。 目标为本机或内网 （不能填 ）。服务器还需 或 ；监听端口不能已被占用， 通常需要 root。可用 对照理解。 规则与运行态 保存的是规则，不是「运行中」状态 ：应用重启后需要再次手动启动。 「复制规则」创建独立新规则，便于只改端口或目标；不复制运行状态。 运行中的规则选「编辑」时，会先提示停止真实监听，再允许保存新配置。 同一窗口内只要没点「停止」，SSH 断线、保活失败、空闲挂起或重连都会继续监听（本地 / SOCKS 端口不拆，远程转发自动重听）。 点停止、关闭标签、连接面板手动断开或退出应用，才会关闭真实 Listener。关闭标签后再开同一会话不会自动拉起转发。 「停止」真正关闭端口监听，不是只改界面图标。"},{"Slug":"remote-desktop","Title":"远程桌面 RDP / VNC","Group":"功能指南","Text":"欢迎页或会话入口可打开 RDP / VNC 连接对话框（仅原生桌面应用，专业版）。 RDP 填写主机、端口、用户名、密码与可选域名： 远程画面在独立标签页中原生显示，键鼠操作即时响应，流畅得像坐在那台电脑前。 支持 剪贴板同步 与 共享盘 ：本机下载目录映射为远端共享盘，往里放文件即传到本机。 画面铺满当前窗口（任务栏贴底）；拖动改变窗口大小后，远程分辨率会自动跟随调整。 连接 Windows 的实际效果：会话栏在左，远程桌面独立成标签；资源管理器左侧可见映射进来的本机共享盘。 VNC 填写主机、端口与可选密码；本机复制的文字可直接粘贴到远程，中文内容也正常。 连接 Linux 服务器的实际效果：远程桌面在独立标签页中打开，与 SSH、SFTP 标签并列，互不干扰。 标签与重连 连接后在独立标签中显示画面，工具栏提供剪贴板、共享盘（RDP）与重连入口。 标签还开着时网络闪断会 有限次自动重连 ——重连是新会话，不对抗服务器空闲注销策略，也不伪造鼠标移动。 桌面会话 不参与 批量命令与终端广播。 安全边界 断开连接或关闭标签后，远程会话立即结束并清理干净，不在后台残留进程；界面的「停止」关闭的是真实的远程连接。"},{"Slug":"serial","Title":"本地终端与串口","Group":"功能指南","Text":"不连远程也能用：本地 Shell 开箱即用，串口终端适配网络设备与开发板调试。 本地终端（免费） 快速启动入口可打开系统默认 Shell（zsh / bash / sh），开箱即用： 与 SSH 终端共用同一套多标签、分屏与快捷键。 本地 Shell 不加入远程广播，也不会被批量命令波及。 串口终端（专业版） 串口入口会列出系统设备，适配路由器、交换机与开发板调试。连接前可设置： 波特率 数据位 停止位 校验方式 选择设备与参数后即可连接终端设备。"},{"Slug":"ai","Title":"终端 AI 助手","Group":"功能指南","Text":"自然语言描述任务，AI 在 当前 SSH 连接 上真实取证、给出有证据的结论——执行权始终在你手里（专业版）。 配置模型供应商 在「设置 → 大模型」中添加 Provider。内置预设：DeepSeek、Z.AI/GLM、MiniMax、Kimi、Qwen、OpenAI、Anthropic、OpenRouter、Ollama、new api，也可以从空白配置开始： 1. 选供应商预设或「自定义」；新配置只在当前表单暂存。 2. 选模型、核对 Endpoint、输入 API Key；协议与 HTTP 开关在收起的「高级设置」里。 3. 点「测试连接」——应用会用 当前表单里填写的 凭据向目标模型发一条「你是什么模型？请简短回答。」，但不会保存任何内容；只有返回成功且回答非空才显示 。 4. 测试成功后「保存」才可用；Endpoint、模型、协议或凭据一变，测试结果立即失效。 5. 保存后 API Key 加密存放在本机，设置文件中不含明文，界面也不回显。 new api、One API、OpenRouter 等网关用「自定义」或相应预设，填自己的 Endpoint 与实际模型 ID。 在终端里用 终端工具栏点「AI 助手」打开 Agent 面板： 直接输入任务，例如「排查 nginx 为什么启动失败并修复」。回车发送， 换行。 有终端 选区 时会作为初始上下文；没有选区不抓整屏，Agent 通过真实 SSH 执行自主取证。 Agent 最多执行 12 步 ，每步一条单行命令；界面显示当前主机、命令与风险等级。 执行后的真实输出和退出码回给 AI 判断下一步；连续失败会被要求换方法；相同命令第 3 次会在执行前拦截。 长输出会自动提取错误要点并保留首尾，控制上下文长度。 风险分级与确认 等级 示例 严格模式 宽松模式（默认） safe 、 自动执行 自动执行 low 未知自定义查询命令 自动执行 自动执行 medium 文件写入、普通权限变更 先确认 自动执行 high 服务重启、删除、包安装、K8s 变更 先确认 先确认 critical 格式化磁盘、删除根目录、fork bomb 硬拒绝 硬拒绝 安全模式在任务开始时锁定，运行中不能切换。 critical 永远硬拒绝 ：界面拦一次，命令执行前底层再拦一次，双保险，不存在「确认放行」。 需要确认时，对话框显示本次锁定的模式、目标主机、风险与完整命令，由你选择：拒绝 / 只插入不执行 / 本次执行。 隐私与数据边界 云模型会把所选上下文发给相应供应商； 发送前自动脱敏 常见敏感信息（密码、Token、Authorization Header、AWS Key、私钥块）。有严格数据边界时用本机 Ollama，并仅在可信本机上开启 HTTP。 关闭面板后任务、命令、工具输出和回答 全部清空 ，不写入历史——OpsXShell 不保存 AI 对话、终端上下文或长期记忆。 终端输出被标记为不可信数据：日志里出现的「忽略规则」之类文字不会变成指令。 不提供独立的 podexec；远端已有的 、 、 都通过同一条 SSH 执行链使用。"},{"Slug":"license","Title":"授权与激活","Group":"授权与帮助","Text":"购买、激活、换机、断网——一次说清。定价与让利见 ，激活细节见 。 试用与免费层 下载即含 30 天专业版全功能试用 ：首次启动自动开始，无需注册、无需信用卡。 试用结束后免费层继续可用：SSH 终端、SFTP、本地终端与会话管理。 授权只控制专业功能开关，本机会话、配置等数据不做任何改动。 两种授权码 对比项 在线授权码 离线许可证 联网要求 激活时联网一次，之后每 7 天校验 全程无需联网，本地验证许可证签名 断网容忍 激活后可连续离线 30 天 始终有效，与网络无关 换绑 应用内自助解绑，每年免费 2 次 邮件换取新证并解绑旧设备 适合场景 办公网、云主机、个人电脑 生产内网、专有云、隔离环境 客户端只与授权服务器 （443）通信，只发送授权码与设备标识（设备 ID、设备名称），不发送主机地址、账号、命令与会话内容。 激活步骤 1. 收到授权码邮件（ 前缀在线码，或 前缀离线证）。 2. 打开「设置 → 授权」，粘贴授权码，点激活。 3. 在线码会连接授权服务器登记本机设备并回写激活令牌；离线证本地验签即完成。 换机与重装 旧机还在 ：「设置 → 授权」点解绑，腾出席位后在新机激活。 旧机已不在手 ：邮件附授权码后四位与新设备 ID，由作者在授权后台释放旧设备。 每年免费换绑 2 次；重装系统前建议先解绑。 常见授权状态 授权服务器不可达 ：按宽限期继续可用，业务不中断；恢复网络后自动补校验。 到期提醒 ：包年到期前 30 天邮件提醒；续期后新授权码直接替换旧码，同机无需解绑。 激活失败 ：先看「设置 → 授权」的状态与到期时间；常见原因是设备数已占满或授权码输漏字符，把授权码后四位、设备 ID 与报错截图发邮件即可核对处理。"},{"Slug":"faq","Title":"常见问题","Group":"授权与帮助","Text":"按主题归类的高频问题，没找到答案可以邮件咨询。 数据与安全 OpsXShell 会保存我的 SSH 密码吗？ 保存的密码、私钥口令经 AES 256 GCM 加密后存在本机应用数据目录，主密钥单独放在 （目录 / 文件 ），不上传任何凭据；也支持 SSH Agent 认证做到完全不保存密码。 数据保存在哪里？ 会话与设置保存在系统应用数据目录的 ；终端标签布局持久化，但连接、转发、远程桌面等运行态只在内存，应用重启后按需重连。「设置 → 关于」会显示当前系统的实际数据路径。 不保存命令历史是真的吗？ 真的。终端命令不落盘；批量命令结果只保留在当前弹窗；AI 对话与工具输出关闭面板即清空。 平台与兼容 支持 Windows / Linux 吗？ OpsXShell 面向 macOS / Windows / Linux 三平台设计；安装包按「目标系统实机构建并验收」的原则发布。当前提供 macOS Apple Silicon 包，Windows 与 Linux 版在对应平台完成实机验收后上线。 支持 和跳板机吗？ 支持导入 常用字段（详见 ）；SSH 代理与跳板属于专业版能力。 功能细节 SSH 断线后会怎样？ 终端 / SFTP / 远程桌面标签还开着时有限次自动重连；SSH 重连后是新 Shell（长任务请在服务器上用 / ），SFTP 会回到断线前的远程目录。详见 。 SOCKS5 转发能给别人用吗？ 默认只监听 ，当前不提供局域网开放与客户端密码认证。远程 DNS 解析请用 ，详见 。 AI 会自动执行命令吗？ 默认宽松模式仅高风险命令需确认；严格模式从中风险开始。格式化磁盘等 critical 命令无论什么模式都直接拒绝，命令执行前底层还会再拦一次。详见 。 购买与授权 免费版和专业版差在哪？ 免费版含 SSH 终端、SFTP、本地终端与会话管理；专业版解锁端口转发、连接代理 / 跳板、终端 AI、批量执行 / 广播、RDP / VNC、串口与主机清单导出。完整对比见 。 怎么购买？ 邮件咨询购买（注明 OpsXShell），支持对公转账与开票，当天回复；支付后当场发放授权码（ ），粘贴到「设置 → 授权」即完成激活。退款政策：付款起 30 天内无理由全额退款。 三个产品要分别买吗？ OpsXShell / OpsxDB / OpsxAPI 独立授权、独立计价，共用同一套设备 ID 与授权服务器；多产品组合、团队或教育用途可邮件说明需求议价。"}]