Spis treści dokumentacji

Zapora i porty

Otworzysz w zaporze dokładnie te porty, których Gadka potrzebuje.

Gadka używa jednego publicznego numeru portu dla TCP i UDP. Pozostałe porty słuchają tylko lokalnie i nie wolno wystawiać ich na zewnątrz.

Ruch przychodzący

PortProtokółKto słuchaDo czego
6543TCPreverse proxyHTTPS: logowanie, interfejs API, pliki, WebSocket
6543UDPserwer Gadkipołączenie QUIC aplikacji

Jeśli w instalatorze podałeś inny port, otwórz ten numer zamiast 6543.

Porty wewnętrzne (nie otwieraj)

AdresDo czego
127.0.0.1:8080serwer Gadki za reverse proxy
127.0.0.1:9090stan i metryki: /healthz, /readyz, /metrics, bez uwierzytelnienia

Ruch wychodzący z serwera

DokądKiedy
hole.cert.pl:443zawsze, gdy włączone jest sprawdzanie linków (domyślnie)
dostawca tożsamości (IdP)gdy skonfigurujesz logowanie SSO
oauth2.googleapis.com, www.googleapis.comgdy włączysz kalendarz Google
login.microsoftonline.com, graph.microsoft.comgdy włączysz kalendarz Microsoft 365
serwery CalDAV z listy dozwolonychgdy włączysz CalDAV
linkowane stronygdy włączysz podglądy linków

Serwer bez dostępu do internetu działa normalnie. Wskaż wtedy własną kopię Listy Ostrzeżeń albo wyłącz sprawdzanie. Zobacz Podglądy i bezpieczeństwo linków.

Przykład: ufw

sudo ufw allow 6543/tcp
sudo ufw allow 6543/udp

QUIC i sieci blokujące UDP

Aplikacja zaczyna od QUIC (UDP), bo jest szybszy i lepiej znosi zmianę sieci. Jeśli po drodze ktoś blokuje UDP, aplikacja sama przechodzi na WebSocket po TCP na tym samym porcie. Gadka działa więc także wtedy, gdy otworzysz tylko TCP 6543, ale otwarcie obu protokołów daje lepsze połączenie.

Komputery użytkowników

Komputery pracowników muszą mieć dostęp do gadka.example.com na porcie 6543 (TCP i najlepiej UDP). Aplikacje desktopowe sprawdzają też aktualizacje pod adresem gadka.lemric.com, który przekierowuje pobieranie paczek do serwisu GitHub (TCP 443).

Co dalej