К основному содержанию
скилл CX Codex

synology-nas — скилл для Claude Code: управление NAS

Скилл для Claude Code управляет Synology NAS с DSM 7 через CLI nas. Агент подключает его для проверки состояния дисков, хранилища, служб и обновлений DSM.

MIT ★ 106 обновлён 2026-11-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add akari-sora/synology-nas-cli --skill synology-nas -a claude-code
Открыть на GitHub

Что делает synology-nas

Скилл использует CLI nas, чтобы проверять состояние Synology NAS и выполнять команды управления DSM 7. Он помогает настроить подключение, проверить учётные данные и TLS, получить сведения о дисках, SMART, пулах, томах, UPS и сетевых службах, просмотреть пакеты и журналы входов. По запросу агента можно также запускать обновление DSM и обращаться к Web API.

Для CLI нужен Python 3.8 или новее; он использует только стандартную библиотеку Python. Перед проверками NAS нужно настроить подключение: указать адрес DSM и источник учётных данных. Команды могут обращаться к NAS по паролю через HTTPS, использовать уже открытую сессию Chrome на macOS или запускаться локально на NAS от root через Task Scheduler.

Какие задачи решает

  • проверить состояние дисков и SMART
  • найти ошибки входа и внешние подключения
  • посмотреть состояние пакетов и томов DSM
  • проверить конфигурацию и подключение к NAS
  • получить данные DSM через Web API

Примеры запросов агенту

  • Проверь состояние моего Synology NAS и дисков.
  • Найди ошибки входа в DSM за последний период.
  • Покажи пакеты и тома на NAS.

Как установить synology-nas

1Через Skills CLI (Vercel)

npx skills add akari-sora/synology-nas-cli --skill synology-nas -a claude-code

2Вручную: положить файлы

~/.claude/skills/synology-nas/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/synology-nas/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о synology-nas

Как установить synology-nas в Claude Code?

Выполни npx skills add akari-sora/synology-nas-cli --skill synology-nas -a claude-code. Файл скилла появится по пути ~/.claude/skills/synology-nas/SKILL.md.

Что делает synology-nas?

Скилл управляет Synology NAS с DSM 7 через CLI nas: проверяет состояние системы и дисков, просматривает службы, пакеты и журналы, а также вызывает DSM Web API.

Что нужно для работы synology-nas?

Нужен Python 3.8 или новее, CLI nas, NAS с DSM 7 и настроенные адрес DSM и учётные данные. CLI поддерживает подключение по HTTPS, сессию Chrome на macOS и локальный запуск на NAS от root через Task Scheduler.

Исходный текст

SKILL.md · MIT
---
name: synology-nas
description: Operate a Synology NAS (DSM 7) from the command line with the `nas` CLI from synology-nas-cli - setup, doctor, status, health, disks, UPS, connection logs, packages, volumes, Tailscale, DSM upgrades, alerts and raw DSM Web API calls. Use for Synology, DSM, NAS status or health, "is my NAS ok", SMART, storage pool, Package Center, QuickConnect, AutoBlock, DSM firewall, DSM API errors 105/106/107/119/400/403/404/407/499, synowebapi, Task Scheduler on DSM.
---

# Synology NAS through `nas`

`nas` is a Python CLI (stdlib only, Python 3.8+) and stdio MCP server for the DSM 7 Web API. Run it as `nas` (installed with `pip install -e .` or linked onto PATH) or as `bin/nas` from the repository. Every command accepts `--json` and `--no-input` (before or after the command: `nas --json status`).

## First run

```bash
nas setup --origin https://192.0.2.10:5001 --user USER --password-source op:op://VAULT/ITEM/password --allowed-network 192.0.2.0/24 --json --no-input
nas doctor --json
```

`setup` exits 3 with `{"missing": [{"field", "why", "ask_user"}]}` when a value is needed from a person (relay `ask_user`, then call `setup` again with the answer; for `"field": "otp"` pass `--otp-code CODE --trust-device`); `doctor` returns `{"checks": [{"name", "status", "detail", "next_step"}], "ok"}`. Full sequence: `docs/AGENT-RUNBOOK.md`.

## Configuration

- Config file: `$NAS_CONFIG`, else `~/.config/synology-nas-cli/config.json`. `nas config init` writes an example; `nas config show` prints the effective config (commands masked) and which credential source is active.
- `origins`: DSM URLs tried in order (first one accepting TCP within 3 s), e.g. LAN first, VPN/Tailscale second. `NAS_ORIGINS` or `--lan-origin URL,URL` override it for one run.
- `nas whoami` signs in once and prints backend, origin, credential source, session mode, account, admin flag and DSM version. It is the quickest check that config and credentials work.

## Credentials (first configured source wins)

