Domena i HTTPS
Ustawisz domenę, przygotujesz certyfikat TLS i dowiesz się, jak go odnowić.
Aplikacje łączą się z Gadką wyłącznie szyfrowanym połączeniem. Potrzebujesz domeny i certyfikatu TLS, który wystawiono dla tej domeny.
Jak to działa
- Dołączone reverse proxy (
gadka-proxy.service) odbiera ruch HTTPS na porcie TCP6543i przekazuje go do serwera Gadki na127.0.0.1:8080. - Serwer Gadki sam odbiera połączenia QUIC na porcie UDP
6543. - Oba używają tego samego certyfikatu:
/etc/gadka/tls-cert.pemi/etc/gadka/tls-key.pem.
Krok 1. Ustaw DNS
Dodaj rekord A (IPv4) lub AAAA (IPv6) dla domeny, np. gadka.example.com, wskazujący adres serwera, np. 203.0.113.10.
Sprawdź z innego komputera:
nslookup gadka.example.comKrok 2. Przygotuj certyfikat
Potrzebujesz dwóch plików PEM:
- certyfikat z pełnym łańcuchem (certyfikat serwera, a za nim certyfikaty pośrednie),
- klucz prywatny.
Certyfikat może pochodzić z publicznego urzędu certyfikacji albo z urzędu Twojej firmy. W drugim przypadku komputery pracowników muszą ufać firmowemu urzędowi certyfikacji.
Instalator pyta o ścieżki do obu plików i kopiuje je do /etc/gadka.
Odnowienie certyfikatu
Gdy dostaniesz nowy certyfikat, podmień pliki i uruchom usługi ponownie:
sudo install -o root -g gadka -m 0640 nowy-fullchain.pem /etc/gadka/tls-cert.pem
sudo install -o root -g gadka -m 0640 nowy-klucz.pem /etc/gadka/tls-key.pem
sudo systemctl restart gadka gadka-proxyAplikacje połączą się ponownie same po kilku sekundach.
Zmiana domeny lub portu
Domena i port są zapisane w /etc/gadka/gadka.yaml (klucze api.public_url, auth.issuer, gateway.quic_listen) oraz w /etc/gadka/Caddyfile. Po zmianie w obu plikach uruchom ponownie obie usługi. Użytkownicy muszą wpisać w aplikacji nową domenę.
Rozwiązywanie problemów
| Objaw | Co sprawdzić |
|---|---|
| aplikacja pisze Pod tym adresem nie odpowiada serwer Gadki. | DNS, zaporę i stan usługi gadka-proxy |
| błąd certyfikatu po stronie aplikacji | czy plik zawiera pełny łańcuch i czy domena zgadza się z certyfikatem |
gadka-proxy nie startuje | journalctl -u gadka-proxy -n 50 |