Uruchamianie serwera

Ten przewodnik jest przeznaczony dla administratorów systemów instalujących i uruchamiających serwer Antimatter. Zakłada, że znasz Linuxa, Dockera i serwery odwrotne (reverse proxy), ale nie znasz Antimatter.

Z czego składa się wdrożenie

Antimatter to samodzielnie hostowany czat zespołowy, fork Mattermost. Pełne wdrożenie składa się z poniższych elementów. Tylko pierwsze trzy są wymagane.

Element	Opis	Wymagany
Serwer Antimatter	Jedna aplikacja napisana w Go (`antimatter`), która serwuje aplikację webową, API i websockety na porcie 8065, uruchamia wbudowane aplikacje (wtyczki) i przenosi media rozmów na porcie 8443. Zarządza nią narzędzie wiersza poleceń `amctl`.	tak
PostgreSQL	Baza danych: wiadomości, użytkownicy, społeczności oraz, w zalecanym ustawieniu, konfiguracja serwera. Wersja 15 lub nowsza.	tak
Magazyn plików	Przesłane pliki, obrazy i zainstalowane aplikacje: usługa zgodna z S3 (plik compose uruchamia RustFS) lub lokalny katalog.	tak
Serwer odwrotny (reverse proxy)	HTTPS przed serwerem: profil Caddy z pliku compose lub własny nginx.	dla środowiska produkcyjnego
Usługa GIF (`gifs-server`)	GIF-y i naklejki do wyboru GIF-ów, z własnego katalogu. Obsługuje API Tenor.	nie
Proxy push	Przekazuje powiadomienia do aplikacji mobilnej za pośrednictwem Apple i Google.	dla powiadomień mobilnych
rtcd, serwer TURN	Osobny serwer mediów dla wielu rozmów oraz przekaźnik dla osób znajdujących się za restrykcyjnymi zaporami sieciowymi.	nie
Punkty końcowe AI	Modele stojące za funkcjami przeformułowywania, podsumowań, tłumaczenia, odczytu na głos, agentów AI oraz transkrypcji rozmów, dodane jako połączenia z modelami: dostawca chmurowy lub serwery, które uruchamiasz.	nie

Antimatter nie ma licencji ani płatnej edycji: jednorazowe logowanie (SSO), LDAP, wysoka dostępność, eksporty zgodności, retencja danych i inne funkcje, które Mattermost rezerwuje dla planów płatnych, są w nim zawarte.

Wymagania

Serwer Linux, amd64 lub arm64, z 2 rdzeniami CPU i 4 GB pamięci RAM lub więcej dla kilkuset osób, oraz przestrzenią na dysku dla plików przesyłanych przez użytkowników.
Docker Engine z wtyczką Compose (docker compose) dla zalecanej instalacji. W przypadku pakietów: serwer zgodny z Debian, Ubuntu, Fedora lub RHEL z systemd.
Dla środowiska produkcyjnego: nazwa domeny wskazująca na serwer oraz otwarte porty 80 i 443 dla HTTPS.
Dla rozmów: port 8443, UDP i TCP, dostępny dla osób prowadzących rozmowy.
Dla poczty e-mail: serwer SMTP, przez który Antimatter może wysyłać wiadomości.

Szybki start

mkdir antimatter && cd antimatter
curl -fsSLO https://antimatter.chat/compose.yaml
cat > .env <<EOF
SITE_URL=http://localhost:8065
POSTGRES_PASSWORD=$(openssl rand -hex 24)
S3_SECRET_KEY=$(openssl rand -hex 24)
GIFS_API_KEY=$(openssl rand -hex 24)
AM_AI_ENCRYPTION_KEY=$(openssl rand -base64 32)
EOF
docker compose up -d

Następnie otwórz adres URL witryny i utwórz konto: pierwsze konto staje się administratorem systemu. Instalacja wyjaśnia każdy krok oraz inne metody instalacji.

W tym przewodniku

Instalacja: Docker Compose, obrazy, pierwszy administrator, pakiety .deb i .rpm oraz archiwum wydania.
Konfiguracja: ustawienia w bazie danych lub pliku, zmienne środowiskowe AM_, Konsola systemu, amctl, dzienniki.
Domena i HTTPS: adres URL witryny, Caddy, nginx, adresy klientów.
Rozmowy i głos: porty, NAT, TURN, rtcd, transkrypcja i napisy.
E-mail i powiadomienia push: SMTP, proxy push i aplikacja mobilna.
Aplikacje wbudowane: które aplikacje są włączone, ich ustawienia, instalacja innych.
AI: połączenia z modelami, wbudowane funkcje AI, agenci, mowa i tłumaczenie, klucz szyfrowania oraz informacje o tym, jakie dane są gdzie przechowywane.
Logowanie i konta: rejestracja, hasła, MFA, jednokrotne logowanie (SSO), LDAP, goście, sesje.
Kopie zapasowe i aktualizacje: tworzenie kopii zapasowej, przywracanie, aktualizacja, migracja z Mattermost.
Operacje: monitorowanie, skalowanie, retencja danych, zgodność, rozwiązywanie problemów.
Bezpieczeństwo: lista kontrolna wzmacniania i połączenia zewnętrzne.
Wdrażanie aplikacji desktopowej: MSI, Group Policy i Intune, profile macOS oraz plik polityki dla Linuxa.

Prowadzisz społeczność, a nie serwer (kanały, role, moderacja)? Zobacz Prowadzenie społeczności. Tworzysz integracje? Zobacz Tworzenie na Antimatter.

Twoja pierwsza godzina

Zainstaluj i od razu utwórz konto administratora.
Umieść serwer za HTTPS na własnej domenie.
Skonfiguruj SMTP i wyślij e-mail testowy.
Otwórz port dla rozmów. W przypadku firmy ustaw typ nowych społeczności na Miejsce pracy, aby rozmowy były dostępne w kanałach.
Zdecyduj, kto może się zarejestrować, i włącz MFA.
Przejrzyj połączenia zewnętrzne w Bezpieczeństwie.
Skonfiguruj codzienne kopie zapasowe. Przed dodaniem połączeń z modelami AI ustaw klucz szyfrowania AI.

Pomoc

Zadawaj pytania w dyskusjach społeczności i zgłaszaj błędy w repozytorium społeczności. Problemy bezpieczeństwa zgłaszaj prywatnie, zgodnie z polityką bezpieczeństwa.