Windows CLI

🚀 Windows命令行界面服務器配置

本項目聚焦於Windows命令行界面服務器的配置，能幫助用戶靈活設置服務器各項參數，同時具備完善的安全機制，保障服務器的穩定與安全運行。

🚀 快速開始

本部分將為你介紹Windows命令行界面服務器的各項配置內容。

✨ 主要特性

• 多維度配置：支持基礎、shell、SSH等多方面的詳細配置。
• 資源管理：提供多種資源的URI訪問方式，方便查看配置信息。
• 安全防護：具備內置的安全特性和可選的安全功能，保障服務器安全。
• 命令示例：給出常見操作的命令示例，便於用戶快速上手。

📦 安裝指南

文檔未提及安裝步驟，暫不提供。

💻 使用示例

基礎用法

{
  "port": 3000,              // 服務綁定端口，默認為3000
  "host": "localhost",       // 綁定地址，設置為IP或域名，默認為localhost
  "restrictWorkingDirectory": true, // 是否限制命令執行目錄，默認true
  "allowedPaths": [          // 允許的文件夾路徑，默認包括當前工作目錄和用戶家目錄
    "%current%",
    "%home%"
  ],
  "commandLengthLimit": 2000, // 命令的最大長度限制，防止超長命令注入，默認2000字符
  "logCommands": true,        // 是否記錄執行的命令，默認true
  "timeout": 30000            // 命令的最長允許運行時間（毫秒），默認30秒
}

高級用法

{
  "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": {
    "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服務器到最新版本。

命令示例

# 查詢所有可用資源
curl http://localhost:3000/_resources

# 獲取當前目錄信息
curl http://localhost:3000/cli://currentdir

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

🔧 技術細節

內置安全特性原理

• 命令阻止大小寫不敏感：在命令解析階段，將輸入的命令統一轉換為小寫或大寫進行匹配，確保無論大小寫如何，只要在阻止列表中的命令都會被攔截。
• 智能路徑解析：服務器會對輸入的命令路徑進行解析，通過操作系統的API或內置的路徑解析規則，將完整路徑轉換為可識別的命令名稱。
• 自動屏蔽敏感信息：在輸出配置或日誌時，使用正則表達式或特定的字符串匹配方法，將密碼和密鑰等敏感信息替換為佔位符。
• 會話過期機制：為每個SSH會話和命令歷史記錄設置一個計時器，當超過預設的超時時間時，自動關閉會話或清除記錄。

可選安全功能實現

• 雙向認證：通過SSL/TLS協議實現客戶端證書驗證，或使用OTP庫實現一次性密碼登錄。
• 日誌記錄與審計：使用日誌庫將用戶操作信息記錄到文件或數據庫中，方便後續的審計分析。

📄 許可證

本項目遵循MIT許可證，允許用戶自由使用、修改和分發代碼，但需保留版權聲明。具體許可內容請參考MIT License。

⚠️ 重要提示

• 使用默認端口3000和默認路徑可能會增加被未授權訪問的風險，請根據實際需求更改相關配置。
• 默認禁止使用弱密碼協議（如DSA），建議在生產環境中強制啟用RSA或ECDSA加密。
• 由於存在零日漏洞風險，建議定期檢查並更新CLI服務器到最新版本。

💡 使用建議

• 建議根據實際需求調整服務器的各項配置參數，以提高服務器的安全性和性能。
• 在生產環境中，務必啟用雙向認證和日誌記錄與審計功能，以保障服務器的安全運行。