SMB / CIFS 客户端工具 (smb-client)

连接 SMB/CIFS 共享并完成浏览、读取、下载、上传、目录管理等操作。内置双引擎：

1. smbclient 引擎：检测到系统已安装 smbclient 时优先使用；
2. 纯 JS 引擎：未安装 CLI 或 CLI 执行失败且已提供 share 时自动回退，依赖已打包进 skill.js，无需 npm install。

快速开始

# 1. 测试连通性与认证（推荐用 smb:// URL）
node skill.js test --url "smb://username:your_password@smb.example.com/myshare"

# 2. 列出远程目录（--json 便于程序解析，--recursive 递归）
node skill.js ls "movies" --host smb.example.com --share myshare --user username --password your_password --json

# 3. 读取远程文件内容
node skill.js cat "docs/readme.txt" --smb "host:smb.example.com,share:myshare,user:username,password:your_password"

# 4. 下载 / 上传
node skill.js get "movies/intro.mp4" ./intro.mp4 --url "smb://username:your_password@smb.example.com/myshare"
node skill.js put ./report.pdf "docs/report.pdf" --url "smb://username:your_password@smb.example.com/myshare"

# 5. 列出服务器公开共享（需要 smbclient）
node skill.js shares --host smb.example.com --user username --password your_password --json

命令总表

选项

连接参数提供方式

优先级：命令行独立选项 > --smb 串 > smb:// URL > 环境变量。

1. smb:// URL（最推荐）

node skill.js ls "movies" --url "smb://username:your_password@smb.example.com/myshare"

2. 紧凑参数串 (--smb)

node skill.js ls --smb "host:smb.example.com,share:myshare,user:username,password:your_password,domain:WORKGROUP"

3. 独立参数

node skill.js ls --host smb.example.com --share myshare --user username --password your_password --domain WORKGROUP --port 445

4. 环境变量

export SMB_HOST=smb.example.com
export SMB_SHARE=myshare
export SMB_USER=username
export SMB_PASSWORD=your_password
node skill.js ls

引擎选择与输出

• 每条输出均带 engine 字段：smbclient 或 js。
• shares / list-shares 依赖 smbclient；纯 JS 引擎无法在未知 share 时枚举共享列表，会返回 SMBCLIENT_REQUIRED 错误并提示查看已挂载共享。
• 错误统一输出 { "success": false, "error": "...", "code": "..." }，退出码 1。

{
  "success": true,
  "engine": "js",
  "path": "/",
  "count": 2,
  "entries": [
    { "name": "movies", "path": "movies", "type": "directory", "size": null },
    { "name": "info.txt", "path": "info.txt", "type": "file", "size": 1024 }
  ]
}

常见问题

1. 连接超时 (ETIMEDOUT)：确认目标主机与 445 端口可达（如 nc -z -w 3 <host> 445），检查防火墙与局域网路由。
2. 认证失败 (STATUS_LOGON_FAILURE)：核对用户名密码；Windows 或 AD 域设备需带 --domain。
3. 共享不存在 (STATUS_BAD_NETWORK_NAME)：--share 填共享名称（如 video），不是物理路径。
4. shares 报 SMBCLIENT_REQUIRED：安装 samba 客户端（如 apt install smbclient），或改用 mount / net use 查看已挂载共享。
5. smbclient 引擎失败后自动回退：stderr 会给出 warning，最终结果以 engine: "js" 标记。

第三方开源致谢

本工具内置打包了 @marsaud/smb2 (MIT License)。