[Linux] - Video surveillance avec motion et motion-UI

EN version : https://en.linuxdocs.net/en/latest/guides/motionui.html

Motion-UI est une interface web (User Interface) développée pour gérer plus aisémment le fonctionnement et la configuration de motion, un célèbre logiciel open-source de détection de mouvement généralement utilisé pour faire de la vidéo surveillance.

Il s’agit d’un projet open-source disponible sur github : https://github.com/lbr38/motion-UI

Présentation

L’interface se présente comme étant très simpliste et responsive, ce qui permet une utilisation depuis un mobile sans avoir à installer une application. Les gros boutons principaux permettent d’exécuter des actions rapides avec précision sur mobile même lorsque la vision n’est pas optimale (soleil, mouvements…).

Elle permet en outre de mettre en place des alertes mail en cas de détection et d’activer automatiquement ou non la vidéo-surveillance en fonction d’une plage horaire ou de la présence de périphériques « de confiance » sur le réseau local (smartphone…).

L’interface web se décompose en deux parties :

La page principale dédiée principalement dédiée à motion, permettant de démarrer/stopper le service ou de configurer des alertes en cas de détection. Quelques graphiques permettent de résumer l’activité récente du service et des évènements (events) aillant eu lieu, avec également la possibilité de visualiser les images ou vidéos capturées directement depuis la page web.
Une page live dédiée à la visualisation en direct des flux des caméras. Les caméras sont alors disposées en grilles à l’écran (du moins sur un écran PC) un peu à la manière des écrans de vidéo-surveillance d’un établissement par exemple.

Pré-requis

Il est préconisé de dédier un serveur uniquement à l’exécution de motion-UI, et qu’il soit le point d’entrée unique pour la vidéo-surveillance sur le réseau local : les caméras diffusent leur stream au serveur et c’est le serveur qui analyse les images et détecte d’éventuels mouvements et avertit l’utilisateur. La visualisation des caméras se fait également par le biais du serveur depuis l’interface motion-UI. C’est ce cas de figure qui sera détaillé ici.

L’installation doit se faire en root ou avec sudo.

Installer docker et docker-compose :

# Installation du repository docker (cas pour Debian ici, voir la doc officielle pour d'autres distributions : https://docs.docker.com/engine/install/)
apt install ca-certificates curl gnupg -y
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo \
"deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
"$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Installation de docker
apt update -y
apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose docker-compose-plugin -y

Il faudra également :

Un nom de domaine dédié à motion-UI (motionui.mondomaine.com par exemple) ainsi qu’un enregistrement SPF pour ce nom de domaine (utile pour pouvoir recevoir correctement les alertes mails).
Un certificat SSL pour ce nom de domaine afin de sécuriser l’accès à motion-UI (HTTPS).

Si vous souhaitez pouvoir vous rendre sur motion-UI depuis l’extérieur, il faudra également :

Soit un VPN vous permettant de vous connecter à votre réseau local depuis l’extérieur.
Soit un enregistrement DNS faisant pointer motionui.mondomaine.com vers votre box, avec des redirections de ports de votre box/routeur vers le serveur motion-UI (attention le site sera alors accessible publiquement, veiller à mettre en place des règles de pare-feu pour limiter l’accès si cela est possible).

Installation

L’installation doit se faire avec un utilisateur lambda (non root).

Cloner le repo :

git clone https://github.com/lbr38/motion-UI.git

Puis éditer le fichier docker-compose.yml

cd motion-UI/docker
vim docker-compose.yml

Et modifier la ligne suivante :

fqdn: motionui.example.com (à remplacer par le nom de domaine dédié à motion-UI)

Builder et exécuter l’image docker :

docker-compose up -d

Deux volumes persistants sont alors créés sur le système hôte :

motionui_data (/var/lib/docker/volumes/motionui-data/) : contient la base de données de motion-UI
motionui-captures (/var/lib/docker/volumes/motionui-captures/) : contient les captures d’images et vidéos réalisées par motion (à conserver donc!)

