核心用法
Synology Surveillance Station Skill 是一个基于 Bash 脚本的命令行工具，通过调用 Synology NAS 的 Surveillance Station Web API 实现对 IP 摄像头的远程管理。用户需在 TOOLS.md 中配置 NAS 连接信息（主机地址、端口、用户名、密码、HTTPS 开关），或直接通过环境变量传入。核心功能包括：会话管理（login/logout）、摄像头列表查询、快照抓取、手动录像控制、事件日志检索、直播流 URL 生成，以及对 PTZ（Pan-Tilt-Zoom）云台摄像头的方向控制和预置位调用。
显著优点
1. 原生 API 支持：直接对接 Synology 官方 Web API，无需第三方中转，延迟低且稳定
2. 功能全面：覆盖监控场景的核心需求——从静态快照到动态云台控制，从实时流到历史事件回溯
3. 灵活集成：提供 shell 命令封装，可轻松嵌入 Home Assistant 等智能家居平台的自动化流程
4. 轻量无依赖：仅需 curl、jq 和 Bash 环境，无复杂运行时或容器要求
潜在缺点与局限性
- 安全限制：要求 API 用户必须禁用 2FA，存在账户安全降级风险
- 网络依赖：仅支持局域网或 VPN 场景，无外网穿透方案
- 许可证成本：Surveillance Station 超出 2 路免费摄像头后需购买授权
- 无加密传输默认：默认使用 HTTP（端口 5000），需手动启用 HTTPS
- 错误处理简略：脚本级错误提示较基础，复杂故障需手动排查 API 返回
适合人群
- 已部署 Synology NAS 且启用 Surveillance Station 的家庭/小型办公用户
- 需要将摄像头控制集成到现有自动化工作流的技术爱好者
- 偏好命令行操作、追求低资源占用的开发者与系统管理员
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | 密码以明文存储于 `TOOLS.md` 或环境变量 | 使用专用受限账户，限制文件权限 600 |
| 中间人攻击 | 默认 HTTP 传输，数据可能被窃听 | 强制启用 HTTPS（端口 5001）并验证证书 |
| 会话劫持 | Cookie 文件 `cookies.txt` 本地存储 | 及时执行 `logout`，避免在共享环境使用 |
| 未授权访问 | 2FA 禁用后账户防护减弱 | 限制 NAS 管理 IP，启用防火墙白名单 |
| API 滥用 | 频繁快照/录像可能触发速率限制 | 合理设置调用间隔，监控 NAS 负载 |