ssh-licco 2.1.2__tar.gz → 2.1.4__tar.gz

{ssh_licco-2.1.2/ssh_licco.egg-info → ssh_licco-2.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-licco
-Version: 2.1.2
+Version: 2.1.4
 Summary: SSH Model Context Protocol Server - Enable SSH functionality for AI models
 Author-email: SSH LICCO Team <contact@ssh-licco.dev>
 License: MIT
@@ -86,8 +86,24 @@ Dynamic: license-file
 - 🐳 **Docker 支持** - Docker 构建和状态监控
 - 📋 **后台任务** - 可靠的后台进程启动（nohup + bash -c 包装，单次 SSH 调用无竞态）
 - 🖥️ **screen/tmux 会话** - 持久化远程会话，SSH 断开后进程依然存活
+- 🪟 **Windows 服务器支持** - 支持 Windows Server（OpenSSH for Windows）与 Linux/macOS 目标主机
 - 🔍 **进程管理** - 启动/停止/查询远程进程、SSH 端口转发（tunnel）
 - 🔍 **看门狗** - 任务监控、心跳检测、全局异常处理
+- 🛡️ **文件传输路径安全校验** - `ssh_file_transfer` delete 自动识别 Windows / Unix 路径风格并拦截敏感路径与路径遍历
+
+---
+
+## 🖥️ 目标主机支持
+
+SSH-LICCO 基于标准 SSH/SFTP 协议，可连接以下目标主机：
+
+| 操作系统 | 要求 | 备注 |
+|---|---|---|
+| **Linux** | OpenSSH 7.0+ | 推荐，完整支持所有功能 |
+| **Windows Server** | OpenSSH for Windows / PowerShell Remoting over SSH | v2.1.3+ 支持 Windows 路径风格与安全校验 |
+| **macOS** | 系统内置 OpenSSH | 完整支持 |
+
+> **提示**：连接 Windows 服务器时，请使用 Windows 风格路径（如 `C:\temp\file.txt`），系统会自动识别并进行路径安全校验。
 
 ---
 
@@ -241,7 +257,7 @@ SSH 跳板模式部署的生产必做加固，补齐跳板机单点风险：
 | `ssh_connect` | 连接管理 | 自动读取环境变量/配置，支持密码+密钥认证，可保存配置，登录后自动执行命令 |
 | `ssh_execute` | 命令执行 | 自动连接、智能后台检测、长任务等待、超时控制，支持 nohup/screen/tmux 三种后台模式；v2.1.0 新增 `approval_id`（高危审批）与 `remote_guard`（双层拦截）参数 |
 | `ssh_disconnect` | 会话管理 | 断开指定会话 OR 列出所有活跃会话 |
-| `ssh_file_transfer` | 文件传输 | 上传/下载/列表/写入/追加/删除/创建目录/查看元信息（8 种操作） |
+| `ssh_file_transfer` | 文件传输 | 上传/下载/列表/写入/追加/删除/创建目录/查看元信息（8 种操作）；v2.1.3+ delete 操作新增 Windows/Unix 敏感路径拦截与路径遍历防护 |
 | `ssh_host` | 主机管理 | `action=list/add/remove` 增删查主机配置 |
 | `ssh_docker` | Docker 管理 | `action=ps/images/build/logs` 全生命周期管理 |
 | `ssh_generate_key` | 密钥生成 | RSA / Ed25519 密钥对 |

{ssh_licco-2.1.2 → ssh_licco-2.1.4}/README.md

@@ -53,8 +53,24 @@
 - 🐳 **Docker 支持** - Docker 构建和状态监控
 - 📋 **后台任务** - 可靠的后台进程启动（nohup + bash -c 包装，单次 SSH 调用无竞态）
 - 🖥️ **screen/tmux 会话** - 持久化远程会话，SSH 断开后进程依然存活
+- 🪟 **Windows 服务器支持** - 支持 Windows Server（OpenSSH for Windows）与 Linux/macOS 目标主机
 - 🔍 **进程管理** - 启动/停止/查询远程进程、SSH 端口转发（tunnel）
 - 🔍 **看门狗** - 任务监控、心跳检测、全局异常处理
+- 🛡️ **文件传输路径安全校验** - `ssh_file_transfer` delete 自动识别 Windows / Unix 路径风格并拦截敏感路径与路径遍历
+
+---
+
+## 🖥️ 目标主机支持
+
+SSH-LICCO 基于标准 SSH/SFTP 协议，可连接以下目标主机：
+
+| 操作系统 | 要求 | 备注 |
+|---|---|---|
+| **Linux** | OpenSSH 7.0+ | 推荐，完整支持所有功能 |
+| **Windows Server** | OpenSSH for Windows / PowerShell Remoting over SSH | v2.1.3+ 支持 Windows 路径风格与安全校验 |
+| **macOS** | 系统内置 OpenSSH | 完整支持 |
+
+> **提示**：连接 Windows 服务器时，请使用 Windows 风格路径（如 `C:\temp\file.txt`），系统会自动识别并进行路径安全校验。
 
 ---
 
@@ -208,7 +224,7 @@ SSH 跳板模式部署的生产必做加固，补齐跳板机单点风险：
 | `ssh_connect` | 连接管理 | 自动读取环境变量/配置，支持密码+密钥认证，可保存配置，登录后自动执行命令 |
 | `ssh_execute` | 命令执行 | 自动连接、智能后台检测、长任务等待、超时控制，支持 nohup/screen/tmux 三种后台模式；v2.1.0 新增 `approval_id`（高危审批）与 `remote_guard`（双层拦截）参数 |
 | `ssh_disconnect` | 会话管理 | 断开指定会话 OR 列出所有活跃会话 |
-| `ssh_file_transfer` | 文件传输 | 上传/下载/列表/写入/追加/删除/创建目录/查看元信息（8 种操作） |
+| `ssh_file_transfer` | 文件传输 | 上传/下载/列表/写入/追加/删除/创建目录/查看元信息（8 种操作）；v2.1.3+ delete 操作新增 Windows/Unix 敏感路径拦截与路径遍历防护 |
 | `ssh_host` | 主机管理 | `action=list/add/remove` 增删查主机配置 |
 | `ssh_docker` | Docker 管理 | `action=ps/images/build/logs` 全生命周期管理 |
 | `ssh_generate_key` | 密钥生成 | RSA / Ed25519 密钥对 |

{ssh_licco-2.1.2 → ssh_licco-2.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ssh-licco"
-version = "2.1.2"
+version = "2.1.4"
 description = "SSH Model Context Protocol Server - Enable SSH functionality for AI models"
 readme = "README.md"
 requires-python = ">=3.10"

{ssh_licco-2.1.2 → ssh_licco-2.1.4/ssh_licco.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-licco
-Version: 2.1.2
+Version: 2.1.4
 Summary: SSH Model Context Protocol Server - Enable SSH functionality for AI models
 Author-email: SSH LICCO Team <contact@ssh-licco.dev>
 License: MIT
@@ -86,8 +86,24 @@ Dynamic: license-file
 - 🐳 **Docker 支持** - Docker 构建和状态监控
 - 📋 **后台任务** - 可靠的后台进程启动（nohup + bash -c 包装，单次 SSH 调用无竞态）
 - 🖥️ **screen/tmux 会话** - 持久化远程会话，SSH 断开后进程依然存活
+- 🪟 **Windows 服务器支持** - 支持 Windows Server（OpenSSH for Windows）与 Linux/macOS 目标主机
 - 🔍 **进程管理** - 启动/停止/查询远程进程、SSH 端口转发（tunnel）
 - 🔍 **看门狗** - 任务监控、心跳检测、全局异常处理
+- 🛡️ **文件传输路径安全校验** - `ssh_file_transfer` delete 自动识别 Windows / Unix 路径风格并拦截敏感路径与路径遍历
+
+---
+
+## 🖥️ 目标主机支持
+
+SSH-LICCO 基于标准 SSH/SFTP 协议，可连接以下目标主机：
+
+| 操作系统 | 要求 | 备注 |
+|---|---|---|
+| **Linux** | OpenSSH 7.0+ | 推荐，完整支持所有功能 |
+| **Windows Server** | OpenSSH for Windows / PowerShell Remoting over SSH | v2.1.3+ 支持 Windows 路径风格与安全校验 |
+| **macOS** | 系统内置 OpenSSH | 完整支持 |
+
+> **提示**：连接 Windows 服务器时，请使用 Windows 风格路径（如 `C:\temp\file.txt`），系统会自动识别并进行路径安全校验。
 
 ---
 
@@ -241,7 +257,7 @@ SSH 跳板模式部署的生产必做加固，补齐跳板机单点风险：
 | `ssh_connect` | 连接管理 | 自动读取环境变量/配置，支持密码+密钥认证，可保存配置，登录后自动执行命令 |
 | `ssh_execute` | 命令执行 | 自动连接、智能后台检测、长任务等待、超时控制，支持 nohup/screen/tmux 三种后台模式；v2.1.0 新增 `approval_id`（高危审批）与 `remote_guard`（双层拦截）参数 |
 | `ssh_disconnect` | 会话管理 | 断开指定会话 OR 列出所有活跃会话 |
-| `ssh_file_transfer` | 文件传输 | 上传/下载/列表/写入/追加/删除/创建目录/查看元信息（8 种操作） |
+| `ssh_file_transfer` | 文件传输 | 上传/下载/列表/写入/追加/删除/创建目录/查看元信息（8 种操作）；v2.1.3+ delete 操作新增 Windows/Unix 敏感路径拦截与路径遍历防护 |
 | `ssh_host` | 主机管理 | `action=list/add/remove` 增删查主机配置 |
 | `ssh_docker` | Docker 管理 | `action=ps/images/build/logs` 全生命周期管理 |
 | `ssh_generate_key` | 密钥生成 | RSA / Ed25519 密钥对 |

{ssh_licco-2.1.2 → ssh_licco-2.1.4}/ssh_mcp/__init__.py

@@ -1,8 +1,8 @@
 # SSH-LICCO 版本信息
 # 所有代码中的版本信息都从这里读取
-# 版本号：2.1.2
+# 版本号：2.1.4
 
-__version__ = "2.1.2"
+__version__ = "2.1.4"
 __author__ = "Li Qi"
 __email__ = "1985694657@qq.com"
 __license__ = "MIT"

{ssh_licco-2.1.2 → ssh_licco-2.1.4}/ssh_mcp/handlers/file_transfer.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import re
 import shlex
+from pathlib import PurePosixPath, PureWindowsPath
 
 from mcp.types import TextContent
 
@@ -12,6 +13,101 @@ from .context import HandlerContext
 from .utils import ensure_session
 
 
+# 远程 Unix/Linux 敏感路径黑名单
+FORBIDDEN_REMOTE_PATHS = [
+    "/etc",
+    "/root",
+    "/boot",
+    "/proc",
+    "/sys",
+    "/dev",
+    "/bin",
+    "/sbin",
+    "/usr/bin",
+    "/usr/sbin",
+    "/lib",
+    "/lib64",
+    "/var/lib/postgresql",
+    "/var/lib/mysql",
+    "/var/lib/redis",
+    "/var/lib/docker",
+    "/var/log",
+    "/var/spool",
+    "/var/mail",
+    "/home/*/.ssh",
+]
+
+# 远程 Windows 敏感路径黑名单（支持大小写不敏感匹配）
+FORBIDDEN_WINDOWS_PATHS = [
+    r"C:\Windows",
+    r"C:\Windows\System32",
+    r"C:\Windows\SysWOW64",
+    r"C:\Program Files",
+    r"C:\Program Files (x86)",
+    r"C:\ProgramData",
+    r"C:\inetpub",
+    r"C:\Users\Default",
+    r"C:\Users\Public",
+    r"C:\Recovery",
+    r"C:\System Volume Information",
+    r"C:\$Recycle.Bin",
+]
+
+
+def _is_windows_path(path: str) -> bool:
+    """根据路径特征判断是否为 Windows 风格路径。"""
+    if re.match(r"^[A-Za-z]:\\", path):
+        return True
+    if path.startswith("\\\\"):
+        return True
+    # 仅包含反斜杠且不含正斜杠时，视为 Windows 路径
+    if "\\" in path and "/" not in path:
+        return True
+    return False
+
+
+def _validate_remote_path(remote_path: str, operation: str = "access") -> tuple[bool, str]:
+    """校验远程路径是否安全，自动识别 Windows / Unix 路径风格。
+
+    Returns:
+        (is_safe, error_message)
+    """
+    if not remote_path or not remote_path.strip():
+        return False, "远程路径不能为空"
+
+    remote_path = remote_path.strip()
+
+    if _is_windows_path(remote_path):
+        # Windows 路径处理
+        normalized = str(PureWindowsPath(remote_path))
+        if ".." in normalized.split("\\"):
+            return False, f"Windows 路径遍历被阻止：{remote_path}"
+
+        upper_normalized = normalized.upper()
+        for forbidden in FORBIDDEN_WINDOWS_PATHS:
+            upper_forbidden = forbidden.upper().rstrip("\\")
+            if upper_normalized == upper_forbidden or upper_normalized.startswith(upper_forbidden + "\\"):
+                return False, f"禁止{operation} Windows 敏感路径：{forbidden}"
+
+        return True, ""
+
+    # Unix/Linux 路径处理
+    normalized = str(PurePosixPath(remote_path)).rstrip("/") or "/"
+    if ".." in normalized.split("/"):
+        return False, f"路径遍历被阻止：{remote_path}"
+
+    path_for_check = normalized.rstrip("/*") or "/"
+    for forbidden in FORBIDDEN_REMOTE_PATHS:
+        if forbidden.endswith("/*"):
+            prefix = forbidden[:-1]
+            if path_for_check.startswith(prefix) or path_for_check + "/" == prefix:
+                return False, f"禁止{operation}敏感路径：{forbidden}"
+        elif path_for_check == forbidden or path_for_check.startswith(forbidden + "/"):
+            return False, f"禁止{operation}敏感路径：{forbidden}"
+
+    return True, ""
+
+
 async def handle_file_transfer(ctx: HandlerContext, args: dict) -> list[TextContent]:
     """Transfer files between local and remote, or perform remote file operations."""
     session_id = await ensure_session(ctx, args, handle_connect)
@@ -51,6 +147,9 @@ async def handle_file_transfer(ctx: HandlerContext, args: dict) -> list[TextCont
     elif direction == "delete":
         if not remote_path:
             return [TextContent(type="text", text="delete requires remote_path")]
+        safe, err = _validate_remote_path(remote_path, operation="delete")
+        if not safe:
+            return [TextContent(type="text", text=f"❌ Delete blocked: {err}")]
         result = await session.delete_file(remote_path)
     elif direction == "mkdir":
         if not remote_path: