10 分钟连上第一台机：从注册到在 OpsMate 里打开 SSH 终端

作者： OpsMate 团队
更新于
按当前产品界面整理。请在你有权限的测试机上操作，不要用生产机。

先说清楚三件事：

  1. 请用测试机。 新开一台便宜的 Ubuntu VPS 最好，或者一台挂了也无所谓的机器。别用生产机。
  2. 只支持 SSH 私钥，不支持密码登录。 云厂商开机只给了 root 密码的话，先按下面「准备 2」配一把私钥，大约多花几分钟。
  3. 数据去向： 每次让 AI 帮忙看，终端里最近的输出都会一起发到云端 AI，敏感信息请先去掉。

免费版每月 500 次 AI，服务器不限。

准备（开始计时前做好）

你需要：

准备 1：确认私钥能登录

在你自己的电脑上：

ssh -i ~/.ssh/你的私钥 -p 22 用户名@服务器IP

能登进去，就可以直接开始。

准备 2：只有密码？给这次测试单独生成一把私钥

建议专门为这次测试新生成一把，测完删掉就行，不影响你别的机器：

# 在你自己的电脑上
ssh-keygen -t ed25519 -f ~/.ssh/opsmate_test -C opsmate-test
ssh-copy-id -i ~/.ssh/opsmate_test.pub -p 22 用户名@服务器IP   # 这一步输一次服务器密码
ssh -i ~/.ssh/opsmate_test -p 22 用户名@服务器IP               # 不再要密码，就成功了

第 1 步：打开注册链接，勾选条款

用邀请链接打开（Vincent 发给你的那条，以 https://app.itops.sh/login?screen=register&lang=zh%E2%80%A6 开头）。

  1. 页面先转圈几秒（实测约 6 秒，没有文字，等一下就好）。
  2. 出现「创建免费工作区」。
  3. 勾选「我已阅读并同意 服务条款 与 隐私政策」。不勾的话，注册按钮是灰的。
  4. 点「使用邮箱注册」。

预期结果： 跳到 auth.itops.sh 的注册页。这一页是英文的，样式和刚才不一样，属于正常现象。

耗时：因网络 / 机器而异。

第 2 步：邮箱验证码注册

  1. 填邮箱（这里要再填一次），点 Create account。
    • 这一下可能要等 10 秒以上，页面没有提示（实测约 12 秒）。别重复点。
  2. 去邮箱收 6 位验证码，记得看垃圾箱。
  3. 填验证码，填满第 6 位会自动提交。
  4. 出现 Create a passkey 页面：不需要，点左上角的 Skip 跳过（按钮不显眼）。
  5. 回跳时会白屏几秒。

预期结果： 进入 app.itops.sh/servers，「服务器管理」页，列表是空的，有「添加服务器」按钮。全程不用设密码、用户名、手机号。

耗时：因网络 / 机器而异。

第 3 步：添加服务器

点「添加服务器」，右侧弹出抽屉，分两段。两段是折叠的，同一时间只展开一段，填完第一段要记得点开「SSH 连接」。

基本信息

字段填什么
名称（必填）随便起，比如 test-vps-1
IP 地址（必填）服务器公网 IP
分组（必填）默认已选「默认分组」，不用改
描述可不填

SSH 连接

字段填什么
SSH 用户没有默认值，一定要填，比如 root 或你的 sudo 用户
SSH 端口默认 22
密钥来源选「粘贴或上传新密钥」（新账号第一次一般就是这个）
SSH 密钥粘贴私钥全文，或点「上传私钥文件」选 opsmate_test（没有扩展名也行，别选 .pub）
保存到凭证库的名称填新密钥时必填（界面上没有星号），比如 test-vps-key
密钥密码只有私钥本身设了密码才填，否则留空

点「保存」。

关于私钥存在哪： 在网页控制台添加的 SSH 私钥和密码会加密存储；保存后页面上不会再显示私钥内容，以后加别的机器可以复用。想让凭证默认留在本机，可以用桌面端（预览版，macOS / Linux）。

预期结果： 抽屉关闭，列表里出现这台服务器，卡片上显示「SSH 密钥：已配置」。

耗时：因网络 / 机器而异。

第 4 步：等「发现」扫描跑完

保存后，OpsMate 会自动连上这台机器扫一遍：主机资源和 Docker 容器。

