Intégration domotique Synology Surveillance Station, gratuite et open source
Synology Surveillance Station en local : images, mouvements, caméras activées, mode Maison.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Vos caméras Synology Surveillance Station dans Gladys, en local, par l’API Web de DSM (sans cloud, sans QuickConnect) :
- chaque caméra devient une caméra Gladys : son image sur le tableau de bord, un instantané tout frais en vue en direct ;
- son état activé dans Surveillance Station (la commande marche / arrêt des caméras de Gladys) ;
- un détecteur de mouvement par caméra, et le déclencheur de scène Mouvement détecté (événements de détection de mouvement ou d’analyse vidéo) ;
- le mode Maison de Surveillance Station : lu, commandé, et le déclencheur de scène Mode Maison changé.
Jamais testé sur un vrai NAS. Cette première version a été écrite d’après le guide de l’API Web de Surveillance Station et d’après py-synologydsm-api, et testée seulement contre un faux NAS. Merci de signaler ce qui fonctionne ou non sur le forum de Gladys.
Intégration non officielle, sans lien avec Synology.
Avant de commencer : un compte dédié
- Dans DSM, Panneau de configuration → Utilisateur et groupe, créez un
utilisateur
gladysavec un mot de passe solide. Il n’a besoin d’aucun dossier partagé ni d’aucune autre application. - Dans Surveillance Station → Paramètres de privilèges (profils de
privilèges), donnez-lui un profil :
- la lecture seule (spectateur) suffit pour les images, les détecteurs de mouvement et la lecture du mode Maison ;
- pour activer / désactiver les caméras ou commander le mode Maison depuis Gladys, le profil doit le permettre (gestionnaire, ou un profil personnalisé avec ces droits).
- Validation en deux étapes : préférez un compte sans (le compte sert à une machine). Si DSM l’impose à tous les comptes, voyez plus bas.
Configuration
- Adresse du NAS :
https://192.168.1.10:5001. Une adresse seule est lue en https sur le port 5001. Évitezhttp://192.168.1.10:5000: le mot de passe et la session traverseraient votre réseau en clair. - Identifiant / mot de passe DSM : le compte dédié. Le mot de passe est gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à votre NAS.
- Code de validation en deux étapes : seulement pour un compte avec
validation en deux étapes. Saisissez un code à 6 chiffres tout frais de
votre application d’authentification et enregistrez aussitôt (un code dure
30 s). Gladys garde ensuite le jeton d’appareil donné par DSM (dans son
volume
/data) et n’a plus besoin de code. Un code n’est envoyé qu’une fois ; le champ est masqué comme le mot de passe. - Accepter le certificat auto-signé du NAS : désactivé par défaut, le certificat doit alors venir d’une autorité reconnue (Let’s Encrypt…). Activé : le certificat vu à la première connexion est accepté et mémorisé ; un autre ensuite est refusé (quelqu’un se fait peut-être passer pour votre NAS) tant que vous n’appuyez pas sur Faire confiance au nouveau certificat.
- Autoriser la réduction de la surveillance : désactivé par défaut (voir Commandes).
- Lecture des mouvements : de 5 s à 1 min (10 s par défaut).
- Rafraîchissement de l’image du tableau de bord : aucun, ou de 30 s à 10 min.
Ouvrez ensuite l’onglet Découverte et créez les caméras et l’appareil Surveillance Station (mode Maison) voulus.
Commandes
- Activer une caméra et quitter le mode Maison ajoutent de la surveillance : toujours possibles.
- Désactiver une caméra et activer le mode Maison réduisent la surveillance (moins d’enregistrements, moins d’alertes) : Gladys refuse les deux tant que vous ne cochez pas Autoriser la réduction de la surveillance. Laissez-le décoché si une scène ou un autre utilisateur ne doit pas pouvoir aveugler vos caméras.
- Les commandes passent une par une. Juste avant d’agir, Gladys relit l’état sur le NAS : s’il n’y arrive pas (ou si le NAS ne le dit pas), rien n’est envoyé ; si le NAS est déjà dans l’état demandé, rien n’est envoyé non plus. Quand le NAS répond trop lentement (plus de 3,5 s), rien n’est envoyé et Gladys affiche un échec (jamais d’action après un échec affiché). Si vous décochez Autoriser la réduction de la surveillance ou changez la configuration pendant qu’une commande attend, elle n’est pas envoyée.
- Un échec dit si la commande n’a pas été envoyée (elle n’a pas pu joindre le NAS) ou a été envoyée sans confirmation (l’état est alors relu).
Mouvements
Surveillance Station ne pousse pas ses événements vers Gladys : Gladys lit
les événements récents au rythme choisi. Un événement de mouvement ou
d’analyse vidéo déclenche une fois Mouvement détecté (avec la caméra, son
nom et motion ou analytics) et active le détecteur de mouvement de la
caméra ; le détecteur revient à « pas de mouvement » une fois l’événement
terminé.
En marche normale, chaque nouvel événement déclenche, quelles que soient les
horloges. Seule la lecture de rattrapage (après un démarrage de
l’intégration, une reconnexion à Gladys ou une panne du NAS) se limite aux
événements terminés (ou encore en cours) il y a moins de 2 minutes : les
anciens événements d’une panne sont marqués vus sans rafale de
déclenchements. Gladys garde dans son volume /data les derniers événements
traités, aucun ne déclenche donc deux fois après un redémarrage. Les 2
minutes se comptent en heure du NAS (Gladys lit l’horloge du NAS dans ses
réponses), mais gardez les deux horloges synchronisées (NTP, dans DSM :
Panneau de configuration → Options régionales → Heure) pour que ce
rattrapage soit exact. La détection
de mouvement doit être activée sur la caméra dans Surveillance Station
(paramètres de détection d’événements).
Problèmes de connexion
- Mauvais mot de passe, compte verrouillé ou expiré : Gladys ne réessaie pas seul, car DSM bloque une adresse après quelques échecs de connexion (blocage automatique). Corrigez la configuration et enregistrez-la, ou appuyez sur Tester la connexion.
- NAS injoignable : nouvel essai après 30 s, puis jusqu’à toutes les 10 min ; les caméras sont affichées injoignables en attendant.
- Session perdue (DSM redémarré, session expirée) : renouvelée une fois, jamais en boucle (une connexion toutes les 30 s au plus).
- NAS surchargé (HTTP 429) : toutes les requêtes s’arrêtent de 1 minute à 6 heures, aussi longtemps que le NAS le demande (Retry-After), même après un redémarrage ; enregistrer la configuration ou appuyer sur Tester la connexion lève la pause. Erreur serveur (HTTP 5xx, DSM qui redémarre ou se met à jour) : nouvel essai comme pour un NAS injoignable.
Limites
- Un seul NAS par intégration. Les images sont des instantanés (pas de flux vidéo en direct dans Gladys) ; un instantané plus lourd que ce que Gladys accepte (150 Ko) est redemandé dans le profil « faible bande passante », sinon il n’est pas affiché. L’image du tableau de bord vise 60 Ko et monte jusqu’à 150 Ko pour une caméra dont les instantanés n’y tiennent jamais.
- Le détecteur de mouvement et le déclencheur ont un retard d’au plus le rythme choisi.
- Seuls les événements de mouvement (raison 2) et d’analyse vidéo (7) comptent comme mouvement ; les autres enregistrements (continu, manuel, entrée d’alarme) sont ignorés. Ces codes viennent du guide de l’API et ne sont pas encore vérifiés.
- Non testé avec Surveillance Station sur un VisualStation Synology, des serveurs d’enregistrement CMS ou C2 Surveillance.
Paramètres de configuration
Voici les paramètres demandés par Synology Surveillance Station dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Fonctionnement | section | Non | Gladys dialogue avec Surveillance Station sur votre NAS Synology, sur votre réseau, par l'API Web de DSM. Chaque caméra de Surveillance Station devient une caméra Gladys (onglet Découverte) avec son image, son état activé et un détecteur de mouvement ; le mode Maison de Surveillance Station devient un interrupteur. Créez un compte DSM dédié à Gladys, sans validation en deux étapes, avec accès à Surveillance Station seulement (voir la documentation). Intégration non officielle, sans lien avec Synology. |
| Adresse du NAS | string | Oui | L'adresse de DSM sur votre réseau : https://<IP>:5001. Une adresse seule est lue en https sur le port 5001. Évitez http://<IP>:5000 : le mot de passe et la session traverseraient votre réseau en clair. |
| Identifiant DSM | string | Oui | |
| Mot de passe DSM | secret | Oui | Gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à votre NAS. |
| Code de validation en deux étapes | secret | Non | Seulement si le compte utilise la validation en deux étapes : un code à 6 chiffres tout frais de votre application d'authentification, enregistré aussitôt. Gladys garde ensuite un jeton d'appareil et ne le redemande plus ; le code ne sert qu'une fois. |
| Accepter le certificat auto-signé du NAS | boolean | Non | Désactivé : le certificat doit venir d'une autorité reconnue. Activé : le certificat vu à la première connexion est accepté et mémorisé ; un autre ensuite est refusé tant que vous n'appuyez pas sur « Faire confiance au nouveau certificat ». |
| Commandes | section | Non | Activer une caméra et quitter le mode Maison sont toujours possibles depuis Gladys. Désactiver une caméra ou passer en mode Maison réduit la surveillance (moins d'enregistrements, moins d'alertes) : Gladys refuse les deux tant que vous ne les autorisez pas ci-dessous. Le compte a alors besoin d'un profil de privilèges Surveillance Station qui peut modifier les caméras et le mode Maison. |
| Autoriser la réduction de la surveillance (désactiver une caméra, activer le mode Maison) | boolean | Non | |
| Rafraîchissement | section | Non | Surveillance Station ne pousse pas ses événements vers Gladys : Gladys lit les événements récents au rythme ci-dessous (détecteurs de mouvement et déclencheur « Mouvement détecté »), et les caméras et le mode Maison chaque minute. |
| Lecture des mouvements | select | Oui | |
| Rafraîchissement de l'image du tableau de bord | select | Oui |
Comment installer Synology Surveillance Station dans Gladys
- Dans Gladys, ouvrez Intégrations : Synology Surveillance Station apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/lm1lc3n7/gladys-synology-surveillance:0.1.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-synology-surveillance.
Synology Surveillance Station nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Synology Surveillance Station est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par LM1LC3N7, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation