Installer portracker avec Docker

zarev 28 août 2025 5 min de lecture

Table des matières

Centraliser la surveillance des ports ouverts, que ce soit de vos containers Docker et/ou du système, de manière esthétique et facilement, c'est possible !

Aujourd'hui nous allons parler de portracker ! Vous pourrez, en temps réel, avoir un œil sur les ports ouverts et le service s'y rapportant. Déployez portracker sur l'ensemble de vos serveurs et centralisez-les sur une seule instance.

Notez qu'il y a deux méthodes pour installer portracker, une où il y a un accès direct au socket de Docker et une, par un proxy :

Pour renforcer la sécurité, vous pouvez exécuter Portracker sans accès direct au socket Docker en utilisant un proxy. Cela limite les autorisations de l'API Docker aux opérations en lecture seule.

C'est cette méthode que nous allons choisir.

⚡ Caractéristiques

Détection automatique des ports : analyse le système hôte pour trouver et afficher automatiquement les services en cours d'exécution et leurs ports. Aucune saisie manuelle de données n'est nécessaire.
Collecteurs spécifiques à la plateforme : comprend des collecteurs spécialisés pour Docker et TrueNAS afin de recueillir des informations contextuelles riches à partir de l'hôte.
Détection des ports internes : distingue les ports internes des conteneurs et les ports hôtes publiés, offrant une visibilité complète sur les services conteneurisés.
Léger et autonome : s'exécute comme un processus unique avec une base de données SQLite intégrée. Aucune dépendance à une base de données externe telle que PostgreSQL ou Redis n'est requise.
Surveillance peer-to-peer : ajoutez d'autres instances de portracker en tant que pairs pour afficher tous vos serveurs, conteneurs et machines virtuelles à partir d'un seul tableau de bord.
Regroupement hiérarchique : organisez les serveurs dans une structure parent-enfant, parfaite pour imbriquer les serveurs, par exemple l'instance portracker d'une machine virtuelle sous son hôte physique.
Découverte TrueNAS améliorée : une clé API TrueNAS optionnelle permet à portracker de découvrir les machines virtuelles en cours d'exécution* et de recueillir des informations système améliorées telles que la version du système d'exploitation et le temps de fonctionnement.
* Remarque : les machines virtuelles détectées sur TrueNAS avec la clé API facultative sont affichées en mode lecture seule. Pour activer la surveillance complète, déployez une instance Portracker sur chaque machine virtuelle et ajoutez-la en tant que serveur distinct.
Interface utilisateur moderne et réactive : tableau de bord épuré avec modes clair/foncé, filtrage en direct et plusieurs affichages des données (liste, grille, tableau).

💾 Installation

Prérequis

Avant de commencer, assurez-vous d’avoir :

Distribution Linux (Ubuntu, Debian, etc ...).
Docker installé.
Accès terminal.
Connexion internet.

Étapes d'installation

Créez votre compose.yml dans le dossier ou vous comptez installer portracker :

nano compose.yml

Et collez ça dedans :

services:
  docker-proxy:
    image: tecnativa/docker-socket-proxy:latest
    container_name: portracker-docker-proxy
    restart: unless-stopped
    environment:
      - CONTAINERS=1
      - IMAGES=1
      - INFO=1
      - NETWORKS=1
      - POST=0
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    ports:
      - "2375:2375"

  portracker:
    image: mostafawahied/portracker:latest
    container_name: portracker
    restart: unless-stopped
    pid: "host"
    cap_add:
      - SYS_PTRACE
      - SYS_ADMIN
    security_opt:
      - apparmor:unconfined
    volumes:
      - ./portracker-data:/data
    ports:
      - "4999:4999"
    environment:
      - DOCKER_HOST=tcp://docker-proxy:2375
    depends_on:
      - docker-proxy

Si vous avez un message de ce type :