Une fois l’installation terminée, poursuivre par la mise en place d’un reverse-proxy pour accéder à motion-UI par son nom de domaine.

Reverse-proxy

La mise en place d’un reverse-proxy va permettre d’accéder à motion-UI avec le nom de domaine qui lui a été dédié et de manière sécurisée (HTTPS).

L’installation doit se faire en root ou avec sudo

Installer nginx si ce n’est pas déjà fait :

apt install nginx -y

Supprimer le vhost par défaut :

rm /etc/nginx/sites-enabled/default

Puis créer un nouveau vhost dédié à motion-UI :

vim /etc/nginx/sites-available/motionui.conf

Insérer le contenu suivant en remplacant les valeurs :

<SERVER-IP> : l’adresse IP du serveur
<FQDN> : le nom de domaine dédié à motion-UI
<PATH_TO_CERTIFICATE> : le chemin vers le certificat SSL
<PATH_TO_PRIVATE_KEY> : le chemin vers la clé privée du certificat SSL

upstream motionui_docker {
    server 127.0.0.1:8080;
}

# Disable some logging
map $request_uri $loggable {
    /ajax/controller.php 0;
    default 1;
}

server {
    listen <SERVER-IP>:80;
    server_name <FQDN>;

    access_log /var/log/nginx/<FQDN>_access.log combined if=$loggable;
    error_log /var/log/nginx/<FQDN>_error.log;

    return 301 https://$server_name$request_uri;
}

server {
    listen <SERVER-IP>:443 ssl;
    server_name <FQDN>;

    # Path to SSL certificate/key files
    ssl_certificate <PATH_TO_CERTIFICATE>;
    ssl_certificate_key <PATH_TO_PRIVATE_KEY>;

    # Path to log files
    access_log /var/log/nginx/<FQDN>_ssl_access.log combined if=$loggable;
    error_log /var/log/nginx/<FQDN>_ssl_error.log;

    # Security headers
    add_header Strict-Transport-Security "max-age=15768000; includeSubDomains; preload;" always;
    add_header Referrer-Policy "no-referrer" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-Download-Options "noopen" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Permitted-Cross-Domain-Policies "none" always;
    add_header X-Robots-Tag "none" always;
    add_header X-XSS-Protection "1; mode=block" always;

    # Remove X-Powered-By, which is an information leak
    fastcgi_hide_header X-Powered-By;

    location / {
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_pass http://motionui_docker;
    }
}

Activer le vhost :

ln -s /etc/nginx/sites-available/motionui.conf /etc/nginx/sites-enabled/motionui.conf

Recharger nginx :

nginx -t && systemctl reload nginx

Se connecter à motion-UI depuis un navigateur web via https://motionui.mondomaine.com

Utiliser les identifiants par défaut pour s’authentifier :

Login : admin
Mot de passe : motionui

Une fois connecté, il est possible de modifier son mot de passe depuis l’espace utilisateur (en bas à droite).

Ajout d’une caméra

Utiliser le bouton + en haut de page pour ajouter une caméra.

Préciser si la caméra diffuse un flux video ou seulement une image statique qui nécessite un rechargement (si oui préciser l’intervalle de rafraîchissement en secondes).
Préciser alors un nom et l’URL vers le flux video/image de la caméra
Choisir ou non de rediffuser le flux video/image sur motion-UI (dans les paramètres généraux on peut ensuite choisir de diffuser ce flux sur la page principale, sur la page live ou les deux).
Choisir d’activer la détection de mouvement (motion) sur cette caméra. Attention si le flux sélectionné est une image statique alors il faudra préciser une seconde URL pointant vers un flux video car motion est incapable de faire de la détection de mouvement sur un flux d’images statiques (il n’est pas capable de recharger automatiquement l’image).
Préciser un utilisateur / mot de passe si le flux est protégé (beta).

Une fois la camera ajoutée :

