Logan.Li
3acfb27521
CI / Lint & TypeCheck (push) Canceled after 0s
CI / Test (push) Canceled after 0s
CI / Tauri Foundation Acceptance (push) Canceled after 0s
CI / Build (macos-latest) (push) Canceled after 0s
CI / Build (ubuntu-latest) (push) Canceled after 0s
CI / Build (windows-latest) (push) Canceled after 0s
连接类功能（终端/SFTP/RDP·VNC）先讲，网络打通（转发）后讲，更符合新用户动线
181 lines
8.7 KiB
HTML
181 lines
8.7 KiB
HTML
<!doctype html>
|
||
<html lang="zh-CN">
|
||
<head>
|
||
<meta charset="utf-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||
<title>快速上手 · OpsXShell 文档</title>
|
||
<meta name="description" content="OpsXShell 运维终端用户文档 — SSH、SFTP、端口转发、RDP/VNC、串口与终端 AI。">
|
||
<link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2064%2064%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%2264%22%20y2%3D%2264%22%20gradientUnits%3D%22userSpaceOnUse%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22%232563EB%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22%2306B6D4%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%2264%22%20height%3D%2264%22%20rx%3D%2214%22%20fill%3D%22url(%23g)%22%2F%3E%3Cg%20stroke%3D%22%23fff%22%20stroke-width%3D%225%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%20fill%3D%22none%22%3E%3Cpath%20d%3D%22M17%2025h26%22%2F%3E%3Cpath%20d%3D%22M37%2019l6%206-6%206%22%2F%3E%3Cpath%20d%3D%22M47%2039H21%22%2F%3E%3Cpath%20d%3D%22M27%2033l-6%206%206%206%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E">
|
||
<link rel="stylesheet" href="/docs/assets/docs.css">
|
||
</head>
|
||
<body>
|
||
<svg xmlns="http://www.w3.org/2000/svg" style="display:none" aria-hidden="true">
|
||
<symbol id="i-menu" viewBox="0 0 24 24"><path d="M4 5h16" /> <path d="M4 12h16" /> <path d="M4 19h16" /></symbol>
|
||
<symbol id="i-search" viewBox="0 0 24 24"><path d="m21 21-4.34-4.34" /> <circle cx="11" cy="11" r="8" /></symbol>
|
||
</svg>
|
||
<header class="topbar">
|
||
<div class="topbar-inner">
|
||
<button class="menu-btn" id="menu-btn" aria-label="打开导航"><svg class="i"><use href="#i-menu"/></svg></button>
|
||
<a class="brand" href="/docs">
|
||
<span class="brand-logo"><svg width="28" height="28" viewBox="0 0 64 64" aria-label="OpsXShell"><defs><linearGradient id="lg-docs" x1="0" y1="0" x2="64" y2="64" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#2563EB"/><stop offset="1" stop-color="#06B6D4"/></linearGradient></defs><rect width="64" height="64" rx="14" fill="url(#lg-docs)"/><g stroke="#fff" stroke-width="5" stroke-linecap="round" stroke-linejoin="round" fill="none"><path d="M17 25h26"/><path d="M37 19l6 6-6 6"/><path d="M47 39H21"/><path d="M27 33l-6 6 6 6"/></g></svg></span>
|
||
<span class="brand-name">OpsXShell <em>文档</em></span>
|
||
</a>
|
||
<span class="ver-badge">v2.1.1</span>
|
||
<div class="search">
|
||
<input id="search-input" type="search" placeholder="搜索文档…" autocomplete="off" spellcheck="false">
|
||
<div class="search-panel" id="search-panel" hidden></div>
|
||
</div>
|
||
<nav class="top-links">
|
||
<a href="/">官网</a>
|
||
<a href="/#download">下载</a>
|
||
</nav>
|
||
</div>
|
||
</header>
|
||
|
||
<div class="layout" id="layout">
|
||
<aside class="sidebar" id="sidebar">
|
||
|
||
<div class="nav-group">
|
||
<div class="nav-group-title">开始使用</div>
|
||
|
||
<a class="nav-link" href="/docs/overview">概述</a>
|
||
|
||
<a class="nav-link active" href="/docs/quickstart">快速上手</a>
|
||
|
||
<a class="nav-link" href="/docs/sessions">会话与主机管理</a>
|
||
|
||
</div>
|
||
|
||
<div class="nav-group">
|
||
<div class="nav-group-title">功能指南</div>
|
||
|
||
<a class="nav-link" href="/docs/terminal">终端与批量执行</a>
|
||
|
||
<a class="nav-link" href="/docs/sftp">SFTP 文件传输</a>
|
||
|
||
<a class="nav-link" href="/docs/remote-desktop">远程桌面 RDP / VNC</a>
|
||
|
||
<a class="nav-link" href="/docs/forwarding">端口转发与 SOCKS5</a>
|
||
|
||
<a class="nav-link" href="/docs/serial">本地终端与串口</a>
|
||
|
||
<a class="nav-link" href="/docs/ai">终端 AI 助手</a>
|
||
|
||
</div>
|
||
|
||
<div class="nav-group">
|
||
<div class="nav-group-title">授权与帮助</div>
|
||
|
||
<a class="nav-link" href="/docs/license">授权与激活</a>
|
||
|
||
<a class="nav-link" href="/docs/faq">常见问题</a>
|
||
|
||
</div>
|
||
|
||
<div class="sidebar-foot">© 2026 OpsXShell · 本地优先的运维终端</div>
|
||
</aside>
|
||
|
||
<main class="content">
|
||
<div class="breadcrumb">文档 <span>/</span> 开始使用 <span>/</span> 快速上手</div>
|
||
<h1 class="page-title">快速上手</h1>
|
||
<div class="page-meta">更新于 2026-10-16</div>
|
||
<article class="md">
|
||
<p>从下载到连上第一台服务器，通常不超过五分钟。</p>
|
||
<h2 id="sec-1">1. 安装（macOS）</h2>
|
||
<p>从<a href="/#download">官网下载区</a>下载 <code>.dmg</code>，打开后把 OpsXShell 拖到「应用程序」。</p>
|
||
<p>当前版本未做开发者签名与公证，首次打开若被 Gatekeeper 拦截：右键点击 <code>.app</code> →「打开」→ 再点「打开」；或在「系统设置 → 隐私与安全性」中点「仍要打开」。</p>
|
||
<p>首次启动会：</p>
|
||
<ul>
|
||
<li>按系统语言选择界面语言（之后可在设置中切换七语种）；</li>
|
||
<li>自动开始 <strong>30 天专业版全功能试用</strong>——无需注册、无需信用卡；</li>
|
||
<li>生成 <code>~/.opsxshell/master.key</code> 本地加密主密钥，用于加密保存的凭据。</li>
|
||
</ul>
|
||
<h2 id="sec-2">2. 快速连接一台主机</h2>
|
||
<p>按 <code>Cmd/Ctrl + K</code> 打开快速连接，输入：</p>
|
||
<pre><code class="language-text">user@host
|
||
user@host:2222
|
||
</code></pre>
|
||
<p>默认端口 <code>22</code>。首次连接会要求确认主机指纹（写入 <code>~/.ssh/known_hosts</code>），之后指纹变更会告警。快速连接适合临时使用，不会自动保存会话。</p>
|
||
<p>也可以直接点击系统中的深链，唤起已填好目标的快速连接窗口：</p>
|
||
<pre><code class="language-text">ssh://root@opsbase.cn:55555
|
||
</code></pre>
|
||
<p>链接中禁止携带密码、远程路径等参数，且连接前需要你手动确认——网页无法静默连上陌生服务器。</p>
|
||
<h2 id="sec-3">3. 保存会话，长期使用</h2>
|
||
<p>在会话侧栏「新建会话」：</p>
|
||
<ul>
|
||
<li>认证方式选密码或私钥；留空时会自动尝试本机 SSH Agent 与常见默认密钥（<code>~/.ssh/id_ed25519</code> 等）。</li>
|
||
<li>按需设置分组、标签和启动命令。</li>
|
||
<li>密码与私钥口令保存前经 AES-256-GCM 加密，也可完全不保存密码。</li>
|
||
</ul>
|
||
<p>已有大量主机？用「文件 → 导入会话」直接读 <code>~/.ssh/config</code>，支持 <code>Host</code> / <code>HostName</code> / <code>User</code> / <code>Port</code> / <code>IdentityFile</code> / 单个 <code>ProxyJump</code>。详见<a href="/docs/sessions">会话与主机管理</a>。</p>
|
||
<h2 id="sec-4">4. 界面速览</h2>
|
||
<ul>
|
||
<li><strong>左侧会话侧栏</strong>：分组、搜索、批量多选；<code>Cmd/Ctrl + B</code> 折叠。</li>
|
||
<li><strong>中央工作区</strong>：多标签终端，<code>Cmd/Ctrl + D</code> 分屏，SFTP 双栏与远程桌面也是标签页。</li>
|
||
<li><strong>状态栏「转发」</strong>：SSH 连上后在这里管理本地 / 远程 / SOCKS5 转发（专业版）。</li>
|
||
<li><strong>终端工具栏「AI 助手」</strong>：当前连接上的自然语言排障入口（专业版）。</li>
|
||
</ul>
|
||
<h2 id="sec-5">5. 常用快捷键</h2>
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th>快捷键</th>
|
||
<th>作用</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><code>Cmd/Ctrl + K</code></td>
|
||
<td>快速连接</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>Cmd/Ctrl + B</code></td>
|
||
<td>折叠 / 展开会话侧栏</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>Cmd/Ctrl + D</code></td>
|
||
<td>分屏当前终端</td>
|
||
</tr>
|
||
<tr>
|
||
<td><code>Cmd/Ctrl + W</code></td>
|
||
<td>关闭当前标签</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<h2 id="sec-6">下一步</h2>
|
||
<ul>
|
||
<li>管理几十台主机：<a href="/docs/sessions">会话与主机管理</a></li>
|
||
<li>多机批量操作与广播输入：<a href="/docs/terminal">终端与批量执行</a></li>
|
||
<li>传文件：<a href="/docs/sftp">SFTP 文件传输</a></li>
|
||
</ul>
|
||
|
||
</article>
|
||
|
||
<div class="pn-nav">
|
||
|
||
<a class="pn prev" href="/docs/overview"><span class="pn-label">← 上一页</span><span class="pn-title">概述</span></a>
|
||
|
||
|
||
<a class="pn next" href="/docs/sessions"><span class="pn-label">下一页 →</span><span class="pn-title">会话与主机管理</span></a>
|
||
|
||
</div>
|
||
</main>
|
||
|
||
<aside class="toc">
|
||
<div class="toc-title">本页目录</div>
|
||
<nav class="toc-nav">
|
||
<a class="toc-l2" href="#sec-1">1. 安装（macOS）</a>
|
||
<a class="toc-l2" href="#sec-2">2. 快速连接一台主机</a>
|
||
<a class="toc-l2" href="#sec-3">3. 保存会话，长期使用</a>
|
||
<a class="toc-l2" href="#sec-4">4. 界面速览</a>
|
||
<a class="toc-l2" href="#sec-5">5. 常用快捷键</a>
|
||
<a class="toc-l2" href="#sec-6">下一步</a>
|
||
|
||
</nav>
|
||
</aside>
|
||
</div>
|
||
|
||
<script src="/docs/assets/docs.js" defer></script>
|
||
</body>
|
||
</html>
|