Spis treści dokumentacji

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 TCP 6543 i przekazuje go do serwera Gadki na 127.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.pem i /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.com

Krok 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-proxy

Aplikacje 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

ObjawCo sprawdzić
aplikacja pisze Pod tym adresem nie odpowiada serwer Gadki.DNS, zaporę i stan usługi gadka-proxy
błąd certyfikatu po stronie aplikacjiczy plik zawiera pełny łańcuch i czy domena zgadza się z certyfikatem
gadka-proxy nie startujejournalctl -u gadka-proxy -n 50

Co dalej