Nginx (proxy inverse)

​

Recommandé : HTTPS (par défaut / production)

upstream teable {
  server 127.0.0.1:3000;
  # Si Nginx s’exécute sur le même réseau Docker que Teable :
  # server teable:3000;
}

map $http_upgrade $connection_upgrade {
  default upgrade;
  '' close;
}

# Le port 80 effectue uniquement une redirection (ou sert aux défis ACME)
server {
  listen 80;
  server_name teable.example.com;
  return 301 https://$host$request_uri;
}

server {
  listen 443 ssl http2;
  server_name teable.example.com;

  ssl_certificate     /etc/letsencrypt/live/teable.example.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/teable.example.com/privkey.pem;

  # Si le domaine doit toujours utiliser HTTPS, vous pouvez activer HSTS (avec prudence)
  # add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;

  location / {
    proxy_pass http://teable;

    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 https;

    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_set_header Host $host;

    proxy_http_version 1.1;
  }
}

​

Certificats (émission / renouvellement)

• Let’s Encrypt (recommandé) : utilisez Certbot ou acme.sh pour l’émission et le renouvellement automatiques
• Outils graphiques : Nginx Proxy Manager peut demander et renouveler automatiquement des certificats depuis son interface utilisateur

​

Exemple 1 : location / minimal (démarrage rapide)

Remarque : il s’agit d’un exemple HTTP uniquement pour les réseaux internes ou une vérification rapide. Pour la production, privilégiez la configuration HTTPS ci-dessus.

upstream teable {
  server 127.0.0.1:3000;
  # Si Nginx s’exécute sur le même réseau Docker que Teable :
  # server teable:3000;
}

map $http_upgrade $connection_upgrade {
  default upgrade;
  '' close;
}

server {
  listen 80;
  server_name teable.example.com;

  location / {
    proxy_pass http://teable;

    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 Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_set_header Host $host;

    proxy_http_version 1.1;
  }
}

​

Conseils Docker

• Nginx sur l’hôte, Teable dans des conteneurs : utilisez généralement proxy_pass http://127.0.0.1:3000; (en supposant que 3000:3000 est publié)
• Nginx et Teable sur le même réseau Docker : vous pouvez acheminer via le nom du service/conteneur, par ex. proxy_pass http://teable:3000;

​

Pièges courants

• Évitez les réécritures de chemin : elles peuvent rompre le routage interne de Teable, sauf si vous savez exactement ce que vous faites.
• Vérifiez que PUBLIC_ORIGIN est correct : cela affecte les URL générées, les redirections, les flux d’importation/téléversement, les rappels, etc.

​

Nginx Proxy Manager (NPM)

• Nginx Proxy Manager (NPM) : courant dans les configurations basées sur Docker

• Créer un hôte proxy : définissez Noms de domaine sur teable.example.com, Schéma sur http, Nom d’hôte / IP de transfert sur 127.0.0.1 (ou teable au sein d’un réseau Docker), et Port de transfert sur 3000
• Activer la prise en charge de WebSocket : activez la prise en charge de WebSocket dans les options de l’hôte proxy (le libellé varie selon la version)
• Fournir/associer SSL : demandez/sélectionnez un certificat Let’s Encrypt et, si vous le souhaitez, forcez la redirection HTTPS
• N’oubliez pas l’environnement Teable : définissez PUBLIC_ORIGIN sur l’URL publique finale (par ex. https://teable.example.com)