用途:把本地文件移动到群晖 NAS(QuickConnect、DSM File Station 或 Synology Drive 目标目录),仅在远端校验通过后清理本地源文件。适用于“上传到群晖后删本地”“用 QuickConnect 上传到 NAS”“清理 ~/Music/MP3 到群晖”等请求。不适用于 Synology C2 Object Storage、S3 或非 DSM 云盘,也不用于仅浏览 NAS。
主要能力:CLI 会校验远端文件大小,默认还会比对远端与本地 MD5;默认删除模式为 trash,文件被移入配置的回收目录,可恢复;仅在用户明确要求不可逆删除时才用 --delete-mode unlink。
使用方式:CLI 位于 ~/.local/bin/synology-cli,源码与运行环境在技能目录内。常用命令:synology-cli config 查看配置(不打印密钥);synology-cli doctor 检查连通性与 File Station API;synology-cli run --source ~/Music/MP3 --remote-dir /home/Music/MP3 --dry-run --json 先演练;确认后去掉 --dry-run 执行。新源目录务必先 --dry-run。
配置:默认路径 ~/.config/synology-cli/config.json,字段含 quickconnect_id、quickconnect_domain、base_url、username、remote_dir、cert_verify、dsm_version、delete_mode、verify_md5、recursive、audit_log。密码默认从 macOS Keychain 读取,可用 security add-generic-password -a "$USER" -s synology-cli -w 'REPLACE_WITH_DSM_PASSWORD' -U 写入;一次性自动化可用 SYNO_PASSWORD,但不得写入文件或打印。
限制与安全:QuickConnect 只是访问路径而非存储 API,中继不可用时改用可达的 --base-url(DDNS、VPN、Tailscale 或局域网地址)。切勿把 DSM 密码放入命令行、配置文件、仓库或聊天记录。所有检查通过前不得删除本地数据。报告 JSON 摘要与审计日志路径;ok 为 false 或 failed 非零时不得声称成功。可用仓库内 fake DSM 脚本 test_e2e.sh 测试完整 HTTPS API 流程,无需真实 NAS。