🖥️ Tutoriel NAS UGREEN DXP2800XP — Héberger ton site martial arts

01

🔍 Vérifier l'accès au NAS

1

Trouver l'adresse IP de ton NAS

Ton NAS a une adresse IP sur ton réseau local. Tu as 3 façons de la trouver :

Méthode 1 — Depuis ton Mac (Terminal)

# Scanner le réseau local pour trouver le NAS
ping -c 1 ugreennas.local

# Si ça ne marche pas, scanner toutes les IPs du réseau
arp -a | grep -i "ugreen"

# Alternative : scanner le réseau complet
nmap -sn 192.168.1.0/24

Méthode 2 — Depuis l'app UGREEN

📱 Ouvre l'app UGREEN sur ton téléphone
→ Ton NAS apparaît avec son IP locale (ex: 192.168.1.100)
→ Note cette adresse, tu en auras besoin partout

Méthode 3 — Depuis ton routeur/box internet

🌐 Connecte-toi à l'interface de ta box (192.168.1.1 ou 192.168.0.1)
→ Section "Appareils connectés" ou "DHCP"
→ Cherche un appareil nommé "UGREEN" ou "DXP2800XP"
→ Note l'IP (ex: 192.168.1.100)

💡 Conseil : Pour la suite du tuto, on utilisera 192.168.1.100 comme exemple. Remplace-la par l'IP réelle de ton NAS dans chaque commande.

2

Se connecter au panneau UGOS

UGOS est le système d'exploitation de ton NAS UGREEN. C'est l'interface web qui contrôle tout.

🌐 Ouvre ton navigateur (Safari, Chrome, Firefox)
→ Tape : http://192.168.1.100:9443
→ Connecte-toi avec tes identifiants UGOS (ceux créés lors de la config initiale)

✅ Tu devrais voir le bureau UGOS avec les icônes d'applications

⚠️ Pas d'accès ? Vérifie que ton Mac est sur le même réseau Wi-Fi/Ethernet que le NAS. Si le port 9443 ne marche pas, essaye :80 ou :5000 selon ta config.

3

Vérifier que Docker est activé

Docker est le cœur de notre solution. Il permet de faire tourner un serveur web (Nginx) dans un conteneur isolé.

📦 Dans UGOS, ouvre l'application "Docker"
→ Si elle n'apparaît pas : va dans App Center → cherche "Docker" → Installer
→ Si elle est déjà là : clique dessus → vérifie que le service est Actif (Running)

✅ Docker est prêt quand tu vois l'interface avec les onglets : Container, Image, Network, Volume

4

Vérifier l'espace disque

Le site martial arts est très léger (~2 Mo). Vérifie quand même l'espace disponible.

💾 Dans UGOS → Panneau de contrôle → Stockage
→ Tu vois l'espace total et utilisé de tes volumes
→ Il te faut au minimum 500 Mo libres (pour Docker + Nginx + site)

5

Recommandé : Fixer l'IP du NAS (DHCP réservation)

Par défaut, l'IP du NAS peut changer à chaque redémarrage du routeur. Pour éviter ça, fixe-la.

🔒 Sur ton routeur/box → section DHCP ou Baux statiques
→ Ajoute un bail pour le NAS : MAC address du NAS → IP fixe 192.168.1.100

Alternative UGOS : Panneau de contrôle → Réseau → IPv4 → Manuel
→ IP : 192.168.1.100
→ Masque : 255.255.255.0
→ Passerelle : 192.168.1.1
→ DNS : 8.8.8.8

✅ Prérequis validés ! Tu as l'IP du NAS, l'accès UGOS, Docker installé, et assez d'espace. On passe à la préparation du dossier.

02

📂 Créer la structure de dossiers

1

Créer le dossier partagé "docker"

On va créer un dossier dédié pour les données Docker sur le NAS.

📁 Ouvre le Gestionnaire de fichiers dans UGOS
→ Navigue vers le volume principal (souvent /volume1)
→ Clique "Nouveau dossier" → Nomme-le : docker
→ Dans docker/, crée un sous-dossier : MartialApp
→ Dans MartialApp/, crée deux sous-dossiers : site et nginx

        Structure finale sur le NAS :

        /volume1/docker/MartialApp/site/ → contiendra les fichiers HTML

        /volume1/docker/MartialApp/nginx/ → contiendra la config Nginx

2

Alternative : créer les dossiers en SSH

Si tu préfères la ligne de commande (plus rapide) :

Terminal (SSH vers le NAS)

# Se connecter au NAS en SSH
ssh admin@192.168.1.100

# Créer toute l'arborescence d'un coup
mkdir -p /volume1/docker/MartialApp/site
mkdir -p /volume1/docker/MartialApp/nginx

# Vérifier
ls -la /volume1/docker/MartialApp/

💡 SSH désactivé ? Dans UGOS → Panneau de contrôle → Terminal → Active "Activer le service SSH". Le port par défaut est 22.

3

Liste complète des fichiers à transférer

