Architecture¶

Architecture de référence pour une plateforme Nextcloud + Mattermost auto-hebergee.

Vue d'ensemble¶

graph TB
    subgraph "Clients"
        Browser["Navigateur"]
        Desktop["Client Desktop NC"]
        Mobile["App Mobile MM"]
    end

    subgraph "Reverse Proxy"
        RP["Caddy / Nginx<br/>TLS termination"]
    end

    subgraph "Nextcloud Stack"
        NC["Nextcloud<br/>PHP-FPM"]
        Redis["Redis<br/>Cache + File locking"]
        Collabora["Collabora CODE<br/>Edition en ligne"]
    end

    subgraph "Mattermost Stack"
        MM["Mattermost<br/>Go server"]
        Push["Push Proxy<br/>Notifications mobiles"]
    end

    subgraph "Stockage"
        PG_NC["PostgreSQL<br/>Nextcloud"]
        PG_MM["PostgreSQL<br/>Mattermost"]
        S3["MinIO / S3<br/>Fichiers"]
    end

    Browser --> RP
    Desktop --> RP
    Mobile --> RP

    RP --> NC
    RP --> MM
    RP --> Collabora

    NC --> Redis
    NC --> PG_NC
    NC --> S3
    NC --> Collabora

    MM --> PG_MM
    MM --> S3
    MM --> Push

Composants Nextcloud¶

PHP-FPM¶

Nextcloud est une application PHP exécutée par PHP-FPM. Le serveur web (integre au conteneur ou deporte vers Caddy/Nginx) transmet les requêtes a PHP-FPM via FastCGI.

PostgreSQL¶

Nextcloud stocke les metadonnees (comptes, partages, activité, tags, commentaires) dans PostgreSQL. Les fichiers eux-mêmes ne sont pas dans la base.

Redis¶

Redis remplit deux rôles :

Le file locking empeche les conflits quand plusieurs clients editent le même fichier via WebDAV. Sans Redis, Nextcloud utilise un locking base sur la BDD — nettement moins performant.

Stockage fichiers — S3 / MinIO¶

Par defaut, Nextcloud stocke les fichiers sur le système de fichiers local (data/). En production, un backend S3 (MinIO auto-heberge ou S3 compatible) est recommande :

// config/config.php (extrait)
'objectstore' => [
    'class' => '\\OC\\Files\\ObjectStore\\S3',
    'arguments' => [
        'bucket'     => 'nextcloud',
        'hostname'   => 'minio.internal',
        'port'       => 9000,
        'key'        => 'NC_ACCESS_KEY',
        'secret'     => 'NC_SECRET_KEY',
        'use_ssl'    => true,
        'region'     => 'us-east-1',
        'use_path_style' => true,
    ],
],

Collabora CODE¶

Collabora Online Development Edition est une version de LibreOffice Online empaquetee dans un conteneur Docker/Podman. Nextcloud communique avec Collabora via le protocole WOPI (Web Application Open Platform Interface).

sequenceDiagram
    participant User as Navigateur
    participant NC as Nextcloud
    participant CO as Collabora

    User->>NC: Ouvrir document.docx
    NC->>NC: Generer token WOPI
    NC->>User: Rediriger vers Collabora (iframe)
    User->>CO: Charger editeur (WOPI token)
    CO->>NC: Recuperer fichier (WOPI GetFile)
    User->>CO: Editer le document
    CO->>NC: Sauvegarder (WOPI PutFile)

Composants Mattermost¶

Serveur Go¶

Mattermost est un binaire Go unique qui sert à la fois l'API REST, le serveur WebSocket et l'interface web. Cette architecture monolithique simplifie le déploiement.

PostgreSQL¶

Mattermost stocke messages, canaux, équipes, utilisateurs et réactions dans PostgreSQL. Le schema est versionne et les migrations sont automatiques au demarrage.

Stockage fichiers¶

Les fichiers envoyes dans les canaux sont stockes sur le disque local ou dans un bucket S3 :

{
  "FileSettings": {
    "DriverName": "amazons3",
    "AmazonS3AccessKeyId": "MM_ACCESS_KEY",
    "AmazonS3SecretAccessKey": "MM_SECRET_KEY",
    "AmazonS3Bucket": "mattermost",
    "AmazonS3Endpoint": "minio.internal:9000",
    "AmazonS3SSL": true,
    "AmazonS3PathPrefix": "files"
  }
}

Push Proxy¶

Les notifications push mobiles passent par un serveur proxy. Mattermost fournit un proxy open source (mattermost-push-proxy) que vous pouvez auto-héberger pour eviter de transiter par les serveurs Mattermost Inc.

graph LR
    MM["Mattermost Server"] -->|"notification"| PP["Push Proxy<br/>(auto-heberge)"]
    PP -->|"APNs"| iOS["iPhone"]
    PP -->|"FCM"| Android["Android"]

Reverse proxy¶

Caddy (ou Nginx) assure la terminaison TLS et le routage par sous-domaine :

# Caddyfile (extrait)
cloud.example.com {
    reverse_proxy nextcloud:8080
    request_body {
        max_size 16GB
    }
}

chat.example.com {
    reverse_proxy mattermost:8065
}

office.example.com {
    reverse_proxy collabora:9980 {
        transport http {
            tls_insecure_skip_verify
        }
    }
}

Dimensionnement¶

Petite équipe (< 50 utilisateurs)¶

Équipe moyenne (50-200 utilisateurs)¶

Grande équipe (200+ utilisateurs)¶

Pour les installations de plus de 200 utilisateurs, passez a une architecture haute disponibilité (voir Bonnes pratiques) :

• Nextcloud multi-instance derriere un load balancer
• Mattermost cluster (licence Enterprise)
• PostgreSQL en réplication (primaire + replicas)
• MinIO distribue (4+ nœuds, erasure coding)
• Collabora multi-instance avec load balancing WOPI

Flux réseau¶