Nginx (reverse proxy)

​

Consigliato: HTTPS (predefinito/produzione)

upstream teable {
  server 127.0.0.1:3000;
  # Se Nginx viene eseguito nella stessa rete Docker di Teable:
  # server teable:3000;
}

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

# La porta 80 esegue soltanto il reindirizzamento (o viene usata per le challenge 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;

  # Se hai la certezza che il dominio debba usare sempre HTTPS, puoi abilitare HSTS (con cautela)
  # 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;
  }
}

​

Certificati (emissione/rinnovo)

• Let’s Encrypt (consigliato): utilizza Certbot o acme.sh per l’emissione e il rinnovo automatici
• Strumenti con interfaccia grafica: Nginx Proxy Manager può richiedere e rinnovare automaticamente i certificati dalla propria interfaccia

​

Esempio 1: location / minimo (avvio rapido)

Nota: questo esempio usa solo HTTP ed è destinato a reti interne o verifiche rapide. Per la produzione, scegli la configurazione HTTPS precedente.

upstream teable {
  server 127.0.0.1:3000;
  # Se Nginx viene eseguito nella stessa rete Docker di 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;
  }
}

​

Suggerimenti per Docker

• Nginx sull’host, Teable nei container: in genere usa proxy_pass http://127.0.0.1:3000; (supponendo che sia pubblicata la porta 3000:3000)
• Nginx e Teable nella stessa rete Docker: puoi eseguire l’instradamento tramite il nome del servizio o del container, ad esempio proxy_pass http://teable:3000;

​

Errori comuni

• Evita di riscrivere i percorsi: le riscritture possono interrompere l’instradamento interno di Teable, a meno che tu non sappia esattamente cosa stai facendo.
• Assicurati che PUBLIC_ORIGIN sia corretto: influisce su URL generati, reindirizzamenti, flussi di importazione e caricamento, callback e altro ancora.

​

Nginx Proxy Manager (NPM)

• Nginx Proxy Manager (NPM): comune nelle configurazioni basate su Docker

• Crea un host proxy: imposta Nomi di dominio su teable.example.com, Schema su http, Hostname/IP di inoltro su 127.0.0.1 (oppure teable all’interno di una rete Docker) e Porta di inoltro su 3000
• Abilita il supporto WebSocket: attiva il supporto WebSocket nelle opzioni dell’host proxy (l’etichetta varia in base alla versione)
• Esegui il provisioning o associa SSL: richiedi o seleziona un certificato Let’s Encrypt e, facoltativamente, forza il reindirizzamento HTTPS
• Non dimenticare l’ambiente Teable: imposta PUBLIC_ORIGIN sull’URL pubblico finale (ad esempio https://teable.example.com)