1. `credentials.op_password` / `op_username` = `op://VAULT/ITEM/FIELD` (1Password CLI; token from `OP_SERVICE_ACCOUNT_TOKEN`, else the token file `credentials.op_token_file`, else the signed-in 1Password app).
2. `NAS_PASSWORD_COMMAND` or `credentials.password_command`: a command printing the password (Keychain `security find-generic-password -w`, `secret-tool lookup`, `pass show`, `bw get password`, PowerShell CredentialManager).
3. The OS keychain entry written by `nas login --save`.
4. `NAS_USER` + `NAS_PASSWORD`.
5. An interactive prompt when stdin is a terminal.

`NAS_CREDENTIAL_SOURCE=op|command|keychain|env|prompt` forces one. 2FA codes: `credentials.otp_command`, else `op item get --otp`, else a prompt; `nas login --trust-device` stores DSM's trusted-device token.

Sessions: by default each command signs in and out. `nas login` caches the session (mode 600) and later commands reuse it, signing in again on 106/107/119; `nas logout` ends it. `NAS_SID` + `NAS_SYNOTOKEN` reuse an existing DSM session.

## Backends

- `--backend password` (default): HTTPS with the credential chain; pins the TLS certificate SHA-256 on first use (`nas trust`, `nas trust --reset ORIGIN`) when `tls.verify` is `false`.
- `--backend chrome`: macOS only; uses a DSM tab already signed in in Google Chrome (needs View > Developer > Allow JavaScript from Apple Events). No uploads.
- `--backend local`: on the NAS as root (Task Scheduler); `synowebapi --exec`, no credentials.

## Commands

| Need | Command |
|---|---|
| Write config, sign in once, pin TLS certificate | `nas setup --origin URL --user USER --password-source SOURCE` |
| Verify config, credentials, TLS, login, DSM build, 2FA, capabilities, clock | `nas doctor` |
| Backend, origin, credential source, session, account, admin flag, DSM build | `nas whoami` |
| Model, DSM build, SA-26:13, SA-26:18, SA-26:19, and the overall DSM-patch verdict | `nas status` |
| Disks, SMART, temperatures, pools, volumes, UPS, CPU, memory | `nas health` |
| Interfaces, PPPoE public address, firewall | `nas net` |
| SSH/FTP/SMB/AFP/NFS/rsync/QuickConnect/AutoBlock | `nas services` |
| Shares, packages (SA-26:14), containers, users and 2FA, scheduled tasks | `nas inventory` |
| Failed and external sign-ins | `nas logs [--since "YYYY-MM-DD HH:MM"] [--limit N] [--top N]` |
| Search shares for `*.L0CK3D`, `*.LOCK3D`, `read-me3.txt` | `nas ransom-scan [--pattern P] [--timeout SEC]` (every share the account can see) |
| Ransomware incident audit / fix / freeze / key recovery | `nas incident [--probe] [--scan] [--deep]`, `nas incident fix --dry-run`, `nas incident contain [--yes]`, `nas incident rescue --yes --capture-dir /SHARE/rescue` (see `synology-ransomware-response`) |
| Ports reachable from this machine | `nas exposure [--probe-timeout SEC]` |
| One-pass monitoring (exit 1 on warning/critical) or webhook push | `nas alert [--no-update] [--push FILE]` |
| Deploy 10-minute root monitoring task + DSM webhook on the NAS | `nas alert-deploy [--test] [--interval 10] [--webhook-item op://VAULT/ITEM]` |
| Packages | `nas pkg list\|start ID\|stop ID\|install ID [--volume /volume1]\|uninstall ID [--remove-data]\|default-volume [/volumeN]` |
| Volume atime | `nas volume list`, `nas volume atime volume_1 noatime` |
| Tailscale package | `nas tailscale status`, `nas tailscale login-url [--force]` |
| DSM update | `nas upgrade --dry-run`, `nas upgrade` (PreCheck only), `nas upgrade --yes` (installs, reboots), `nas upgrade --install-update --yes` (Update pack for the installed build, header-verified; needs `dsm_unique`), `nas upgrade --wait-only` |
| Session & TLS certificate management | `nas login [--save] [--trust-device]`, `nas logout [--forget]`, `nas trust [--reset ORIGIN]` |
| Config management | `nas config init [--force]`, `nas config show` |
| MCP server over stdio | `nas mcp [--auto-confirm]` (`docs/MCP.md`; `incident_fix` applies with `confirm: true`, or without `confirm` on an `--auto-confirm` server) |
| Any API | `nas api SYNO.Core.System info --version 1`; write methods with `--allow-write` (or `--yes` / `NAS_YES=1`) |

Find API names and versions: `nas api SYNO.API.Info query --version 1 query=all` (or `query=SYNO.Core.Foo`). Parameters are `k=v`; values that are not valid JSON are sent as JSON strings automatically.

## Errors

