When to Use
Use this skill when the user needs Synology-specific execution, not generic NAS or Linux advice. It covers DSM planning, storage layout, shared folders, remote access, Hyper Backup, Snapshot Replication, Synology Drive, package health, Container Manager, migrations, upgrades, and incident recovery.
This skill should activate whenever the real question is "what should be changed on this Synology box, in what order, and how do we avoid losing data or exposing DSM."
Architecture
This skill works statelessly for one-off Synology questions. If the user wants continuity across sessions, memory lives in ~/synology/. If ~/synology/ does not exist, run setup.md, explain planned local notes in plain language, and ask for confirmation before creating files. See memory-template.md for structure.
CODEBLOCK0
Quick Reference
Load only the smallest file that matches the task.
| Topic | File | Use it for |
|---|
| Setup flow and saved defaults | INLINECODE4 | Activate safely and decide whether continuity is useful |
| Memory schema and status values |
memory-template.md | Create durable notes without storing secrets |
| Volumes, Btrfs, SHR, and shared folder decisions |
storage-and-shares.md | Capacity, snapshots, permissions, and migration planning |
| Hyper Backup, snapshots, rsync, and restore order |
backup-and-recovery.md | Real backup strategy and recovery sequencing |
| QuickConnect, VPN, reverse proxy, and exposure guardrails |
remote-access-and-networking.md | Remote access and network change safety |
| Package health, Synology Drive, Photos, and Container Manager |
packages-and-containers.md | App selection, package triage, and container caveats |
| Incident triage and evidence collection |
troubleshooting.md | Fast diagnosis before risky changes |
Requirements
- - No credentials required for planning, review, or architecture work
- Live DSM changes may require admin access to the web UI and optional SSH access
- Confirm whether the target NAS is production, homelab, or backup-only before changing anything
- Require explicit confirmation before deletions, package removals, share permission rewrites, exposure changes, restore operations, or storage migrations
Data Storage
Store only context that improves later Synology work:
- - exact model, DSM version, and which packages matter
- filesystem and volume facts that change recommendations
- approved backup destinations, restore priorities, and exposure boundaries
- recurring failures, confirmed fixes, and package-specific caveats
Do not store passwords, QuickConnect credentials, OTP codes, serial numbers, or copied support bundles with secrets.
Core Rules
1. Identify the Box Before Giving Synology Advice
- - Lock the exact model, DSM version, volume layout, filesystem, and installed packages before promising features or commands.
- Synology guidance changes materially with model family, DSM version, and whether the workload depends on Btrfs-only features.
- If that context is missing, ask for it before acting like every NAS behaves the same.
2. Separate Read-Only Diagnosis From Writes
- - Start with inventory: storage health, free space, package status, backup state, and remote exposure.
- State whether the next step is read-only, additive, mutating, or destructive.
- Never jump straight from "it looks slow" to deleting data, changing shares, or reinstalling packages.
3. Treat SHR and RAID as Availability, Not Backup
- - Disk redundancy protects against some hardware failures, not ransomware, accidental deletion, bad sync, or site loss.
- Every serious plan needs restore-tested backup layers such as Hyper Backup, Snapshot Replication, rsync, or an external copy.
- If restore testing is missing, say the backup posture is incomplete.
4. Internet Exposure Is Opt-In
- - Prefer VPN or QuickConnect for remote admin convenience over raw DSM port forwarding.
- Reverse proxy and public access are explicit design choices that need MFA, update discipline, and blast-radius awareness.
- Never recommend exposing DSM, SSH, or package dashboards to the public internet by default.
5. Verify Feature Gates Before Recommending Synology Features
- - Snapshot Replication, immutable backup patterns, and some data-protection workflows depend on model support, filesystem, package availability, and licensing.
- Container Manager guidance depends on compatible models and package availability on the target DSM build.
- When a recommendation depends on support status, verify it before presenting it as available.
6. Protect Production State Before Upgrades or Rebuilds
- - Before DSM upgrades, package reinstalls, share moves, or container rewrites, confirm the recovery path and the configuration that must survive.
- Export or record key settings, confirm backup freshness, and define rollback before touching live services.
- If the user cannot explain how to undo the change, the plan is not ready.
7. End With an Execution Record
- - Finish non-trivial work with a short record: target NAS, read-only findings, chosen action, validation steps, rollback path, and open risks.
- Save only that durable summary under
~/synology/ if the user wants continuity. - This keeps later Synology work grounded in facts instead of re-discovering the same box every time.
Safety Checklist
Before high-impact Synology changes:
- - confirm the exact NAS, volume, share, and package being changed
- state whether the step is read-only, additive, mutating, or destructive
- confirm backup freshness and whether restore has ever been tested
- capture current screenshots, package versions, or config exports before upgrades or reinstalls
- ask for explicit confirmation before delete, downgrade, restore, remote exposure, or major permission changes
Common Traps
- - Treating Synology like generic Ubuntu with disks attached -> wrong service assumptions and risky cleanup advice
- Confusing SHR or RAID with backup -> false confidence until deletion, corruption, or ransomware happens
- Promising snapshots or replication without confirming filesystem and package support -> recovery plan fails when it matters
- Opening DSM or SSH to the internet "just for now" -> turns convenience into attack surface
- Recommending package reinstalls before collecting evidence -> destroys the only clues needed to fix the issue safely
- Blaming performance on CPU alone -> full volumes, indexing, broken thumbnails, parity checks, or bad remote sync often matter more
- Restoring everything at once after an incident -> increases downtime and can overwrite evidence or good data
External Endpoints
| Endpoint | Data Sent | Purpose |
|---|
| https://www.synology.com | Page requests and product references only unless the user asks for account or package actions | Verify current DSM, packages, compatibility, and official guidance |
| https://kb.synology.com |
Page requests and query text only | Confirm current product behavior and troubleshooting steps |
| https://account.synology.com | Browser session data only when the user explicitly performs account-linked tasks | Synology account, package, and service operations approved by the user |
| https://quickconnect.to | QuickConnect identifiers and connection metadata only when the user explicitly tests remote access | Remote access routing and connectivity checks |
No other data should be sent externally unless the user explicitly approves third-party backup, VPN, DNS, or monitoring services.
Security & Privacy
Data that may leave your machine:
- - documentation lookups against Synology-owned sites
- account and session traffic only when the user explicitly performs Synology account or remote-access actions
- QuickConnect identifiers and connection metadata only when remote access is actively configured or tested
Data that stays local:
- - model, package, backup, and recovery notes in INLINECODE12
- screenshots, exports, or runbooks the user chooses to keep locally
This skill does NOT:
- - ask the user to paste DSM passwords, OTP codes, or private keys into chat
- claim SHR, RAID, or sync are backups when they are not
- expose DSM or SSH publicly by default
- promise package, filesystem, or model features without verification when support matters
Trust
This skill depends on Synology-owned documentation, account surfaces, and remote-access services when the user explicitly uses them.
Only install and use it if you trust Synology with the approved operations and related metadata.
Scope
This skill ONLY:
- - plans and executes Synology DSM and NAS workflows with explicit safety gates
- covers storage, backup, remote access, package health, and Container Manager decisions
- keeps lightweight local memory in
~/synology/ when the user wants continuity - emphasizes restore-first thinking for incidents and migrations
This skill NEVER:
- - pretend all Synology models and DSM builds support the same features
- treat redundancy as backup
- run destructive storage or exposure changes without explicit confirmation
- replace specialized camera automation, enterprise SAN design, or off-platform Kubernetes guidance
Related Skills
Install with
clawhub install <slug> if user confirms:
- -
backups - Backup strategy, retention, and restore planning beyond one vendor - INLINECODE16 - Self-hosted service decisions around ownership, risk, and maintenance
- INLINECODE17 - Container architecture once the Synology host and storage plan are stable
- INLINECODE18 - Home lab and household service tradeoffs once the NAS becomes a platform
- INLINECODE19 - Private remote access when QuickConnect is not the right fit
Feedback
- - If useful: INLINECODE20
- Stay updated: INLINECODE21
何时使用
当用户需要特定于群晖的执行方案,而非通用NAS或Linux建议时使用此技能。涵盖DSM规划、存储布局、共享文件夹、远程访问、Hyper Backup、快照复制、群晖Drive、套件健康、Container Manager、迁移、升级及事件恢复。
当实际问题为这台群晖设备应如何修改、按什么顺序操作、如何避免数据丢失或DSM暴露时,应激活此技能。
架构
此技能以无状态方式处理单次群晖问题。若用户需要跨会话连续性,记忆存储在~/synology/中。若~/synology/不存在,则运行setup.md,用通俗语言解释计划中的本地笔记,并在创建文件前请求确认。结构参见memory-template.md。
text
~/synology/
|- memory.md # 型号、DSM版本、工作负载及防护规则
|- inventory.md # 存储卷、共享、套件及暴露记录
|- services.md # Container Manager、Drive、Photos、备份及应用笔记
- - incidents.md # 值得复用的故障、恢复及事后分析
快速参考
仅加载与任务匹配的最小文件。
| 主题 | 文件 | 用途 |
|---|
| 设置流程及已保存默认值 | setup.md | 安全激活并判断连续性是否必要 |
| 记忆架构及状态值 |
memory-template.md | 创建持久笔记但不存储机密 |
| 存储卷、Btrfs、SHR及共享文件夹决策 | storage-and-shares.md | 容量、快照、权限及迁移规划 |
| Hyper Backup、快照、rsync及恢复顺序 | backup-and-recovery.md | 真实备份策略及恢复排序 |
| QuickConnect、VPN、反向代理及暴露防护规则 | remote-access-and-networking.md | 远程访问及网络变更安全 |
| 套件健康、群晖Drive、Photos及Container Manager | packages-and-containers.md | 应用选择、套件排查及容器注意事项 |
| 事件排查及证据收集 | troubleshooting.md | 风险变更前的快速诊断 |
要求
- - 规划、审查或架构工作无需凭证
- 实时DSM变更可能需要Web UI的管理员访问权限及可选的SSH访问
- 在变更任何内容前,确认目标NAS是生产环境、家庭实验室还是仅用于备份
- 在删除、移除套件、重写共享权限、变更暴露方式、恢复操作或存储迁移前,需获得明确确认
数据存储
仅存储能改善后续群晖工作的上下文信息:
- - 精确型号、DSM版本及重要套件
- 影响建议的文件系统和存储卷信息
- 已批准的备份目标、恢复优先级及暴露边界
- 反复出现的故障、已确认的修复方案及特定套件的注意事项
不存储密码、QuickConnect凭证、OTP代码、序列号或包含机密的已复制支持包。
核心规则
1. 在给出群晖建议前先识别设备
- - 在承诺功能或命令前,锁定精确型号、DSM版本、存储卷布局、文件系统及已安装套件。
- 群晖建议会因型号、DSM版本及工作负载是否依赖Btrfs专属功能而发生实质性变化。
- 若缺少此上下文,在假设所有NAS行为一致前先询问。
2. 区分只读诊断与写入操作
- - 从清单开始:存储健康、可用空间、套件状态、备份状态及远程暴露情况。
- 说明下一步是只读、新增、变更还是破坏性操作。
- 切勿直接从看起来慢跳到删除数据、更改共享或重新安装套件。
3. 将SHR和RAID视为可用性而非备份
- - 磁盘冗余可应对部分硬件故障,但无法防范勒索软件、意外删除、同步错误或站点丢失。
- 每个严肃计划都需要经过恢复测试的备份层,如Hyper Backup、快照复制、rsync或外部副本。
- 若缺少恢复测试,需说明备份状态不完整。
4. 互联网暴露为选择加入
- - 远程管理便利性优先选择VPN或QuickConnect,而非原始DSM端口转发。
- 反向代理和公共访问是明确的设计选择,需要MFA、更新纪律及爆炸半径意识。
- 切勿默认推荐将DSM、SSH或套件仪表板暴露于公共互联网。
5. 在推荐群晖功能前验证功能开关
- - 快照复制、不可变备份模式及部分数据保护工作流依赖于型号支持、文件系统、套件可用性及许可。
- Container Manager建议取决于兼容型号及目标DSM版本上的套件可用性。
- 当推荐依赖于支持状态时,先验证再将其呈现为可用。
6. 在升级或重建前保护生产状态
- - 在DSM升级、套件重装、共享移动或容器重写前,确认恢复路径及必须保留的配置。
- 导出或记录关键设置,确认备份时效性,并在接触实时服务前定义回滚方案。
- 若用户无法解释如何撤销变更,则计划尚未就绪。
7. 以执行记录结束
- - 完成重要工作后提供简短记录:目标NAS、只读发现、所选操作、验证步骤、回滚路径及开放风险。
- 若用户需要连续性,仅将持久摘要保存至~/synology/。
- 这使后续群晖工作基于事实,而非每次都重新发现同一设备。
安全检查清单
在进行高影响群晖变更前:
- - 确认正在变更的确切NAS、存储卷、共享及套件
- 说明步骤是只读、新增、变更还是破坏性
- 确认备份时效性及恢复是否曾测试过
- 在升级或重装前捕获当前截图、套件版本或配置导出
- 在删除、降级、恢复、远程暴露或重大权限变更前请求明确确认
常见陷阱
- - 将群晖视为带磁盘的通用Ubuntu -> 错误的服务假设及危险的清理建议
- 混淆SHR或RAID与备份 -> 在删除、损坏或勒索软件发生前产生虚假信心
- 未确认文件系统和套件支持就承诺快照或复制 -> 恢复计划在关键时刻失败
- 将DSM或SSH开放到互联网只是暂时 -> 将便利性变为攻击面
- 在收集证据前推荐重新安装套件 -> 销毁安全修复问题所需的唯一线索
- 仅将性能问题归咎于CPU -> 存储卷满、索引、缩略图损坏、奇偶校验检查或远程同步不良往往更重要
- 事件发生后立即恢复所有内容 -> 增加停机时间并可能覆盖证据或完好数据
外部端点
| 端点 | 发送的数据 | 目的 |
|---|
| https://www.synology.com | 仅页面请求和产品引用,除非用户要求账户或套件操作 | 验证当前DSM、套件、兼容性及官方指南 |
| https://kb.synology.com |
仅页面请求和查询文本 | 确认当前产品行为及故障排除步骤 |
| https://account.synology.com | 仅当用户明确执行账户关联任务时的浏览器会话数据 | 用户批准的群晖账户、套件及服务操作 |
| https://quickconnect.to | 仅当用户明确测试远程访问时的QuickConnect标识符及连接元数据 | 远程访问路由及连接检查 |
除非用户明确批准第三方备份、VPN、DNS或监控服务,否则不应向外部发送其他数据。
安全与隐私
可能离开您设备的数据:
- - 针对群晖自有站点的文档查询
- 仅当用户明确执行群晖账户或远程访问操作时的账户和会话流量
- 仅当远程访问正在主动配置或测试时的QuickConnect标识符及连接元数据
保留在本地设备的数据:
- - ~/synology/中的型号、套件、备份及恢复笔记
- 用户选择本地保留的截图、导出或操作手册
此技能不会:
- - 要求用户在聊天中粘贴DSM密码、OTP代码或私钥
- 声称SHR、RAID或同步是备份(当它们不是时)
- 默认公开暴露DSM或SSH
- 在支持状态重要时未经验证就承诺套件、文件系统或型号功能
信任
此技能在用户明确使用时依赖群晖自有文档、账户界面及远程访问服务。
仅当您信任群晖处理已批准的操作及相关元数据时,才安装和使用它。
范围
此技能仅:
- - 在明确安全门控下规划和执行群晖DSM及NAS工作流
- 涵盖存储、备份、远程访问、套件健康及Container Manager决策
- 在用户需要连续性时在~/synology/中保留轻量本地记忆
- 对事件和迁移强调恢复优先思维
此技能绝不:
- - 假装所有群晖型号和DSM版本支持相同功能
- 将冗余视为备份
- 未经明确