Windows命令行界面服务器配置

配置

基础配置

{
  "port": 3000,              // 服务绑定端口，默认为3000
  "host": "localhost",       // 绑定地址，设置为IP或域名，默认为localhost
  "restrictWorkingDirectory": true, // 是否限制命令执行目录，默认true
  "allowedPaths": [          // 允许的文件夹路径，默认包括当前工作目录和用户家目录
    "%current%",
    "%home%"
  ],
  "commandLengthLimit": 2000, // 命令的最大长度限制，防止超长命令注入，默认2000字符
  "logCommands": true,        // 是否记录执行的命令，默认true
  "timeout": 30000            // 命令的最长允许运行时间（毫秒），默认30秒
}

shell配置

{
  "shells": [                // 支持的shell列表，默认包括cmd和bash
    "cmd.exe",
    "/bin/bash"
  ],
  "blockedCommands": [       // 被阻止的危险命令，默认包含rm, del等
    "rm",
    "del",
    "format",
    "erase",
    " Cipher ",
    "vssadmin",
    "wbadmin",
    "regsvr32",
    "msbuild"
  ],
  "blockedArguments": [      // 被阻止的危险参数，默认包含/c,/f等
    "/c",
    "/f",
    "/q",
    "/s",
    "-rf",
    "--force",
    "--recursive"
  ],
  "enableInjectionProtection": true, // 是否启用命令注入防护，默认true
  "caseInsensitiveBlocking": true     // 是否对大小写不敏感地阻止命令，默认true
}

SSH配置

{
  "ssh": {
    "enabled": true,          // 是否启用SSH功能，默认true
    "maxConcurrentSessions": 5,// 最大允许的并发SSH会话数，默认5
    "defaultTimeout": 30000   // 默认命令超时时间（毫秒），默认30秒
  }
}

资源

SSH连接

• URI格式: ssh://{connectionId}
• 说明: 每个SSH连接对应一个资源，显示连接配置信息并自动屏蔽敏感数据。
• 示例: ssh://raspberry-pi 会显示名为"raspberry-pi"的连接配置。

SSH全局配置

• URI: ssh://config
• 说明: 显示整个SSH服务器的配置参数，包括默认超时、最大并发连接数等，并自动屏蔽密码信息。

当前目录

• URI: cli://currentdir
• 说明: 显示当前命令行界面服务器的工作目录，默认为服务启动时的目录。

CLI全局配置

• URI: cli://config
• 说明: 展示CLI服务器的所有配置信息，包括安全性设置、shell参数和SSH配置等。

安全注意事项

建入的安全特性（无法关闭）

1. 命令阻止大小写不敏感: 所有命令阻止都是不分大小写的，例如"DEL.EXE", "del.cmd"都会被阻止如果"del"在blockedCommands中。
2. 智能路径解析: 服务器会解析完整的命令路径以防止欺骗攻击，例如"%SystemRoot%\system32\cmd.exe"会被正确识别为cmd.exe。
3. 自动屏蔽敏感信息: 在显示任何配置或日志时，密码和密钥等敏感信息都会被自动替换为占位符。
4. 会话过期机制: 闲置的SSH会话和命令历史记录会有超时限制，防止未授权访问。

可选的安全功能

1. 双向认证: 支持客户端证书验证或otp一次性密码登录方式，提升SSH连接的安全性。
2. 日志记录与审计: 所有用户操作都会被详细记录，包括命令内容、执行时间等信息，便于后续审计分析。

重要安全警告

• 默认配置风险: 使用默认端口3000和默认路径可能会增加被未授权访问的风险，请根据实际需求更改相关配置。
• SSH弱密码策略: 默认禁止使用弱密码协议（如DSA），建议在生产环境中强制启用RSA或ECDSA加密。
• 定期更新检查: 由于存在零日漏洞风险，建议定期检查并更新CLI服务器到最新版本。

许可证

本项目遵循MIT许可证，允许用户自由使用、修改和分发代码，但需保留版权声明。具体许可内容请参考MIT License。

命令示例

# 查询所有可用资源
curl http://localhost:3000/_resources

# 获取当前目录信息
curl http://localhost:3000/cli://currentdir

# 执行系统命令
curl -X POST --data "command=dir" http://localhost:3000/