Voici tous les fichiers de ton projet MartialApp qui doivent être copiés dans /volume1/docker/MartialApp/site/ :

📄index.html— Page d'accueil principale

📄Mon_Art_Martial.html— Synthèse personnalisée

📄Programme_Preparation.html— Programme 6 mois

📄Seance_du_Jour.html— Séance quotidienne

📄Kajukenbo.html— Art principal

📄Kali_Arnis_Eskrima.html— Art philippin

📄Nihon_Bu_Jutsu_Ryu.html— Art japonais

📄Objectif_Corps.html— Vision corporelle

📄DEPLOIEMENT_GUIDE.html— Guide déploiement web

📄GUIDE_DOMAINE_GRATUIT.html— Guide domaine + login + NAS

📄TUTO_NAS_UGREEN.html— Ce tutoriel

🖼️icon-192.png— Icône PWA 192×192

🖼️icon-512.png— Icône PWA 512×512

🖼️corps_ref_1_1.jpeg— Image référence corps

⚙️manifest.json— Manifeste PWA

⚙️sw.js— Service Worker (cache offline)

⚠️ Important : Ne transfère PAS les fichiers .py, .md, ou .git/. Seulement les fichiers listés ci-dessus (15 fichiers). Ce sont les seuls nécessaires pour que le site fonctionne.

3A

🌐 Méthode A : Interface web UGOS (glisser-déposer)

La plus simple. Aucune configuration requise. Tout se fait dans le navigateur.

1

Ouvrir le gestionnaire de fichiers UGOS

