Nginx (proxy inverso)

​

Recomendado: HTTPS (predeterminado y producción)

upstream teable {
  server 127.0.0.1:3000;
  # Si Nginx se ejecuta en la misma red de Docker que Teable:
  # server teable:3000;
}

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

# El puerto 80 solo redirige (o se utiliza para desafíos 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 tienes la certeza de que el dominio debe utilizar siempre HTTPS, puedes activar HSTS (hazlo con precaución)
  # 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;
  }
}

​

Certificados (emisión y renovación)

• Let’s Encrypt (recomendado): utiliza Certbot o acme.sh para automatizar la emisión y la renovación
• Herramientas con interfaz gráfica: Nginx Proxy Manager puede solicitar y renovar automáticamente los certificados desde su interfaz

​

Ejemplo 1: location / mínimo (inicio rápido)

Nota: este ejemplo utiliza solo HTTP para redes internas o comprobaciones rápidas. En producción, utiliza preferentemente la configuración HTTPS anterior.

upstream teable {
  server 127.0.0.1:3000;
  # Si Nginx se ejecuta en la misma red de 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;
  }
}

​

Consejos para Docker

• Nginx en el host y Teable en contenedores: normalmente se utiliza proxy_pass http://127.0.0.1:3000; (suponiendo que se publique 3000:3000)
• Nginx y Teable en la misma red de Docker: puedes dirigir el tráfico mediante el nombre del servicio o contenedor, por ejemplo, proxy_pass http://teable:3000;

​

Errores habituales

• Evita reescribir rutas: las reescrituras pueden impedir que el enrutamiento interno de Teable funcione, salvo que sepas exactamente qué estás haciendo.
• Comprueba que PUBLIC_ORIGIN sea correcto: afecta a las URL generadas, las redirecciones, los procesos de importación y carga, las devoluciones de llamada, etc.

​

Nginx Proxy Manager (NPM)

• Nginx Proxy Manager (NPM): habitual en configuraciones basadas en Docker

• Crear un host de proxy: establece Nombres de dominio en teable.example.com, Esquema en http, Nombre de host o IP de reenvío en 127.0.0.1 (o teable dentro de una red de Docker) y Puerto de reenvío en 3000
• Activar la compatibilidad con WebSocket: activa WebSocket en las opciones del host de proxy (la etiqueta varía según la versión)
• Proporcionar o asociar SSL: solicita o selecciona un certificado de Let’s Encrypt y, opcionalmente, fuerza la redirección a HTTPS
• No olvides el entorno de Teable: establece PUBLIC_ORIGIN en la URL pública final (por ejemplo, https://teable.example.com)