Skip to content

SSL_SETUP.md

Latest commit

 

History

History
208 lines (156 loc) · 4.74 KB

SSL_SETUP.md

File metadata and controls

208 lines (156 loc) · 4.74 KB

SSL Configuration dla Open WebUI + LiteLLM

🔐 Szybki Start - Self-Signed Certificate

Linux/WSL:

cd scripts
chmod +x generate-ssl.sh
./generate-ssl.sh

Windows (PowerShell):

cd config/nginx
mkdir ssl -ErrorAction SilentlyContinue

# Generuj certyfikat
openssl req -x509 -nodes -days 3650 -newkey rsa:2048 `
    -keyout ssl/key.pem `
    -out ssl/cert.pem `
    -subj "/C=PL/ST=Poland/L=Warsaw/O=HomeLab/OU=AI/CN=localhost"

📦 Struktura katalogów

config/nginx/
├── nginx.conf          # Konfiguracja Nginx
└── ssl/
    ├── cert.pem        # Certyfikat SSL (generowany)
    └── key.pem         # Klucz prywatny (generowany)

scripts/
└── generate-ssl.sh     # Skrypt do generowania certyfikatu

docs/
└── SSL_SETUP.md        # Ta dokumentacja

🌐 Dostęp do usług

Po uruchomieniu z SSL:

🔀 Port Forwarding na routerze:

Zewnętrzny Port 443 → Wewnętrzny Port 8443 (Open WebUI HTTPS)
Zewnętrzny Port 80  → Wewnętrzny Port 8080 (Open WebUI HTTP)
Zewnętrzny Port 4000 → Wewnętrzny Port 4000 (LiteLLM - opcjonalnie)

⚠️ Self-Signed Certificate - Ostrzeżenia przeglądarki

Przy pierwszym połączeniu zobaczysz ostrzeżenie:

Chrome/Edge:

  1. Kliknij "Advanced" / "Zaawansowane"
  2. Kliknij "Proceed to [IP] (unsafe)" / "Przejdź do [IP] (niebezpieczne)"

Firefox:

  1. Kliknij "Advanced" / "Zaawansowane"
  2. Kliknij "Accept the Risk and Continue" / "Zaakceptuj ryzyko i kontynuuj"

Trwałe dodanie certyfikatu do zaufanych:

Chrome/Edge (Windows):

# Import do Windows Certificate Store
certutil -addstore "Root" config\nginx\ssl\cert.pem

Firefox:

Settings → Privacy & Security → Certificates → View Certificates → Authorities → Import → Wybierz cert.pem

Linux:

sudo cp config/nginx/ssl/cert.pem /usr/local/share/ca-certificates/openwebui.crt
sudo update-ca-certificates

🔒 Bezpieczeństwo

Self-Signed Certificate:

✅ Zalety:

  • Darmowy
  • Natychmiastowa konfiguracja
  • Szyfrowanie ruchu
  • Idealny dla połączeń po IP

❌ Wady:

  • Ostrzeżenia w przeglądarce
  • Nie zweryfikowany przez CA
  • Tylko dla użytku prywatnego/rozwojowego

Konfiguracja SSL w nginx.conf:

ssl_protocols TLSv1.2 TLSv1.3;           # Tylko bezpieczne protokoły
ssl_ciphers HIGH:!aNULL:!MD5;            # Silne szyfry
ssl_prefer_server_ciphers on;            # Preferuj szyfry serwera
add_header Strict-Transport-Security     # HSTS - wymuś HTTPS

📝 Własny certyfikat

Jeśli masz własny certyfikat (np. od CA lub Let's Encrypt):

  1. Skopiuj pliki certyfikatu:
cp twoj-cert.pem config/nginx/ssl/cert.pem
cp twoj-klucz.pem config/nginx/ssl/key.pem
chmod 600 config/nginx/ssl/key.pem
chmod 644 config/nginx/ssl/cert.pem
  1. Restart Nginx:
docker compose restart nginx

🔄 Let's Encrypt (dla domeny)

Jeśli jednak zdecydujesz się na domenę:

  1. Zainstaluj certbot:
sudo apt-get install certbot python3-certbot-nginx
  1. Wygeneruj certyfikat:
sudo certbot certonly --standalone -d twoja-domena.pl
  1. Skopiuj certyfikaty:
sudo cp /etc/letsencrypt/live/twoja-domena.pl/fullchain.pem config/nginx/ssl/cert.pem
sudo cp /etc/letsencrypt/live/twoja-domena.pl/privkey.pem config/nginx/ssl/key.pem
sudo chown $(whoami): config/nginx/ssl/*.pem
  1. Automatyczne odnawianie (crontab):
0 0 1 * * certbot renew --quiet && docker compose restart nginx

🐛 Rozwiązywanie problemów

Nginx nie startuje:

# Sprawdź logi
docker logs nginx-proxy

# Sprawdź czy certyfikaty istnieją
ls -la config/nginx/ssl/

Przeglądarka nie łączy się:

# Sprawdź czy port 443 jest otwarty
netstat -tulpn | grep :443

# Test z curl
curl -k https://localhost

"Connection refused":

# Sprawdź czy wszystkie kontenery działają
docker ps

# Sprawdź sieć
docker network inspect ai_ai-network

🚀 Uruchomienie

Po wygenerowaniu certyfikatu:

docker compose up -d

Sprawdź status:

docker compose ps
docker logs nginx-proxy

📊 Monitoring

Logi Nginx:

docker logs -f nginx-proxy

Test SSL:

openssl s_client -connect localhost:443 -servername localhost

Pytania? Sprawdź główny README.md projektu.