Connecte-toi à UGOS (http://192.168.1.100:9443) → ouvre le Gestionnaire de fichiers

2

Naviguer vers le dossier site

Dans le gestionnaire → navigue vers /volume1/docker/MartialApp/site/

3

Glisser-déposer les fichiers

📁 Sur ton Mac, ouvre le Finder → va dans ~/Projects/MartialApp/
→ Sélectionne TOUS les fichiers .html + .png + .jpeg + manifest.json + sw.js
→ Glisse-les directement dans la fenêtre du gestionnaire UGOS
→ Attends la fin du transfert (barre de progression)

✅ Tu devrais voir tous les fichiers listés dans le dossier site/

3B

💻 Méthode B : SMB/CIFS depuis le Finder (Mac)

Pratique si tu utilises souvent le Finder. Monte le NAS comme un disque réseau sur ton Mac.

1

Activer SMB sur le NAS

🔧 Dans UGOS → Panneau de contrôle → Services de fichiers
→ Onglet SMB → Active le service SMB
→ Vérifie que le dossier docker est partagé en SMB

2

Se connecter depuis le Finder

Mac — Finder

# Dans le Finder : Cmd+K (ou menu Aller → Se connecter au serveur)
# Tape cette adresse :

smb://192.168.1.100/docker

# → Entre tes identifiants UGOS
# → Le dossier "docker" apparaît comme un disque réseau

Une fois connecté, navigue vers MartialApp/site/ et copie-colle tous les fichiers depuis ton dossier local ~/Projects/MartialApp/.

3

Alternative en une commande Terminal

Terminal macOS

# Monter le partage SMB
mkdir -p /tmp/nas-mount
mount_smbfs //admin@192.168.1.100/docker /tmp/nas-mount

# Copier les fichiers du site
cp ~/Projects/MartialApp/*.html /tmp/nas-mount/MartialApp/site/
cp ~/Projects/MartialApp/*.png /tmp/nas-mount/MartialApp/site/
cp ~/Projects/MartialApp/*.jpeg /tmp/nas-mount/MartialApp/site/
cp ~/Projects/MartialApp/manifest.json /tmp/nas-mount/MartialApp/site/
cp ~/Projects/MartialApp/sw.js /tmp/nas-mount/MartialApp/site/

# Démonter
umount /tmp/nas-mount

3C

⌨️ Méthode C : SCP en ligne de commande (la plus rapide)

Pour les geeks. Un seul copier-coller dans le Terminal et c'est fait. Requiert SSH activé sur le NAS.

1

Transférer tout en une commande

Terminal macOS — Transfert SCP complet

# Copier TOUS les fichiers du site vers le NAS en une seule commande
scp ~/Projects/MartialApp/*.html \
    ~/Projects/MartialApp/*.png \
    ~/Projects/MartialApp/*.jpeg \
    ~/Projects/MartialApp/manifest.json \
    ~/Projects/MartialApp/sw.js \
    admin@192.168.1.100:/volume1/docker/MartialApp/site/

# Le mot de passe UGOS sera demandé
# → Tape-le et valide avec Entrée

2

Vérifier que tout est copié

Terminal — Vérification SSH

# Se connecter au NAS
ssh admin@192.168.1.100

# Lister les fichiers dans le dossier site
ls -la /volume1/docker/MartialApp/site/

# Tu devrais voir ~15 fichiers :
# index.html, Kajukenbo.html, Kali_Arnis_Eskrima.html,
# Mon_Art_Martial.html, Nihon_Bu_Jutsu_Ryu.html,
# Objectif_Corps.html, Programme_Preparation.html,
# Seance_du_Jour.html, DEPLOIEMENT_GUIDE.html,
# TUTO_NAS_UGREEN.html, icon-192.png, icon-512.png,
# corps_ref_1_1.jpeg, manifest.json, sw.js

# Compter les fichiers
ls /volume1/docker/MartialApp/site/ | wc -l
# → Doit afficher 15

✅ Fichiers transférés ! Tous les fichiers du site sont maintenant sur le NAS. On passe à la configuration Docker + Nginx.

4A

📥 Télécharger l'image Nginx

1

Méthode UGOS : via l'interface Docker

🐳 Dans UGOS → ouvre Docker → onglet Image
→ Clique "Ajouter" ou "Registry"
→ Cherche : nginx
→ Sélectionne l'image officielle nginx
→ Tag : alpine (version légère, ~25 Mo)
→ Clique Télécharger

⏳ Attends le téléchargement (~30 secondes en fibre)
✅ L'image nginx:alpine apparaît dans ta liste d'images

2

Alternative SSH : docker pull

Terminal SSH sur le NAS

ssh admin@192.168.1.100

# Télécharger l'image nginx alpine (légère, ~25 Mo)
docker pull nginx:alpine

# Vérifier que l'image est téléchargée
docker images | grep nginx
# → nginx   alpine   xxxx   25MB

4B

⚙️ Créer le fichier nginx.conf

3

Créer la configuration Nginx personnalisée

Ce fichier configure Nginx pour servir correctement ton site avec le cache, le gzip, les types MIME, et le support du Service Worker PWA.

💡 Où créer ce fichier ? Il doit être dans /volume1/docker/MartialApp/nginx/nginx.conf sur le NAS. Tu peux le créer via SSH ou via le gestionnaire de fichiers UGOS.

Méthode SSH — Créer nginx.conf

ssh admin@192.168.1.100

# Créer le fichier nginx.conf avec nano (ou vi)
nano /volume1/docker/MartialApp/nginx/nginx.conf

Contenu complet de nginx.conf — Copier-coller en entier

worker_processes auto;

events {
    worker_connections 1024;
}

http {
    # ─── Types MIME ───
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    # ─── Performance ───
    sendfile        on;
    tcp_nopush      on;
    tcp_nodelay     on;
    keepalive_timeout 65;

    # ─── Compression Gzip ───
    gzip on;
    gzip_vary on;
    gzip_min_length 1000;
    gzip_types text/plain text/css text/javascript
               application/javascript application/json
               application/manifest+json image/svg+xml;

    server {
        listen 80;
        server_name _;
        root /usr/share/nginx/html;
        index index.html;

        # ─── Fichiers HTML : pas de cache (toujours frais) ───
        location ~* \.html$ {
            add_header Cache-Control "no-cache, must-revalidate";
            try_files $uri $uri/ /index.html;
        }

        # ─── Service Worker : JAMAIS cacher ───
        location = /sw.js {
            add_header Cache-Control "no-store, no-cache, must-revalidate";
            add_header Service-Worker-Allowed "/";
        }

        # ─── Manifest PWA ───
        location = /manifest.json {
            add_header Cache-Control "no-cache";
            types { application/manifest+json json; }
        }

        # ─── Images et assets : cache 30 jours ───
        location ~* \.(png|jpg|jpeg|gif|ico|svg|webp)$ {
            expires 30d;
            add_header Cache-Control "public, immutable";
        }

        # ─── Sécurité de base ───
        add_header X-Frame-Options "SAMEORIGIN" always;
        add_header X-Content-Type-Options "nosniff" always;

        # ─── Page 404 ───
        error_page 404 /index.html;
    }
}

⚠️ Après avoir collé : Dans nano, fais Ctrl+O → Entrée pour sauvegarder, puis Ctrl+X pour quitter.

        Ce que fait cette config :

        • Sert le site sur le port 80 du conteneur

        • Compresse les fichiers (gzip) pour un chargement rapide

        • Configure le cache correctement pour les images (30j) et les HTML (pas de cache)

        • Le Service Worker sw.js n'est JAMAIS caché (obligatoire pour les mises à jour PWA)

        • Le manifest PWA est servi avec le bon type MIME

4C

🚀 Créer et lancer le conteneur

4

Méthode UGOS : via l'interface Docker

🐳 Dans Docker UGOS → onglet Container → Créer

Image : nginx:alpine
Nom du conteneur : MartialApp-web

Port Mapping :
  Port local : 8080 → Port conteneur : 80

Volume Mounts (2 montages) :
  ① /volume1/docker/MartialApp/site → /usr/share/nginx/html (Read Only)
  ② /volume1/docker/MartialApp/nginx/nginx.conf → /etc/nginx/nginx.conf (Read Only)

Redémarrage : always (redémarre automatiquement si le NAS reboot)

→ Clique Créer puis Démarrer

5

Alternative SSH : docker run (une seule commande)

Terminal SSH — Lancer le conteneur

ssh admin@192.168.1.100
 
 # Créer et lancer le conteneur en une commande
 docker run -d \
   --name MartialApp-web \
   --restart always \
   -p 8080:80 \
   -v /volume1/docker/MartialApp/site:/usr/share/nginx/html:ro \
   -v /volume1/docker/MartialApp/nginx/nginx.conf:/etc/nginx/nginx.conf:ro \
   nginx:alpine

5B

Alternative Docker Compose (plus propre et maintenable)

Si tu préfères une approche plus professionnelle et facile à maintenir :

Créer docker-compose.yml

ssh admin@192.168.1.100
 
 # Créer le fichier docker-compose.yml
 nano /volume1/docker/MartialApp/docker-compose.yml

Contenu complet de docker-compose.yml

version: '3.8'

 services:
   MartialApp-web:
     image: nginx:alpine
     container_name: MartialApp-web
     restart: always
     ports:
       - "8080:80"
     volumes:
       - /volume1/docker/MartialApp/site:/usr/share/nginx/html:ro
       - /volume1/docker/MartialApp/nginx/nginx.conf:/etc/nginx/nginx.conf:ro
     networks:
       - martial-net

 networks:
   martial-net:
     driver: bridge

Lancer avec Docker Compose

# Aller dans le dossier
 cd /volume1/docker/MartialApp
 
 # Lancer le conteneur
 docker-compose up -d
 
 # Voir le statut
 docker-compose ps
 
 # Voir les logs
 docker-compose logs -f
 
 # Arrêter
 docker-compose down

         Avantages Docker Compose :

         • Configuration centralisée et lisible

         • Facile à maintenir et à modifier

         • Déploiement reproductible

         • Gestion simplifiée des volumes et réseaux

         • Standard de l'industrie pour les projets multi-conteneurs

        Explication de chaque paramètre :

        • -d → Détaché (tourne en arrière-plan)

        • --name MartialApp-web → Nom du conteneur pour le retrouver facilement

        • --restart always → Redémarre auto après un reboot du NAS

        • -p 8080:80 → Le port 8080 du NAS redirige vers le port 80 de Nginx

        • -v .../site:/usr/share/nginx/html:ro → Monte les fichiers du site (read-only)

        • -v .../nginx.conf:/etc/nginx/nginx.conf:ro → Monte la config Nginx

6

Vérifier que le conteneur tourne

Terminal SSH — Vérification

# Voir les conteneurs en cours d'exécution
docker ps

# Tu devrais voir quelque chose comme :
# CONTAINER ID   IMAGE          COMMAND                  STATUS         PORTS                  NAMES
# abc123def456   nginx:alpine   "/docker-entrypoint.…"   Up 2 minutes   0.0.0.0:8080->80/tcp   MartialApp-web

# Tester en local sur le NAS
curl http://localhost:8080
# → Doit afficher le code HTML de index.html

# Si erreur, voir les logs :
docker logs MartialApp-web

✅ Nginx tourne ! Le serveur web est actif dans Docker sur le port 8080. Il ne reste plus qu'à y accéder depuis tes appareils.

7

Dépannage — Commandes utiles Docker

Terminal SSH — Commandes de dépannage

# Arrêter le conteneur
docker stop MartialApp-web

# Redémarrer le conteneur
docker restart MartialApp-web

# Supprimer le conteneur (pour recréer)
docker rm -f MartialApp-web

# Voir les logs en temps réel
docker logs -f MartialApp-web

# Entrer dans le conteneur (debug)
docker exec -it MartialApp-web sh

# Tester la config Nginx (depuis dans le conteneur)
docker exec MartialApp-web nginx -t

05

🌐 Accéder au site

1

Depuis ton Mac (navigateur)

🌐 Ouvre Safari, Chrome ou Firefox
→ Tape : http://192.168.1.100:8080

🎉 Ton site "Mon Parcours Martial" s'affiche !
→ Teste la navigation entre les pages
→ Vérifie que les images chargent
→ Vérifie que "Séance du Jour" fonctionne

2

Depuis un iPhone / iPad (même Wi-Fi)

📱 Sur ton iPhone/iPad, vérifie que tu es sur le même Wi-Fi que le NAS
→ Ouvre Safari
→ Tape : http://192.168.1.100:8080
→ Le site s'affiche ! Teste la navigation.

💡 Astuce : Ajoute un signet pour y accéder rapidement

3

Depuis un téléphone Android (même Wi-Fi)

Même principe : ouvre Chrome → tape http://192.168.1.100:8080

05B

📲 Installer en PWA (comme une app)

Qu'est-ce qu'une PWA ? Grâce au manifest.json et au sw.js déjà présents dans ton site, tu peux l'installer comme une vraie application sur l'écran d'accueil de ton téléphone. Il fonctionnera même hors connexion après la première visite.

4

iPhone / iPad — Ajouter à l'écran d'accueil

📱 Dans Safari sur ton iPhone :
① Ouvre http://192.168.1.100:8080
② Tape l'icône Partager (carré avec flèche vers le haut) ↑
③ Scrolle et tape "Sur l'écran d'accueil"
④ Confirme le nom : "Kajukenbo 2026"
⑤ Tape "Ajouter"

✅ L'icône Kajukenbo apparaît sur ton écran d'accueil !
→ Ouvre-la : le site s'ouvre en plein écran, sans barre Safari
→ Fonctionne même sans Wi-Fi (grâce au Service Worker)

5

Android — Installer la PWA

📱 Dans Chrome sur Android :
① Ouvre http://192.168.1.100:8080
② Chrome affiche une bannière "Installer l'application" en bas
③ Tape "Installer"

Pas de bannière ? → Menu ⋮ (3 points) → "Installer l'application"

✅ L'app apparaît dans ton tiroir d'applications !

6

Dépannage — Le site ne charge pas ?

Checklist de dépannage

# 1. Vérifie que le conteneur tourne
ssh admin@192.168.1.100
docker ps | grep MartialApp-web

# 2. Vérifie que le port 8080 est accessible
curl http://192.168.1.100:8080

# 3. Vérifie le firewall du NAS
# UGOS → Panneau de contrôle → Sécurité → Firewall
# → Assure-toi que le port 8080 est autorisé

# 4. Vérifie que l'appareil est sur le même réseau
# Sur iPhone : Réglages → Wi-Fi → même réseau que le NAS

# 5. Vérifie les logs Nginx
docker logs MartialApp-web

# 6. Teste la config Nginx
docker exec MartialApp-web nginx -t

🏆 Félicitations ! Ton site martial arts est hébergé sur ton NAS UGREEN, accessible depuis tous tes appareils sur le réseau, et installable en PWA pour un accès offline. Aucun abonnement, aucun cloud, 100% chez toi.

06A

🔐 Sécuriser UGOS (le système du NAS)

1

Changer le mot de passe admin par défaut

Le mot de passe par défaut est souvent faible. Utilise un mot de passe fort (16+ caractères, majuscules, chiffres, symboles).

👤 UGOS → Panneau de contrôle → Utilisateur
→ Sélectionne le compte admin
→ Clique Modifier → Change le mot de passe
→ Utilise un gestionnaire de mots de passe (1Password, Bitwarden)

💡 Recommandé : Crée un 2ème compte utilisateur avec droits admin, désactive le compte "admin" par défaut

2

Activer la double authentification (2FA)

🔐 UGOS → Panneau de contrôle → Sécurité → 2FA
→ Active la vérification en deux étapes
→ Scanne le QR code avec Google Authenticator ou Authy
→ Entre le code à 6 chiffres pour confirmer

✅ Désormais, chaque connexion à UGOS demande un code temporaire

3

Configurer le firewall du NAS

🛡️ UGOS → Panneau de contrôle → Sécurité → Firewall
→ Active le firewall
→ Politique par défaut : Refuser tout
→ Ajoute des règles pour autoriser uniquement :
  • Port 9443 — Interface UGOS (réseau local uniquement)
  • Port 8080 — Ton site web Nginx
  • Port 22 — SSH (réseau local uniquement)
  • Port 443 — HTTPS (si accès internet activé)

→ Source : 192.168.1.0/24 (uniquement ton réseau local)

⚠️ Critique : N'ouvre JAMAIS le port 9443 (UGOS) ou 22 (SSH) vers internet. Ces ports doivent rester accessibles uniquement depuis ton réseau local.

4

Activer le blocage automatique des IPs

🚫 UGOS → Sécurité → Protection automatique
→ Active le blocage automatique
→ Règle : Bloquer après 5 tentatives échouées en 5 minutes
→ Durée de blocage : permanente (ou 24h minimum)

→ Cela bloque les attaques par force brute sur SSH et UGOS

5

Activer les mises à jour automatiques UGOS

Les mises à jour corrigent les failles de sécurité. Active-les pour être toujours protégé.

🔄 UGOS → Panneau de contrôle → Mise à jour
→ Active les mises à jour automatiques
→ Planifie-les la nuit (ex: 4h du matin)

06B

🐳 Sécuriser Docker + Nginx

6

Volumes en lecture seule (déjà fait ✅)

Notre commande docker run utilise déjà :ro (read-only) sur les volumes. Cela empêche le conteneur de modifier les fichiers du site. C'est une bonne pratique essentielle.

7

Headers de sécurité Nginx avancés

Ajoute ces headers dans le bloc server de ton nginx.conf pour une protection maximale :

Ajouter dans nginx.conf → bloc server

# ─── Headers de sécurité avancés ───
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
add_header Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:;" always;

# ─── Cacher la version de Nginx ───
server_tokens off;

        Ce que font ces headers :

        • X-Frame-Options → Empêche l'inclusion dans une iframe (clickjacking)

        • X-Content-Type-Options → Empêche le MIME sniffing

        • X-XSS-Protection → Protection XSS du navigateur

        • Referrer-Policy → Contrôle les infos envoyées en referer

        • Permissions-Policy → Bloque caméra, micro, géoloc

        • Content-Security-Policy → Bloque les scripts externes

        • server_tokens off → Cache la version Nginx (évite les exploits ciblés)

8

Rate limiting — Limiter les requêtes

Protège contre les attaques DDoS et le scraping abusif :

Ajouter dans nginx.conf → bloc http (avant server)

# ─── Rate Limiting ───
limit_req_zone $binary_remote_addr zone=general:10m rate=10r/s;

# Puis dans le bloc server :
limit_req zone=general burst=20 nodelay;

Cela limite chaque IP à 10 requêtes/seconde avec un burst de 20.

9

Réseau Docker isolé

Crée un réseau Docker dédié pour isoler le conteneur :

# Créer un réseau isolé
docker network create martial-net

# Recréer le conteneur sur ce réseau
docker rm -f MartialApp-web
docker run -d \
  --name MartialApp-web \
  --restart always \
  --network martial-net \
  -p 8080:80 \
  -v /volume1/docker/MartialApp/site:/usr/share/nginx/html:ro \
  -v /volume1/docker/MartialApp/nginx/nginx.conf:/etc/nginx/nginx.conf:ro \
  --read-only \
  --tmpfs /var/cache/nginx \
  --tmpfs /var/run \
  --tmpfs /tmp \
  nginx:alpine

        Nouveautés sécurité :

        • --network martial-net → Réseau isolé

        • --read-only → Filesystem du conteneur en lecture seule

        • --tmpfs → Répertoires temporaires en RAM (nécessaires pour Nginx)

10

Sauvegardes automatiques

Configure des sauvegardes régulières de tes données :

💾 UGOS → Sauvegarde (ou Hyper Backup si disponible)
→ Crée une tâche de sauvegarde pour /volume1/docker/
→ Destination : USB externe ou cloud (Google Drive, Backblaze B2)
→ Planification : quotidienne à 2h du matin
→ Rétention : 7 versions minimum

✅ NAS sécurisé ! 2FA activé, firewall configuré, Docker isolé, headers Nginx renforcés, sauvegardes en place.

7A

🔀 Méthode A : Reverse Proxy + DDNS + Let's Encrypt

La méthode classique. Tu obtiens une URL comme https://martial.mondomaine.com avec un certificat SSL gratuit.

1

Configurer un DDNS (Dynamic DNS)

Ton IP publique change régulièrement. Un DDNS associe un nom de domaine à ton IP, même quand elle change.

Services DDNS gratuits recommandés

# Option 1 — DuckDNS (gratuit, simple)
# → https://www.duckdns.org
# → Crée un compte → choisis un nom : martial.duckdns.org

# Option 2 — No-IP (gratuit avec renouvellement mensuel)
# → https://www.noip.com

# Option 3 — Si tu as un nom de domaine (OVH, Cloudflare, etc.)
# → Configure un enregistrement A vers ton IP publique

🌐 Certains NAS UGREEN supportent le DDNS nativement :
→ UGOS → Panneau de contrôle → Accès externe → DDNS
→ Sinon, configure manuellement avec un cron :

*/5 * * * * curl -s "https://www.duckdns.org/update?domains=martial&token=TON_TOKEN"

2

Ouvrir les ports sur le routeur (Port Forwarding)

🔧 Connecte-toi à ta box/routeur (192.168.1.1)
→ Section NAT ou Port Forwarding ou Redirection de ports

→ Ajoute 2 règles :
• Port externe 80 → IP 192.168.1.100 port 80 (pour Let's Encrypt)
• Port externe 443 → IP 192.168.1.100 port 443 (HTTPS)

⚠️ Important : N'ouvre que les ports 80 et 443. Jamais le port 9443 (UGOS), 22 (SSH), ou 8080 directement.

3

Installer Nginx Proxy Manager (NPM) dans Docker

NPM est un reverse proxy avec interface web qui gère automatiquement les certificats SSL Let's Encrypt.

Terminal SSH — Lancer Nginx Proxy Manager

ssh admin@192.168.1.100

# Créer le dossier pour NPM
mkdir -p /volume1/docker/npm/data
mkdir -p /volume1/docker/npm/letsencrypt

# Lancer Nginx Proxy Manager
docker run -d \
  --name nginx-proxy-manager \
  --restart always \
  -p 80:80 \
  -p 443:443 \
  -p 81:81 \
  -v /volume1/docker/npm/data:/data \
  -v /volume1/docker/npm/letsencrypt:/etc/letsencrypt \
  jc21/nginx-proxy-manager:latest

💡 Premier accès NPM : http://192.168.1.100:81
Email : admin@example.com / Mot de passe : changeme
→ Change-les immédiatement après la première connexion !

4

Configurer le Proxy Host + SSL

🔀 Dans NPM (http://192.168.1.100:81) :
→ Proxy Hosts → Add Proxy Host

Domain Names : martial.duckdns.org
Forward Hostname : 192.168.1.100
Forward Port : 8080
Block Common Exploits : ✅ Activé
Websockets Support : ✅ Activé

→ Onglet SSL :
  → Request a new SSL Certificate
  → ✅ Force SSL
  → ✅ HTTP/2 Support
  → Email : ton email (pour Let's Encrypt)
  → ✅ Accepte les conditions
→ Clique Save

✅ Résultat : Ton site est accessible via https://martial.duckdns.org avec un certificat SSL valide, depuis n'importe où dans le monde !

7B

☁️ Méthode B : Cloudflare Tunnel (Zero Trust, sans port forwarding)

La plus sécurisée. Aucun port ouvert sur ton routeur. Cloudflare crée un tunnel chiffré. Gratuit.

1

Créer un compte Cloudflare + ajouter un domaine

Tu as besoin d'un nom de domaine (à partir de ~5€/an chez OVH, Cloudflare, Namecheap).
→ Va sur https://dash.cloudflare.com → crée un compte → ajoute ton domaine.
→ Change les nameservers chez ton registrar vers ceux de Cloudflare.

2

Installer cloudflared sur le NAS

Terminal SSH — Lancer cloudflared via Docker

ssh admin@192.168.1.100

# Créer le dossier config
mkdir -p /volume1/docker/cloudflared

# Lancer cloudflared (remplace TON_TOKEN par le token du dashboard)
docker run -d \
  --name cloudflared \
  --restart always \
  cloudflare/cloudflared:latest \
  tunnel --no-autoupdate run --token TON_TOKEN_CLOUDFLARE

3

Configurer le tunnel dans le dashboard Cloudflare

☁️ Cloudflare Dashboard → Zero Trust → Networks → Tunnels
→ Create a Tunnel → Nom : MartialApp
→ Copie le token → colle-le dans la commande Docker ci-dessus

→ Configure la route :
Public hostname : martial.tondomaine.com
Service : http://192.168.1.100:8080
→ Save

        Avantages Cloudflare Tunnel :

        • Aucun port ouvert sur ton routeur (0 risque d'intrusion directe)

        • SSL automatique + protection DDoS gratuite

        • Cache CDN mondial (ton site charge vite partout)

        • Firewall applicatif (WAF) inclus

7C

🔑 Méthode C : VPN (accès privé uniquement)

La plus privée. Le site reste invisible sur internet. Seuls les appareils connectés au VPN y accèdent.

1

Installer WireGuard sur le NAS

Terminal SSH — WireGuard Easy via Docker

docker run -d \
  --name wg-easy \
  --restart always \
  --cap-add NET_ADMIN \
  --cap-add SYS_MODULE \
  -e WG_HOST=martial.duckdns.org \
  -e PASSWORD=TonMotDePasseWG \
  -e WG_DEFAULT_DNS=1.1.1.1 \
  -p 51820:51820/udp \
  -p 51821:51821/tcp \
  -v /volume1/docker/wireguard:/etc/wireguard \
  ghcr.io/wg-easy/wg-easy

→ Interface web : http://192.168.1.100:51821
→ Crée un profil client → télécharge le QR code
→ Sur ton iPhone : installe l'app WireGuard → scanne le QR
→ Connecté au VPN, tu accèdes à http://192.168.1.100:8080 comme en local !

⚠️ Port forwarding requis : Ouvre le port UDP 51820 sur ton routeur vers l'IP du NAS pour que le VPN soit accessible depuis l'extérieur.

2

Comparatif des 3 méthodes

🔀 Reverse Proxy + DDNS — URL publique, SSL, requiert port forwarding 80/443

☁️ Cloudflare Tunnel — URL publique, SSL, aucun port ouvert, protection DDoS, RECOMMANDÉ

🔑 VPN WireGuard — Accès privé seulement, ultra-sécurisé, requiert port UDP 51820

✅ Accès Internet configuré ! Ton site martial arts est maintenant accessible depuis n'importe où, de façon sécurisée. La méthode Cloudflare Tunnel est la plus simple et la plus sûre.

BONUS

🔄 Mises à jour & Astuces avancées

📜 Script de mise à jour automatique (update.sh)

Crée ce script sur le NAS pour mettre à jour le site depuis GitHub en une commande :

Créer le script — SSH

ssh admin@192.168.1.100

nano /volume1/docker/MartialApp/update.sh

Contenu de update.sh

#!/bin/bash
# ── Script de mise à jour du site MartialApp ──
cd /volume1/docker/MartialApp/site

# Cloner ou mettre à jour depuis GitHub
if [ -d ".git" ]; then
    git pull origin main
else
    git clone https://github.com/Kaito1947/MartialApp.git .
fi

# Recharger Nginx sans downtime
docker exec MartialApp-web nginx -s reload

echo "✅ Site mis à jour !"

Rendre exécutable et lancer

chmod +x /volume1/docker/MartialApp/update.sh
bash /volume1/docker/MartialApp/update.sh

⏰ Cron Job — Mise à jour automatique quotidienne

Programme la mise à jour chaque nuit à 3h du matin :

# Ouvrir le cron sur le NAS
crontab -e

# Ajouter cette ligne :
0 3 * * * /bin/bash /volume1/docker/MartialApp/update.sh >> /volume1/docker/MartialApp/update.log 2>&1

🐳 Watchtower — Mise à jour auto de l'image Docker

Watchtower surveille et met à jour automatiquement tes conteneurs Docker :

docker run -d \
  --name watchtower \
  --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --cleanup --interval 86400

Watchtower vérifie chaque 24h si nginx:alpine a une nouvelle version et la met à jour automatiquement.

🔐 Astuce : Accès par nom au lieu d'IP

Pour taper http://martial.local:8080 au lieu de l'IP :

Sur ton Mac — /etc/hosts

# Ouvrir le fichier hosts
sudo nano /etc/hosts

# Ajouter cette ligne à la fin :
192.168.1.100   martial.local nas.local

# Sauvegarder (Ctrl+O, Entrée, Ctrl+X)
# Maintenant tu peux accéder via :
# http://martial.local:8080

📊 Récapitulatif complet

Ce que tu as accompli :

✅ NAS UGREEN DXP2800XP configuré avec Docker
✅ Nginx Alpine comme serveur web (~25 Mo)
✅ Config Nginx optimisée (gzip, cache, MIME, Service Worker)
✅ Site accessible sur tout le réseau local
✅ Installable en PWA sur iPhone et Android
✅ Fonctionne offline grâce au Service Worker
✅ Redémarre automatiquement après un reboot du NAS
✅ Script de mise à jour depuis GitHub
✅ 100% auto-hébergé, aucun cloud, aucun abonnement

Héberger ton site sur
NAS UGREEN

Prérequis & Accès au NAS

🔍 Vérifier l'accès au NAS

Préparer le dossier sur le NAS

📂 Créer la structure de dossiers

Transfert des fichiers vers le NAS

🌐 Méthode A : Interface web UGOS (glisser-déposer)

💻 Méthode B : SMB/CIFS depuis le Finder (Mac)

⌨️ Méthode C : SCP en ligne de commande (la plus rapide)

Docker + Nginx — Serveur Web

📥 Télécharger l'image Nginx

⚙️ Créer le fichier nginx.conf

🚀 Créer et lancer le conteneur

Accéder au site & Installer en PWA

🌐 Accéder au site

📲 Installer en PWA (comme une app)

Sécurité — Bonnes pratiques

🔐 Sécuriser UGOS (le système du NAS)

🐳 Sécuriser Docker + Nginx

Accéder au site depuis Internet

🔀 Méthode A : Reverse Proxy + DDNS + Let's Encrypt

☁️ Méthode B : Cloudflare Tunnel (Zero Trust, sans port forwarding)

🔑 Méthode C : VPN (accès privé uniquement)

🔄 Mises à jour & Astuces avancées

📜 Script de mise à jour automatique (update.sh)

⏰ Cron Job — Mise à jour automatique quotidienne

🐳 Watchtower — Mise à jour auto de l'image Docker

🔐 Astuce : Accès par nom au lieu d'IP

📊 Récapitulatif complet

Héberger ton site surNAS UGREEN

Prérequis & Accès au NAS

🔍 Vérifier l'accès au NAS

Préparer le dossier sur le NAS

📂 Créer la structure de dossiers

Transfert des fichiers vers le NAS

🌐 Méthode A : Interface web UGOS (glisser-déposer)

💻 Méthode B : SMB/CIFS depuis le Finder (Mac)

⌨️ Méthode C : SCP en ligne de commande (la plus rapide)

Docker + Nginx — Serveur Web

📥 Télécharger l'image Nginx

⚙️ Créer le fichier nginx.conf

🚀 Créer et lancer le conteneur

Accéder au site & Installer en PWA

🌐 Accéder au site

📲 Installer en PWA (comme une app)

Sécurité — Bonnes pratiques

🔐 Sécuriser UGOS (le système du NAS)

🐳 Sécuriser Docker + Nginx

Accéder au site depuis Internet

🔀 Méthode A : Reverse Proxy + DDNS + Let's Encrypt

☁️ Méthode B : Cloudflare Tunnel (Zero Trust, sans port forwarding)

🔑 Méthode C : VPN (accès privé uniquement)

🔄 Mises à jour & Astuces avancées

📜 Script de mise à jour automatique (update.sh)

⏰ Cron Job — Mise à jour automatique quotidienne

🐳 Watchtower — Mise à jour auto de l'image Docker

🔐 Astuce : Accès par nom au lieu d'IP

📊 Récapitulatif complet

Héberger ton site sur
NAS UGREEN