Merge pull request 'fix(nginx): join shared-network and read real client IP via CF-Connecting-IP' (#3) from chore/cloudflare-shared-network into main
CD — Déploiement / deploy (push) Successful in 11s

Reviewed-on: #3
Reviewed-by: Esiah <[email protected]>
This commit was merged in pull request #3.
This commit is contained in:
2026-10-16 09:24:49 +00:00
4 changed files with 51 additions and 7 deletions
+10
View File
@@ -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,
+6
View File
@@ -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).
+6 -2
View File
@@ -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;
+29 -5
View File
@@ -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: <id-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 |