预期结果（到这里就算连上了）： 概览里能看到这台机器的操作系统和 CPU / 内存 / 磁盘数据。

耗时：因网络 / 机器而异。

第 5 步：打开终端，先试一件不改动服务器的事

在服务器卡片上点「终端」，或者「打开服务器」→「SSH 终端」标签页。

AI 助手和 SSH 终端在同一页：AI 在上、终端在下，两块区域的大小可以拖动分割条调整。

先自己敲两条：

uptime
df -h

再用大白话问 AI，比如直接用输入框里的示例：

查看 Docker 容器状态和磁盘占用

或者：

看看这台机器内存和磁盘够不够用，有没有快满的分区

AI 跑的命令会出现在下方的终端里，你能看到它具体跑了什么。

预期结果： 终端里有 uptime、df -h 的输出；AI 给了一段中文结论。

耗时：因网络 / 机器而异。

合计： 因网络 / 机器而异（目标 10 分钟以内；准备 2 生成私钥的时间不算在内）。

常见卡点和解决办法

现象可能原因怎么办
注册页一直转圈首屏加载慢（实测约 6 秒）等 10 秒；还不行就刷新
「使用邮箱注册」点不了没勾条款勾上「我已阅读并同意…」
点了 Create account 没反应后台在处理，最长 10 秒以上没提示别重复点，等一下
收不到验证码进了垃圾箱 / 还没到记得看垃圾箱，等 1 分钟后重发
回跳后出现「Logto login failed」偶发登录回跳问题若出现：回登录页用同一邮箱再登一次；还不行截图发给 Vincent
上传私钥提示「这是公钥文件…」选了 .pub换成同名但没有 .pub 的那个文件
提示「文件内容不像有效的 PEM 私钥」文件不是 OpenSSH / PEM 格式，比如 PuTTY 的 .ppk用 PuTTYgen 导出 OpenSSH 格式，或按「准备 2」新生成一把
保存时提示「请填写凭证名称…」「保存到凭证库的名称」没填随便填一个名字
「发现失败：请检查 SSH 访问与主机 Docker 权限」① IP / 端口 / 用户名填错；② 安全组或防火墙不让公网连 22；③ 公钥没在这个用户的 ~/.ssh/authorized_keys 里；④ 服务器禁止 root 登录（PermitRootLogin no）；⑤ fail2ban 把连接封了在另一个网络（比如手机热点）下用「准备 1」的命令试一下能不能登录，登不进就先修 SSH。非 root 且未加入 docker 组不会导致发现失败，只是看不到容器（见第 4 步）
终端提示「未配置 SSH 密钥…」保存时私钥没带上进服务器详情 →「编辑 SSH / 设置」，重新粘贴私钥
终端「连接失败」同「发现失败」①–⑤同上
AI 提示「AI 请求失败」额度用完或服务出错通用提示为「AI 请求失败」；若带额度购买链，会出现「查看我的订阅」按钮。也可到「我的账号 → 我的订阅」看剩余额度；额度还有的话截图发给 Vincent

测完怎么收尾（可选）

想继续试（不算在 10 分钟里）

加完服务器不会自动开始巡检。要定时巡检，在左侧「监控中心」→「监控任务」里新建任务，再点「启动」或「立即巡检」。开启前请知道：未通过安全检查的命令会被拦截且不会执行。低风险修复默认自动执行，每一步都会记录。所以同样建议只在测试机上开。

桌面端下载：https://www.itops.sh/download/（本篇不写桌面端加机步骤）。

用完请回 Vincent 三件事

  1. 卡在哪一步：哪一步、看到什么提示，有截图最好（截图前把 IP 和密钥遮掉）
  2. 一共花了几分钟：从打开链接到在终端里看到 uptime 的输出
  3. 以后还会不会接着用：会或不会，为什么

请不要把密码、私钥发给任何人，包括我们。

试用

每月免费 500 次 AI 调用，服务器数量不限。桌面端默认把 SSH 凭证保留在本机。

需要帮助理解排查结果？

OpsMate（itops.sh）把 SSH 终端和 AI 放在同一页，由你核对证据。每次让 AI 帮忙看，终端里最近的输出都会一起发到云端 AI，敏感信息请先去掉。

免费开始 本地凭证桌面端

排障指南