From 23df7dd7c678e978ff5c48f88ee305f21caa1128 Mon Sep 17 00:00:00 2001 From: xEsiah Date: Fri, 16 Oct 2026 11:18:18 +0200 Subject: [PATCH] fix(nginx): join shared-network and read real client IP via CF-Connecting-IP - nginx rejoint le reseau externe shared-network pour que le tunnel Cloudflare le resolue par son nom (cohaise-cloud-nginx). - real_ip_header CF-Connecting-IP : devient l'IP reelle du client, sinon limit_req et l'audit comptent l'IP du tunnel. - X-Forwarded-Proto reprend le schema vu par Cloudflare (https) au lieu de $scheme (http) : le cookie de session repasse en Secure. - docs/deployment.md : tunnel Docker via shared-network, deploy.yml sans make check. --- docker-compose.yml | 10 ++++++++ docker/nginx/cloud.conf | 6 +++++ docker/nginx/snippets/proxy-api.conf | 8 +++++-- docs/deployment.md | 34 ++++++++++++++++++++++++---- 4 files changed, 51 insertions(+), 7 deletions(-) diff --git a/docker-compose.yml b/docker-compose.yml index 00296fe..1cf1926 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -53,6 +53,10 @@ services: ports: # Tunnel Cloudflare en amont : n'ecouter que sur la boucle locale. - "127.0.0.1:${COHAISE_HTTP_PORT:-8083}:80" + # Le tunnel Cloudflare joint nginx par son nom sur le reseau partage. + networks: + - default + - shared-network environment: <<: *timezone volumes: @@ -163,6 +167,12 @@ services: start_period: 20s <<: *restart +networks: + # Reseau partage avec le tunnel Cloudflare et les autres applications de + # l'hote. Externe : il est cree par le compose du tunnel, pas par ce projet. + shared-network: + external: true + volumes: # Seul volume Docker restant : la sortie de build du front (petite, ephemere). # La base et les medias sont des bind mounts vers l'hote (CLOUD_DB_DIR, diff --git a/docker/nginx/cloud.conf b/docker/nginx/cloud.conf index 3583fcc..ae8b452 100644 --- a/docker/nginx/cloud.conf +++ b/docker/nginx/cloud.conf @@ -1,3 +1,9 @@ +# IP reelle derriere le tunnel Cloudflare. cloudflared transmet le client dans +# `CF-Connecting-IP` ; sans ceci, $remote_addr vaut l'IP du conteneur du tunnel +# et toutes les requetes partageraient le meme compteur de limitation. +set_real_ip_from 172.16.0.0/12; +real_ip_header CF-Connecting-IP; + # Limitation de debit. La zone `login` couvre les points sensibles (connexion, # reinitialisation) ; la zone `api` un trafic general soutenu sans etouffer les # envois volumineux (burst eleve, pas de mise en file). diff --git a/docker/nginx/snippets/proxy-api.conf b/docker/nginx/snippets/proxy-api.conf index 41d706a..9a024c5 100644 --- a/docker/nginx/snippets/proxy-api.conf +++ b/docker/nginx/snippets/proxy-api.conf @@ -6,9 +6,13 @@ set $cohaise_api http://api:8080; proxy_pass $cohaise_api$request_uri; proxy_http_version 1.1; proxy_set_header Host $host; +# $remote_addr est l'IP reelle du client (resolue via `real_ip_header`). +# X-Forwarded-Proto doit refleter le schema vu par Cloudflare (https), et non +# $scheme (http, car nginx recoit le tunnel en clair) : sinon le cookie de +# session n'est jamais marque Secure. 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 X-Forwarded-For $remote_addr; +proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto; proxy_read_timeout 60s; # Aligne sur la borne de depot du Cloud. client_max_body_size 5g; diff --git a/docs/deployment.md b/docs/deployment.md index 2cda8fd..4f8ddaa 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -141,18 +141,42 @@ adresse ni aucun domaine n'est codé en dur. - `nginx` écoute sur `COHAISE_HTTP_PORT` (8083 par défaut) avec `server_name _` : n'importe quel `Host` est accepté. -- `cloudflared` publie le service local (`http://127.0.0.1:8083`). - Renseigner l'origine publique **exacte** vue par les navigateurs : `PUBLIC_ORIGIN=https://cloud.example.com`. Elle sert aux liens envoyés par courriel (réinitialisation, confirmation). - `CLOUD_CORS_ORIGIN` ne sert qu'à un front servi depuis une autre origine ; avec un tunnel unique, laisser vide. -- Les cookies de session passent en `Secure` dès que le proxy annonce - `X-Forwarded-Proto: https` (cloudflared le fait) : garder `TRUST_PROXY=true`. +- Garder `TRUST_PROXY=true` : l'API lit alors `X-Forwarded-For`/`-Proto` posés + par nginx. Sans lui, tous les clients partageraient l'IP du proxy (limitation + de connexion globale, audit inutile). - Certificat et HSTS sont assurés en amont par Cloudflare — ne pas exposer directement le port 8083 sur Internet. -Exemple `~/.cloudflared/config.yml` : +**Tunnel Docker sur un réseau partagé (recommandé).** On joint nginx au réseau +du tunnel plutôt que de publier un port : `cloudflared` résout `nginx` par nom, +comme les autres applications de l'hôte : + +```yaml +# docker-compose.yml +services: + nginx: + networks: [default, shared-network] +networks: + shared-network: + external: true +``` + +Côté Cloudflare (Tunnel → Public Hostname) : sous-domaine/domaine, Type `HTTP`, +URL `http://cohaise-cloud-nginx:80`. Le réseau doit déjà exister +(`docker network ls`) — il est créé par le compose du tunnel. + +> nginx lit l'IP réelle du client dans `CF-Connecting-IP` +> (`real_ip_header` dans `docker/nginx/cloud.conf`). Sans cela, `limit_req` et +> l'audit compteraient l'IP du conteneur du tunnel, commune à tous. + +**Variante : tunnel sur l'hôte.** Si `cloudflared` tourne directement sur la +machine (hors réseau Docker), il publie `http://127.0.0.1:8083` : +`shared-network` est alors inutile. Exemple `~/.cloudflared/config.yml` : ```yaml tunnel: @@ -175,7 +199,7 @@ mais exige sur l'instance : un **runner self-hosted** enregistré | Workflow | Déclencheur | Rôle | | --- | --- | --- | -| `deploy.yml` | push `main` (backend/frontend/docker) ou manuel | `git pull`, `make check`, `make front`, rebuild `api`+`nginx` | +| `deploy.yml` | push `main` (backend/frontend/docker) ou manuel | `git pull`, `make front`, rebuild `api`+`nginx` | | `pr.yml` | push hors `main` | ouvre une PR vers `main` via l'API REST Gitea (`curl` + `python3`) | | `renovate.yml` | hebdomadaire ou manuel | lance Renovate contre Gitea | -- 2.54.0