motion-UI se charge de créer automatiquement la configuration motion pour cette caméra. A noter que la configuration motion créée est relativement minimaliste mais suffisante pour fonctionner dans tous les cas. Il est possible de modifier cette configuration en mode avancé et d’ajouter ses propres paramètres si besoin (voir partie Configuration d’une caméra).
Le flux de la caméra devient visible depuis la page principale, la page live (ou les deux) selon la configuration globale choisie.

Configuration d’une caméra

Si le besoin de modifier la configuration d’une caméra se fait sentir, il suffit de cliquer sur le bouton Configure.

D’ici il est possible de modifier les paramètres généraux de la caméra (nom, URL, etc.), de changer la rotation de l’image.

Il est également possible de modifier la configuration motion de la caméra (détection de mouvement).

Attention, il est préconisé d”éviter de modifier les paramètres motion en mode avancé, ou du moins pas sans savoir précisément ce que l’on fait.

Par exemple il vaut mieux éviter de modifier les paramètres suivants :

les paramètres de nom et d’URL (camera_name, netcam_url, netcam_userpass et rotate) ont des valeurs issues des paramètres généraux de la caméra. Il convient donc de les modifier directement depuis les champs Global settings.
les paramètres liés aux codecs (picture_type et movie_codec) ne doivent pas être modifiés sous peine de ne plus pouvoir visualier les captures directement depuis motion-UI.
les paramètres d’évènements (on_event_start, on_event_end, on_movie_end et on_picture_save) ne doivent pas être modifiés sous peine de ne plus pouvoir enregistrer les évènements de détection de mouvement, et de ne plus recevoir d’alertes.

Tester l’enregistrement des évènements

Pour cela depuis l’interface motion-UI : démarrer manuellement motion (bouton Start capture).

Puis faire un mouvement devant une caméra pour déclencher un évènement.

Si tout se passe bien, un nouvel évènement en cours devrait apparaitre après quelques secondes dans l’interface motion-UI.

Démarrage et arrêt automatique de motion

Utiliser le bouton Enable and configure autostart pour activer et configurer le démarrage automatique.

Il est possible de configurer deux types de démarrages et arrêts automatiques de motion :

En fonction des plages horaires renseignées pour chaque journée. Le service motion sera alors actif entre la plage d’horaire renseignée.
En fonction de la présence d’un ou plusieurs appareils IP connecté(s) sur le réseau local. Si aucun des appareils configurés n’est présent sur le réseau local alors le service motion démarrera, considérant que personne n’est présent au domicile. Motion-UI envoi régulièrement un ping pour déterminer si l’appareil est présent sur le réseau, il faut donc veiller à configurer des baux d’IP statiques depuis la box pour chaque appareil du domicile (smartphones).

Configurer les alertes

Utiliser le bouton Enable and configure alerts pour activer et configurer les alertes.

La configuration des alertes nécessite deux points de configuration :

Un enregistrement SPF pour le nom de domaine dédié à motion-UI.
L’enregistrement des évènements doit fonctionner (voir “Tester l’enregistrement des évènements”)

Configuration des créneaux horaires d’alertes

Renseigner les créneaux horaires entre lesquels vous souhaitez recevoir des alertes si détection il y a. Pour activer les alertes toute une journée, il convient de renseigner 00:00 pour le créneau de début ET de fin.
Renseigner l’adresse mail destinataire qui recevra les alertes mails. Plusieurs adresses mails peuvent être spécifiées en les séparant par une virgule.

Tester les alertes

Une fois que les points précédemment évoqués ont été correctement configurés et que le service motionui est bien en cours d’exécution, il est possible de tester l’envoi d’alertes.

Pour cela depuis l’interface motion-UI :

Désactiver temporairement l’autostart de motion si activé, pour éviter qu’il ne stoppe motion au cas où.
Démarrer manuellement motion (Start capture)

Puis faire un mouvement devant une caméra pour déclencher une alerte.

Pour tout problème, n’hésitez pas à poser une question sur le dépôt du développeur ou à ouvrir une nouvelle issue :