SuperAPI AI 工具集

pp-synology

部署与运维

查看项目

更新于 10-16 01:32

技能介绍

用途:通过 synology-pp-cli 二进制驱动 Synology DSM NAS,主要面向只读巡检、导出、同步与分析,覆盖系统健康、存储、SMART、共享、用户、群组、日志等。File Station 相关 files 组可执行 DSM 自身的文件操作(mkdir、rename、复制/移动/删除任务)。

安装与验证:npx -y @mvanhorn/printing-press-library install synology --cli-only;验证 synology-pp-cli --version。若报 command not found,说明安装目录未在 PATH,需先修正再使用。DSM 的 WebAPI 即使失败也返回 HTTP 200,且不同 NAS 命名空间随已装套件而异,该 CLI 会处理方言、自动续期过期会话、将 DSM 错误码转为可读信息;session apis 可列出本机实际暴露的 API 命名空间、版本范围与 CGI 路径。

主要能力:session(登录/登出/列 API)、storage(磁盘、存储池、卷、iSCSI LUN、eSATA/USB、SMART 属性表与计划测试)、system(DSM 身份、健康、信息、网络、服务、UPS、利用率)、user/group(本地账户与群组)、folder(共享文件夹与权限)、log(按级别、日期、关键词过滤系统日志)、nfs(服务状态)、package(已装套件)、files(浏览、搜索、stat、下载及后台复制/移动/删除任务)。

用法要点:任何命令可加 --agent,等价于 --json --compact --no-input --no-color --yes;--select 可裁剪字段并沿嵌套路径取值,适合精简上下文;--dry-run 预览请求。认证用 DSM 账户密码而非 API key:session login --account … --passwd … 换取 session id 与 SynoToken 并本地持久化,密码不保存;两步验证首次登录传 --otp-code;可用 SYNOLOGY_ACCOUNT、SYNOLOGY_PASSWORD、SYNOLOGY_BASE_URL 环境变量,自签名证书可加 --insecure;synology-pp-cli doctor 验证配置。输出包裹在 {meta, results} 信封中,解析 results,meta.source 区分 live 或 local。路径可用 --home 或 SYNOLOGY_HOME 及各类型环境变量重定位,凭据存于 data 目录的 credentials.toml。

限制:除 files 组外,system、storage、SMART、共享、用户、群组与日志均为只读;不得用其创建、修改或删除用户、群组、共享文件夹、NFS 权限或任何 DSM 设置,也不用于 Container Manager 或 Download Station。MCP 场景需在宿主配置中传递 SYNOLOGY_HOME,MCP 二进制不继承 CLI 标志。其他收费、价格与平台细节暂未提供。