Szerver üzemeltetése

Ez az útmutató azoknak a rendszeradministrátoroknak szól, akik telepítik és üzemeltetik egy Antimatter-szervert. Felteheti, hogy ismeri a Linuxot, a Dockert és a fordított proxykat, de nem az Antimattert.

Mi áll össze egy telepítésből

Az Antimatter egy önállóan üzemeltethető csapatszintű chat, a Mattermost forkja. Egy teljes telepítés az alábbi részekből áll. Csak az első három kötelező.

Rész	Mire szolgál	Kötelező
Az Antimatter-szerver	Egy Go program (`antimatter`), amely kiszolgálja a webböngészős alkalmazást, az API-t és a websocketeket a 8065-ös porton, futtatja a beépített alkalmazásokat (bővítményeket), és a 8443-as porton hordozza a hívások médiumát. Az `amctl` parancssori eszköz kezeli.	igen
PostgreSQL	A adatbázis: üzenetek, felhasználók, közösségek és, a javasolt beállításban, a szerver konfigurációja. 15-ös verzió vagy újabb.	igen
Fájltárolás	Feltöltött fájlok, képek és telepített alkalmazások: S3-kompatibilis szolgáltatás (a compose fájl RustFS-t futtat), vagy helyi könyvtár.	igen
Egy fordított proxy	HTTPS a szerver előtt: a compose fájl Caddy profilja, vagy saját nginx.	éles környezetben
A GIF-szolgáltatás (`gifs-server`)	GIF-ek és matricák a GIF-választóhoz, a saját katalógusból. A Tenor API-t használja.	nem
Egy push proxy	Az értesítéseket továbbítja a mobilalkalmazásba az Apple és a Google keresztül.	mobil értesítésekhez
rtcd, egy TURN-szerver	Egy különálló médiaszerver sok híváshoz, és egy átkötő szerver szigorú tűzfal mögött lévők számára.	nem
AI végpontok	A szerkesztő újragenerálásáért, összefoglalásaiért, fordításáért, felolvasásáért, AI-ügynökeiért és a hívás átirataiért felelős modellek, mint modellkapcsolatok: felhőszolgáltató vagy saját üzemeltetésű szerverek.	nem

Az Antimatternek nincs licencje és nincs fizetős kiadása: az egyszeri bejelentkezés, LDAP, a nagy rendelkezésre állás, a megfelelőségi exportok, az adatmegőrzés és a többi funkció, amelyet a Mattermost fizetős csomagjainak tart fenn, mind benne van.

Követelmények

Egy Linux szerver, amd64 vagy arm64 architektúrával, 2 CPU maggal és 4 GB memóriával vagy többel néhány száz felhasználóhoz, valamint lemezterület a feltöltött fájlokhoz.
Docker Engine Compose-bővítménnyel (docker compose) a javasolt telepítéshez. Vagy a csomagokhoz Debian, Ubuntu, Fedora vagy RHEL-kompatibilis szerver systemd-del.
Éles környezetben: egy a szerverre mutató domain név, és a 80-as és 443-as portok nyitva az HTTPS-hez.
Hívásokhoz: a 8443-as port, UDP és TCP, elérhető a hívók számára.
E-mailhöz: egy SMTP-szerver, amelyen keresztül az Antimatter küldhet.

Gyors kezdés

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

Ezután nyissa meg a webhely URL-címét, és hozza létre a fiókját: az első fiók a rendszer adminisztrátora lesz. Az Telepítés részletesen bemutatja a lépéseket és a telepítés egyéb módjait.

Ez az útmutató

Telepítés: Docker Compose, a képek, az első adminisztrátor, a .deb és .rpm csomagok, a kiadási archívum.
Konfiguráció: beállítások adatbázisban vagy fájlban, AM_ környezeti változók, Rendszerkonzol, amctl, naplók.
Domén és HTTPS: a webhely URL-címe, Caddy, nginx, kliens-címek.
Hívások és hang: portok, NAT, TURN, rtcd, átirat és feliratok.
E-mail és push: SMTP, push proxy és mobilalkalmazás.
Beépített alkalmazások: melyek vannak bekapcsolva, beállításuk, mások telepítése.
AI: modellkapcsolatok, a beépített AI-funkciók, ügynökök, beszéd és fordítás, a titkosítási kulcs, valamint hogy mely adatok hová kerülnek.
Bejelentkezés és fiókok: regisztráció, jelszavak, MFA, egységes bejelentkezés, LDAP, vendégek, munkamenetek.
Biztonsági mentések és frissítések: mentés, visszaállítás, frissítés, átvándorlás a Mattermostból.
Működtetés: figyelés, méretezés, adatmegőrzés, megfelelőség, hibaelhárítás.
Biztonság: megerősítési ellenőrzőlista és külső kapcsolatok.
Asztali alkalmazás telepítése: MSI, Group Policy és Intune, macOS-profilok és a Linux-szabályzat-fájl.

Nem szervert, hanem közösséget szeretne működtetni (csatornák, szerepek, moderálás)? Lásd: Közösség működtetése. Integrációkat szeretne készíteni? Lásd: Fejlesztés az Antimatteren.

Az első órája

Telepítse, és azonnal hozza létre az adminisztrátori fiókot.
Helyezze a szervert HTTPS mögé saját doménre.
Állítsa be az SMTP-t, és küldjön egy teszt e-mailt.
Nyissa meg a hívások portját. Vállalatok esetén állítsa be az új közösségek típusát Munkahely értékre, hogy a csatornákban a hívások engedélyezve legyenek.
Döntse el, ki regisztrálhat, és kapcsolja be az MFA-t.
Nézze át a külső kapcsolatokat a Biztonság oldalon.
Állítsa be a napi mentéseket. Az AI modellkapcsolatok hozzáadása előtt állítsa be az AI titkosítási kulcsot.

Segítségkérés

Kérdezz a közösségi vitafórumon, és jelezz hibákat a közösségi repozitóriumban. Biztonsági problémákat privát módon jelezz, ahogy a biztonsági irányelv is leírja.