Execució d'un servidor

Aquesta guia és per als administradors de sistemes que instal·len i fan servir un servidor d'Antimatter. Suposa que coneixeu Linux, Docker i els servidors inversos, però no Antimatter.

Què conté un desplegament

Antimatter és un xat d'equip autoallotjat, un bifurcament de Mattermost. Un desplegament complet té aquestes parts. Només les tres primeres són obligatòries.

Part	Què fa	Obligatori
El servidor d'Antimatter	Un programa en Go (`antimatter`) que serveix l'aplicació web, l'API i els websockets al port 8065, executa les aplicacions integrades (plugins) i transporta els mitjans de les trucades al port 8443. L'eina de línia d'ordres `amctl` la gestiona.	sí
PostgreSQL	La base de dades: missatges, usuaris, comunitats i, en la configuració recomanada, la configuració del servidor. Versió 15 o superior.	sí
Emmagatzematge de fitxers	Fitxers penjats, imatges i aplicacions instal·lades: un servei compatible amb S3 (el fitxer compose executa RustFS) o un directori local.	sí
Un servidor invers	HTTPS davant del servidor: el perfil Caddy del fitxer compose, o el vostre propi nginx.	per a producció
El servei de GIF (`gifs-server`)	GIF i adhesius per al selector de GIF, des del vostre propi catàleg. Parla l'API de Tenor.	no
Un proxy de notificacions push	Reenvia les notificacions a l'aplicació mòbil a través d'Apple i Google.	per a notificacions mòbils
rtcd, un servidor TURN	Un servidor de mitjans independent per a moltes trucades, i un relé per a les persones darrere de parets de seguretat estrictes.	no
Endpoints d'IA	Els models darrere de la reescriptura del compositor, els resums, la traducció, la lectura en veu alta, els agents d'IA i la transcripció de trucades, afegits com a connexions de models: un proveïdor de núvol o servidors que executeu.	no

Antimatter no té llicència ni edició de pagament: l'inici de sessió únic, LDAP, l'alta disponibilitat, les exportacions de compliment, la retenció de dades i les altres funcions que Mattermost reserva per als seus plans de pagament estan totes incloses.

Requisits

Un servidor Linux, amd64 o arm64, amb 2 nuclis de CPU i 4 GB de memòria o més per a pocs centenars de persones, i espai a disc per als fitxers que la gent penja.
Docker Engine amb el connector Compose (docker compose), per a la instal·lació recomanada. O bé, per als paquets, un servidor compatible amb Debian, Ubuntu, Fedora o RHEL amb systemd.
Per a producció: un nom de domini que apunti al servidor, i els ports 80 i 443 oberts per a HTTPS.
Per a trucades: el port 8443, UDP i TCP, accessible per a les persones que truquen.
Per a correu electrònic: un servidor SMTP pel qual Antimatter pugui enviar.

Inici ràpid

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

Després, obre l'URL del lloc i crea el teu compte: el primer compte es converteix en administrador del sistema. Instal·lació explica cada pas i les altres maneres d'instal·lar.

En aquesta guia

Instal·lació: Docker Compose, les imatges, el primer administrador, els paquets .deb i .rpm, l'arxiu de la versió.
Configuració: paràmetres a la base de dades o a un fitxer, variables d'entorn AM_, la Consola del sistema, amctl, registres.
Domini i HTTPS: l'URL del lloc, Caddy, nginx, adreces del client.
Trucades i veu: ports, NAT, TURN, rtcd, transcripció i subtítols.
Correu i notificacions push: SMTP, el proxy de notificacions push i l'aplicació mòbil.
Aplicacions integrades: quines aplicacions estan activades, la seva configuració, instal·lar-ne d'altres.
IA: connexions de models, les funcions d'IA integrades, els agents, el veu i la traducció, la clau de xifratge i quines dades van a on.
Inici de sessió i comptes: registre, contrasenyes, MFA, inici de sessió únic, LDAP, invitats, sessions.
Còpies de seguretat i actualitzacions: còpia de seguretat, restauració, actualització, migració des de Mattermost.
Operacions: supervisió, escalabilitat, retenció de dades, compliment, resolució de problemes.
Seguretat: llista de verificació per a l'enduriment i connexions externes.
Desplegament de l'aplicació d'escriptori: l'MSI, la Política de grup i Intune, els perfils de macOS i el fitxer de política de Linux.

Vols gestionar una comunitat en lloc d'un servidor (canals, rols, moderació)? Consulta Gestió d'una comunitat. Vols crear integracions? Consulta Desenvolupament a Antimatter.

La teva primera hora

Instal·la i crea el compte d'administrador immediatament.
Posa el servidor darrere d'HTTPS al seu propi domini.
Configura SMTP i envia un correu de prova.
Obriu el port de trucades. Per a una empresa, configureu el tipus de noves comunitats com a Espai de treball, de manera que les trucades estiguin activades als canals.
Decideix qui pot registrar-se i activa MFA.
Revisa les connexions externes a Seguretat.
Configureu les còpies de seguretat diàries. Abans d'afegir connexions de models d'IA, configureu la clau de xifratge de la IA.

Obtenció d'ajuda

Fes preguntes a les discussions de la comunitat i informa dels errors al repositori de la comunitat. Informa dels problemes de seguretat de manera privada, com s'explica a la política de seguretat.