LogWhispererAI/docs/reverse_proxy_setup.md

Configurazione con Reverse Proxy

Questa guida spiega come configurare LogWhispererAI con un reverse proxy SSL.

Scenario

Hai configurato:

• Frontend: https://logwhispererai.lab.home.lucasacchi.net → http://192.168.254.79:5173
• Backend: https://srv-logwhispererai.lab.home.lucasacchi.net → http://192.168.254.79:3001

Configurazione

1. Crea il file di configurazione

Crea un file .env nella root del progetto:

cp .env.example .env

Modifica il file .env con i tuoi valori:

# Frontend Configuration
VITE_API_URL=https://srv-logwhispererai.lab.home.lucasacchi.net
VITE_WEBHOOK_BASE_URL=https://logwhispererai.lab.home.lucasacchi.net/webhook
VITE_INSTALL_SCRIPT_URL=https://logwhispererai.lab.home.lucasacchi.net/install.sh
VITE_APP_NAME=LogWhispererAI
VITE_APP_URL=https://logwhispererai.lab.home.lucasacchi.net

# Backend Configuration
CORS_ORIGINS=https://logwhispererai.lab.home.lucasacchi.net
WEBHOOK_BASE_URL=https://logwhispererai.lab.home.lucasacchi.net/webhook
DELAY_MS=1500
NODE_ENV=production

2. Avvia i servizi

# Ferma eventuali container esistenti
docker compose down

# Avvia con le nuove variabili
docker compose up -d

3. Verifica la configurazione

Testa i vari endpoint:

# Health check backend
curl https://srv-logwhispererai.lab.home.lucasacchi.net/health

# Genera un webhook
curl -X POST https://srv-logwhispererai.lab.home.lucasacchi.net/api/webhook

# Analizza un log
curl -X POST https://srv-logwhispererai.lab.home.lucasacchi.net/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"log": "FATAL: out of memory"}'

4. Verifica il frontend

Apri https://logwhispererai.lab.home.lucasacchi.net nel browser e verifica che:

1. La demo interattiva funzioni (chiama il backend corretto)
2. Lo step 2 dell'onboarding generi webhook con l'URL corretto

Variabili d'Ambiente

Frontend (VITE_*)

Variabile	Descrizione	Esempio
VITE_API_URL	URL del backend API	https://srv-logwhispererai.lab.home.lucasacchi.net
VITE_WEBHOOK_BASE_URL	Base URL per i webhook	https://logwhispererai.lab.home.lucasacchi.net/webhook
VITE_INSTALL_SCRIPT_URL	URL dello script di installazione	https://logwhispererai.lab.home.lucasacchi.net/install.sh
VITE_APP_NAME	Nome dell'applicazione	LogWhispererAI
VITE_APP_URL	URL pubblico dell'app	https://logwhispererai.lab.home.lucasacchi.net

Backend

Variabile	Descrizione	Esempio
CORS_ORIGINS	Origini CORS consentite (comma-separated)	https://logwhispererai.lab.home.lucasacchi.net
WEBHOOK_BASE_URL	Base URL per i webhook generati	https://logwhispererai.lab.home.lucasacchi.net/webhook
DELAY_MS	Delay simulato API (ms)	1500
NODE_ENV	Ambiente Node	production

File Configurati

• frontend/.env - Configurazione frontend per produzione
• frontend/.env.development - Configurazione per sviluppo locale
• frontend/vite.config.ts - Allow hosts per Vite
• tools/fake-backend/server.js - Supporto CORS dinamico e webhook URL configurabili
• docker-compose.yml - Passaggio variabili ai container

Troubleshooting

Errore "Blocked request" di Vite

Se vedi questo errore:

Blocked request. This host ("logwhispererai.lab.home.lucasacchi.net") is not allowed.

Aggiungi il dominio a frontend/vite.config.ts:

server: {
  allowedHosts: [
    'logwhispererai.lab.home.lucasacchi.net',
  ],
}

Errore CORS

Se il browser blocca le richieste API:

1. Verifica che CORS_ORIGINS includa il dominio del frontend
2. Ricostruisci il backend: docker compose up fake-backend --build -d

Webhook URL errati

Se i webhook generati hanno URL sbagliati:

1. Verifica WEBHOOK_BASE_URL nel backend
2. Verifica VITE_WEBHOOK_BASE_URL nel frontend
3. Ricostruisci entrambi i servizi