面向 Synology DSM 7 的零依赖 Python CLI 和 MCP 服务器,可依据 C3RB3R/.L0CK3D 勒索软件活动审计 NAS 配置、规划修复方案并执行修复。
一個指令檢查 Synology NAS 是否有 C3RB3R / .L0CK3D 勒索軟體攻擊活動相關的弱點,第二個指令把發現的問題修好,之後也能繼續從終端機管理 DSM。
English · 繁體中文 · 简体中文 · 日本語 · 한국어 · Deutsch · Español · Français
主儲存庫、版本發布與 Issue 回報:https://gitlab.com/aa22396584/synology-nas-cli

nas 是零外部相依性的 Python 命令列工具(僅使用標準函式庫,支援 Python 3.8+,因此也能直接在 DSM 本機上執行)與 stdio MCP 伺服器,支援 Synology DSM 7 Web API:系統狀態、健康度、日誌、套件、儲存空間、Tailscale、DSM 升級、定期健康檢查並推播警報至 Webhook,以及在 2026 年 10 月針對暴露於網際網路的 Synology NAS 之 C3RB3R / .L0CK3D 勒索軟體攻擊活動(Synology-SA-24:20、SA-26:13、SA-26:19、SA-26:14)期間開發的資安事件稽核與修復工具。
本專案與 Synology Inc. 無關(Not affiliated with Synology Inc.)。"Synology"、"DSM" 與 "QuickConnect" 為 Synology Inc. 的商標。
把以下提示詞貼給 Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Grok Bot 或任何支援工具呼叫的 AI Agent(Grok Bot 設定、技能與警報例行任務:docs/GROK-BOT.md):
使用 https://github.com/akari-sora/synology-nas-cli 檢查並修復我的 Synology NAS(位址:https://192.0.2.10:5001),照著 docs/AGENT-RUNBOOK.md 的步驟執行。

./bin/nas --version。nas setup:執行 nas setup --json --no-input ... 寫入 ~/.config/synology-nas-cli/config.json(權限 0600),登入一次以驗證憑證,並在首次使用時釘選(pin)DSM 的 TLS 憑證 SHA-256 指紋。nas doctor:執行 nas doctor --json 驗證設定檔、憑證、連線目標可達性、TLS 指紋釘選、登入、DSM 版本(比對 SA-26:13 與 SA-26:19;任一未修補即失敗)、兩步驟驗證狀態、管理員權限與系統時鐘偏差。nas incident:執行 nas incident --json(可選加 --probe --scan)對 DSM 版本、有弱點的套件、防火牆、QuickConnect、UPnP 路由器規則、公網連接埠、外部與失敗登入紀錄、AutoBlock、SMB1、內建 admin 帳號、快照排程、不支援機型的 WORM 鎖定陷阱、勒索訊息檔,以及 CVE-2024-10441 攻擊嘗試進行唯讀稽核。nas incident fix --dry-run --json --ransom-scan,顯示每一項預計變更(before -> after)、實際會發送的 DSM Web API 呼叫,以及對應的 DSM 網頁介面路徑。nas incident fix --yes:依序套用核准的計畫(snapshot_worm → snapshots → packages → smb_min_protocol → quickconnect → router_port_forwarding → autoblock → admin_account → firewall,以及選用的 --rotate-password 與 --upgrade),逐項讀回設定以驗證結果,並重新執行一次稽核。--deep 與 alert-deploy:執行 nas incident --deep --json(透過任務排程表執行一次性唯讀 root 收集腳本,檢查限 root 讀取的日誌、crontab、/bin 執行檔、帳號、SSH 金鑰與 /proc)以及 nas alert-deploy --json --test(每 10 分鐘執行健康度與安全性監控並推播至 Webhook)。https://192.0.2.10:5001,若有使用 VPN/Tailscale 可一併提供該網址)。op://VAULT/ITEM/password、密碼指令,或作業系統鑰匙圈)。192.0.2.0/24)。/docker/.nas-cli-deploy,供 --deep 與 alert-deploy 使用)。nas setup 以結束碼 3 退出且回報 "field": "otp" 時,提供當下的 6 位數驗證碼;--trust-device 會儲存 DSM 的信任裝置權杖(權限 0600),後續指令即不需再輸入驗證碼。nas incident fix --yes 之前檢視 --dry-run 計畫(並決定是否納入 --rotate-password 或 --upgrade)。完整 Agent 執行規範:docs/AGENT-RUNBOOK.md。
flowchart LR
A["nas incident<br/>唯讀稽核"] --> B["nas incident fix --dry-run<br/>修復計畫:修改前 → 修改後"]
B --> C["nas incident fix --yes<br/>套用、讀回驗證、重新稽核"]
C --> D["nas alert-deploy<br/>每 10 分鐘檢查 → webhook"]
A -.->|檔案正在被加密| E["nas incident contain<br/>凍結加密程序"]
E --> F["nas incident rescue<br/>記憶體擷取 → 搜尋金鑰"]
nas incident 為唯讀操作。每個項目會印出 PASS、WARN、FAIL 或 SKIP 以及一行提示(--json 會輸出結構化 JSON;結構定義見 schemas/incident.schema.json)。只要有任何項目為 FAIL,結束碼即為 1。