Palvelimen ajaminen

Tämä ohje on tarkoitettu järjestelmän ylläpitäjille, jotka asentavat ja käyttävät Antimatter-palvelinta. Ohje olettaa, että tunnet Linuxin, Dockerin ja käänteiset proxyt, mutta et Antimatteria.

Asennuksen osat

Antimatter on itsenäisesti isännöitävä tiimichat, joka on Mattermostin haarautuma. Täydellinen asennus koostuu näistä osista. Vain kolme ensimmäistä ovat pakollisia.

Osa	Toiminto	Pakollinen
Antimatter-palvelin	Yksi Go-ohjelma (`antimatter`), joka palvelee web-sovellusta, API:ta ja websockeja portissa 8065, ajaa mukana toimitettuja sovelluksia (liitännäisiä) ja kuljettaa puheluiden mediaa portissa 8443. Komennonrivityökalu `amctl` hallitsee sitä.	kyllä
PostgreSQL	Tietokanta: viestit, käyttäjät, yhteisöt ja suositellussa asennuksessa palvelimen asetukset. Versio 15 tai uudempi.	kyllä
Tiedostovarasto	Lähetetyt tiedostot, kuvat ja asennetut sovellukset: S3-yhteensopiva palvelu (compose-tiedostossa RustFS) tai paikallinen hakemisto.	kyllä
Käänteinen proxy	HTTPS palvelimen edessä: compose-tiedoston Caddy-profiili tai oma nginx.	tuotantoympäristöön
GIF-palvelu (`gifs-server`)	GIFit ja tarrat GIF-valitsimelle, omasta katalogistasi. Se käyttää Tenor API:ta.	ei
Push-proxy	Vierittää ilmoitukset mobiilisovellukseen Applen ja Googlen kautta.	mobiililaitteiden ilmoituksiin
rtcd, TURN-palvelin	Eri media-palvelin monille puheluille ja välityspalvelin tiukkojen palomuurien takana oleville käyttäjille.	ei
AI-päätepisteet	Composerin uudelleenkirjoitusta, tiivistelmiä, käännöksiä, ääntä, tekoälyagenteja ja puhelutranskription takana olevat mallit, jotka lisätään malliyhteyksinä: pilvipalveluntarjoaja tai omat palvelimesi.	ei

Antimatterilla ei ole lisenssiä eikä maksullista versiota: yksittäisilmoitus, LDAP, korkea saatavuus, noudattamistarkastelut, tietojen säilytys ja muut ominaisuudet, jotka Mattermost varaa maksullisille paketeille, ovat kaikki mukana.

Vaadittavat edellytykset

Linux-palvelin, amd64 tai arm64, jossa on 2 CPU-ydintä ja 4 GB muistia tai enemmän muutamaan sataan käyttäjään, sekä levytallennustilaa lähetetyille tiedostoille.
Docker Engine Compose-liitännäisellä (docker compose) suositeltua asennusta varten. Paketteja varten Debian-, Ubuntu-, Fedora- tai RHEL-yhteensopiva palvelin, jossa systemd.
Tuotantoympäristöön: verkkonimi, joka osoittaa palvelimeen, sekä portit 80 ja 443 auki HTTPS:ää varten.
Puheluja varten: portti 8443, UDP ja TCP, puheluiden käyttäjien tavoittamissa.
Sähköpostia varten: SMTP-palvelin, jonka kautta Antimatter voi lähettää.

Pikakäynnistys

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

Avaa sitten sivuston URL-osoite ja luo tilisi: ensimmäinen tili tulee järjestelmän ylläpitäjäksi. Asennus -ohjeessa käydään läpi jokainen vaihe ja muut asennustavat.

Tässä oppaassa

Asennus: Docker Compose, kuvat, ensimmäinen ylläpitäjä, .deb- ja .rpm-paketit sekä julkaisukokoelma.
Määritys: asetukset tietokannassa tai tiedostossa, AM_-ympäristömuuttujat, Järjestelmäkonsoli, amctl ja lokit.
Domaini ja HTTPS: sivuston URL-osoite, Caddy, nginx ja asiakasosoitteet.
Puhelut ja ääni: portit, NAT, TURN, rtcd, transkriptio ja titrat.
Sähköposti ja push-ilmoitukset: SMTP, push-välityspalvelin ja mobiilisovellus.
Sisällytetyt sovellukset: mitkä sovellukset ovat käytössä, niiden asetukset ja muiden sovellusten asennus.
Tekoäly: malliyhteydet, sisäänrakennetut tekoälyominaisuudet, agentit, puhe ja käännös, salausavain sekä tietojen siirtyminen.
Kirjautuminen ja tilit: rekisteröityminen, salasanat, MFA, single sign-on, LDAP, vieraat ja istunnot.
Varmuuskopiot ja päivitykset: varmuuskopiointi, palautus, päivitys ja siirtyminen Mattermostista.
Toiminta: valvonta, skaalaus, tietojen säilytys, noudattaminen ja vianetsintä.
Turvallisuus: turvausohjeet ja ulkoiset yhteydet.
Työpöytäsovelluksen käyttöönotto: MSI, Group Policy ja Intune, macOS-profiilit ja Linux-asetustiedosto.

Haluatko ylläpitää yhteisöä eikä pelkkää palvelinta (kanavat, roolit, moderoiminen)? Katso Yhteisön ylläpito. Rakennatko integraatioita? Katso Rakentaminen Antimatterin päälle.

Ensimmäinen tunti

Asenna ja luo ylläpitäjätili heti.
Aseta palvelin HTTPS:n taakse omalle domainille.
Määritä SMTP ja lähetä testisähköposti.
Avaa puheluiden portti. Yritykselle asetetaan uusien yhteisöjen tyypiksi Työtila, jotta puhelut ovat käytössä kanavissa.
Päätä, ketkä voivat rekisteröityä, ja ota MFA käyttöön.
Tarkista ulkoiset yhteydet Turvallisuus -ohjeessa.
Aseta päivittäiset varmuuskopiot. Aseta tekoälyn salausavain ennen tekoälymalliyhteyksien lisäämistä.

Apua

Kysy kysymyksiä yhteisön keskusteluissa ja ilmoita virheistä yhteisön varastossa. Ilmoita tietoturvaongelmista yksityisesti, kuten tietoturvakäytäntö ohjeistaa.