| Code | Meaning |
|---|---|
| 400 | wrong account or password on `SYNO.API.Auth` (counts toward AutoBlock); invalid parameter on `SYNO.FileStation` |
| 401 | account disabled |
| 403 / 404 / 406 | 2FA code required / wrong / enforced but not enrolled (`SYNO.API.Auth`); 403 on `SYNO.FileStation` means file permission denied |
| 407 | this source address is blocked by AutoBlock (`SYNO.API.Auth`, CLI exit 5); on `SYNO.FileStation` means operation not permitted |
| 498 / 499 | DSM is installing an update / not ready after an upgrade (CLI exit 6; `nas upgrade --wait-only` waits for `dsm_upgrade_all_done`) |
| 105 | insufficient privilege (non-admin, or a call that wants `SYNO.Core.User.PasswordConfirm` or root `synowebapi`) |
| 106 / 107 / 119 | session timed out / replaced / not found; 119 on a fresh session means the SynoToken was not in the URL |
| 102 / 103 / 104 | API / method / version not available; check `SYNO.API.Info` |
| 114 / 120 | missing / invalid parameter; often JSON encoding |

## Technical facts

- AutoBlock (DSM default): 10 failed sign-ins within 5 minutes block the source address, often permanently (`expire_day 0`). The CLI reports a failed sign-in once and stops; each rerun with the same wrong password adds a failure. Unblocking: Control Panel > Security > Protection > Allow/Block List from another address, or Mode 1 reset (~4 s on the rear RESET button until 1 beep). Tailscale's DSM package in userspace mode makes every tailnet device appear as `127.0.0.1`, so a block on `127.0.0.1` locks out the whole tailnet (`incident.autoblock_allow_loopback: true` allow-lists `127.0.0.1`).
- DSM 7 APIs with `requestFormat: JSON` JSON-decode every field. A bare string can be accepted, rejected (120), or silently ignored (`SYNO.Core.Package.Uninstallation` answers success and does nothing). Fields that take "a string containing JSON" need double encoding.
- The SynoToken is accepted only as a URL query parameter.
- `synowebapi` prints a `[Line N] Exec WebAPI:` banner before its JSON.
- `SYNO.Core.TaskScheduler run` only runs a task with version 2; version 1 answers success and does nothing.
- `SYNO.Core.User set` (disable an account, change another user) answers 105 from a password session even after `PasswordConfirm`; it works as root through `synowebapi` in a one-off root Task Scheduler task. `SYNO.Core.NormalUser set` v2 changes your own password from a normal session.
- On models without immutable snapshots, turning the WORM lock on through the API is accepted and scheduled snapshots then stop silently (`nas incident` reports it as `snapshot_worm:<share>` FAIL).
- Applying a default-deny firewall profile drops sessions from addresses it does not allow, including your own if you connected through the public address.
- The connection log keeps about the last 10,000 entries; under brute force that is a few hours.
- Further reference: `docs/DSM-API-NOTES.md`, `docs/HARDENING.md`, `docs/TROUBLESHOOTING.md`, `docs/EXIT-CODES.md`.

© akari-sora · MIT · akari-sora/synology-nas-cli

Похожие скиллы

Каталог скиллов SKILL.md →
Synology NAS cmeans MCP-сервер Synology NAS подключает DSM API сетевого хранилища Synology к ассистенту. Помогает управлять файлами, следить за нагрузкой дисков и запускать загрузки прямо из чата. CX Codex +1 ★ 17звёзд репо Synology MCP Servosity MCP-сервер Synology MCP для Claude Code собирает данные о заданиях Active Backup for Business и состоянии хранилищ клиентских NAS. Он запускается по запросам об их резервных копиях и дисковом пространстве. CX Codex +1 ★ 87звёзд репо find-skills vercel-labs Скилл find-skills для Claude Code ищет скиллы по задаче и помогает выбрать, что установить. Он включается, когда нужно найти готовую возможность для агента. CX Codex +1 4 400 000установок frontend-design официальный anthropics Скилл frontend-design для Claude Code задаёт осмысленное визуальное направление для новых интерфейсов и редизайна. Помогает уйти от шаблонного UI. CX Codex +1 1 025 790установок agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок design-taste-frontend Leonxlnx Скилл design-taste-frontend для Claude Code задаёт правила оформления и проверки сайтов. Подключается при создании или переделке страницы, а также при просьбе убрать шаблонный вид. CX Codex +1 802 600установок grill-me Matt Pocock Скилл grill-me проводит жёсткое интервью по плану или дизайну, чтобы найти пробелы и уточнить решения. Подойдёт перед началом разработки. CX Codex +1 1 424 476установок grill-with-docs Matt Pocock Скилл grill-with-docs проводит жёсткое интервью по плану или дизайну и по ходу создаёт ADR и глоссарий. Подойдёт перед началом сложной разработки. CX Codex +1 1 219 756установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой