@zicolasjac-ai/remote-readonly-ssh 1.2.1 → 1.3.0

package/README.md

@@ -75,7 +75,7 @@ rrs <tool> [arg] [--host <ip>] [--config <file>] [--json]
 
 | 键 | 说明 |
 |-----|------|
-| `auth_profiles` | **认证组**（可多个）：`{组名: {host, port, username, auth}}`。`auth.mode` 支持 `key`（`private_key_path` 必填，可选 `private_key_passphrase`）与 `password`（`password` 必填）。`list-tools` 只显示模式与主机，不显示任何凭据 |
+| `auth_profiles` | **认证组**（可多个）：`{组名: {host, port, username, auth, direct?}}`。`auth.mode` 支持 `key`（`private_key_path` 必填，可选 `private_key_passphrase`）与 `password`（`password` 必填）。`direct: true` 表示**直连裸机**（跳过堡垒机菜单，适合无堡垒机的服务器；命令只读校验与堡垒机模式完全一致）。`list-tools` 只显示模式与主机，不显示任何凭据 |
 | `target_hosts` | 目标主机白名单 `{ip: {profile, keyword?}}`：`profile` 引用认证组名，`keyword` 为堡垒机资产搜索关键字（缺省用 IP）。**多台主机可共用同一认证组（N:1）** |
 | `audit` | `enabled`（默认 true，关闭则不留痕）与 `include_output`（默认 false，true 时把命令输出摘要写入审计日志） |
 | `allowed_version_bins` | 允许执行 `-v/-V` 的二进制白名单 |
@@ -137,6 +137,7 @@ npm test          # 运行单元测试（node --test）
 - **主机白名单**：未登记 IP 一律拒绝。
 - **主机密钥 TOFU**：堡垒机公钥指纹首见记录（`~/.rrs/known_hosts.json`）、每次连接比对，变化即拒绝（防中间人窃取凭据/会话）；连接错误消息中的凭据类内容自动脱敏。
 - **凭据不落命令行**：认证走 ssh2 库内存参数，密码/私钥不出现在进程参数与环境变量中；审计日志只记命令，不含凭据。
+- **直连模式同样受只读强制**：`direct: true` 仅跳过堡垒机菜单选资产环节，命令前缀白名单 / 禁止模式 / 路径黑名单 / 主机白名单 / 审计 / TOFU 对直连主机完全等效——防护不依赖堡垒机这道外部闸门。
 - **无写原语**：工具集中不存在任何写操作路径；写操作由人工执行，本工具只读。
 
 **已知边界**（设计取舍）：

package/bin/rrs.js

@@ -184,7 +184,7 @@ function listTools(conf) {
   };
   for (const [k, v] of Object.entries(tools)) console.log(`  ${k.padEnd(20)} ${v}`);
   const profiles = conf.auth_profiles || {};
-  console.log(`\n认证组: ${Object.entries(profiles).map(([id, p]) => `${id}(${p.auth.mode}@${p.host})`).join(", ") || "(无)"}`);
+  console.log(`\n认证组: ${Object.entries(profiles).map(([id, p]) => `${id}(${p.auth.mode}@${p.host}${p.direct ? ",direct" : ""})`).join(", ") || "(无)"}`);
   console.log(`允许主机: ${Object.keys(conf.target_hosts || {}).join(", ")}`);
   console.log(`允许查版本: ${(conf.allowed_version_bins || []).join(", ")}`);
   console.log(`允许读路径前缀: ${(conf.allowed_path_prefixes || []).join(", ")}`);

package/config.example.json

@@ -18,6 +18,16 @@
         "mode": "password",
         "password": "YOUR_PASSWORD"
       }
+    },
+    "profile_direct": {
+      "host": "YOUR_DIRECT_SERVER_IP",
+      "port": 22,
+      "username": "YOUR_USERNAME_3",
+      "direct": true,
+      "auth": {
+        "mode": "password",
+        "password": "YOUR_PASSWORD_2"
+      }
     }
   },
   "target_hosts": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zicolasjac-ai/remote-readonly-ssh",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "只读 SSH 运维 CLI 与 Agent Skill：通过 JumpServer 堡垒机白名单强制执行只读查询；认证组支持 SSH 私钥/密码两种模式与按 IP 分组；附 SKILL.md 让 opencode / Claude Code / Cursor 等 AI 助手自动发现并正确调用。",
   "license": "MIT",
   "bin": {

package/skills/remote-readonly-ssh/SKILL.md

@@ -32,7 +32,8 @@ metadata:
 ```bash
 npm install -g @zicolasjac-ai/remote-readonly-ssh
 rrs init          # 生成配置模板 ~/.rrs/config.json
-# 编辑配置: auth_profiles（认证组，key/password 两种模式，可多个）/ target_hosts（IP → 认证组+搜索关键字，多 IP 可共用一组）
+# 编辑配置: auth_profiles（认证组，key/password 两种模式，可多个；direct:true 表示跳过堡垒机菜单直连裸机）
+#           target_hosts（IP → 认证组+搜索关键字，多 IP 可共用一组）
 rrs setup skills  # 把本 skill 安装到 opencode / claude / agents 等目录
 ```
 

package/src/config.js

@@ -60,6 +60,9 @@ function validateConfig(conf) {
       }
       if (!p.host || typeof p.host !== "string") errors.push(`认证组 [${id}] 缺少 host`);
       if (!p.username || typeof p.username !== "string") errors.push(`认证组 [${id}] 缺少 username`);
+      if (p.direct !== undefined && typeof p.direct !== "boolean") {
+        errors.push(`认证组 [${id}] direct 必须是布尔值（true=跳过堡垒机菜单直连）`);
+      }
       if (p.port !== undefined && (!Number.isInteger(p.port) || p.port < 1 || p.port > 65535)) {
         errors.push(`认证组 [${id}] port 必须是 1-65535 的整数，当前: ${p.port}`);
       }

package/src/jumpshell.js

@@ -123,6 +123,8 @@ class JumpShell {
     this.entry = resolveHostEntry(conf, host);
     this.profile = resolveProfile(conf, host);
     this.searchKeyword = this.entry.keyword || host;
+    // direct=true：跳过堡垒机菜单直连裸机（无 Opt> 流程）；命令只读校验链路不变
+    this.direct = this.profile.direct === true;
     this.knownHostsDir = opts.knownHostsDir; // 测试注入用；缺省 ~/.rrs
     this.conn = null;
     this.stream = null;
@@ -250,6 +252,12 @@ class JumpShell {
 
   async login(timeoutSecs = 30) {
     const deadline = Date.now() + timeoutSecs * 1000;
+    if (this.direct) {
+      // 直连模式：连上即 shell，只等 prompt；命令仍走白名单校验（whitelist.js）
+      if (!(await this.waitPrompt(deadline))) throw new Error("未能进入 shell（直连）");
+      await sleep(500);
+      return;
+    }
     if (!(await this.waitFor("Opt>", deadline))) throw new Error("跳板机菜单未出现");
     await sleep(1000);
     this.send("");