Λειτουργία διακομιστή

Αυτός ο οδηγός απευθύνεται σε διαχειριστές συστημάτων που εγκαθιστούν και εκτελούν έναν διακομιστή Antimatter. Υποθέτει ότι γνωρίζετε Linux, Docker και reverse proxies, αλλά όχι το Antimatter.

Από τι αποτελείται μια εγκατάσταση

Το Antimatter είναι μια αυτοξεζυγισμένη (self-hosted) εφαρμογή ομαδικής συνομιλίας, ένα fork του Mattermost. Μια πλήρης εγκατάσταση αποτελείται από τα εξής μέρη. Μόνο τα πρώτα τρία είναι υποχρεωτικά.

Μέρος	Λειτουργία	Υποχρεωτικό
Ο διακομιστής Antimatter	Ένα πρόγραμμα Go (`antimatter`) που εξυπηρετεί την web εφαρμογή, το API και τα websockets στην θύρα 8065, εκτελεί τις ενσωματωμένες εφαρμογές (plugins) και μεταφέρει τα μέσα των κλήσεων στην θύρα 8443. Το εργαλείο γραμμής εντολών `amctl` το διαχειρίζεται.	ναι
PostgreSQL	Η βάση δεδομένων: μηνύματα, χρήστες, κοινότητες και, στη συνιστώμενη διαμόρφωση, η ρύθμιση του διακομιστή. Έκδοση 15 ή νεότερη.	ναι
Αποθήκευση αρχείων	Ανεβασμένα αρχεία, εικόνες και εγκατεστημένες εφαρμογές: μια S3-συμβατή υπηρεσία (το αρχείο compose εκτελεί RustFS) ή έναν τοπικό κατάλογο.	ναι
Ένας reverse proxy	HTTPS μπροστά από τον διακομιστή: το προφίλ Caddy του αρχείου compose, ή ο δικός σας nginx.	για παραγωγή
Η υπηρεσία GIF (`gifs-server`)	GIFs και αυτοκόλλητα για τον επιλογέα GIF, από τον δικό σας κατάλογο. Ομιλεί την API του Tenor.	όχι
Ένας push proxy	Μεταβιβάζει ειδοποιήσεις στην κινητή εφαρμογή μέσω Apple και Google.	για κινητές ειδοποιήσεις
rtcd, ένας TURN server	Ένας ξεχωριστός διακομιστής μέσων για πολλές κλήσεις, και ένα relay για άτομα πίσω από αυστηρά firewalls.	όχι
AI endpoints	Τα μοντέλα πίσω από την ξαναγραφή, τις αναφορές, τη μετάφραση, την ανάγνωση, τους AI πράκτορες και τη μεταγραφή κλήσεων, προστίθενται ως συνδέσεις μοντέλων: ένας πάροχος στο cloud ή διακομιστές που εκτελείτε εσείς.	όχι

Το Antimatter δεν έχει άδεια χρήσης και δεν έχει πληρωμένη έκδοση: single sign-on, LDAP, υψηλή διαθεσιμότητα, εξαγωγές συμμόρφωσης, διατήρηση δεδομένων και τα άλλα χαρακτηριστικά που το Mattermost κρατάει για τα πληρωμένα του πακέτα, όλα περιλαμβάνονται.

Απαιτήσεις

Ένας διακομιστής Linux, amd64 ή arm64, με 2 πυρήνες CPU και 4 GB μνήμης ή περισσότερο για μερικές εκατοντάδες χρήστες, και χώρο δίσκου για τα αρχεία που ανεβάζουν οι χρήστες.
Docker Engine με το πρόσθετο Compose (docker compose), για την προτεινόμενη εγκατάσταση. Ή, για τα πακέτα, ένας διακομιστής συμβατός με Debian, Ubuntu, Fedora ή RHEL με systemd.
Για παραγωγή: ένα domain name που δείχνει στον διακομιστή, και οι θύρες 80 και 443 ανοιχτές για HTTPS.
Για κλήσεις: η θύρα 8443, UDP και TCP, προσβάσιμη από τα άτομα που κάνουν κλήσεις.
Για email: ένας SMTP διακομιστής μέσω του οποίου το Antimatter μπορεί να στείλει.

Γρήγορη έναρξη

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

Στη συνέχεια, ανοίξτε τη διεύθυνση URL του δικτυακού τόπου και δημιουργήστε τον λογαριασμό σας: ο πρώτος λογαριασμός γίνεται διαχειριστής συστήματος. Το Εγκατάσταση εξηγεί κάθε βήμα και τους άλλους τρόπους εγκατάστασης.

Σε αυτόν τον οδηγό

Εγκατάσταση: Docker Compose, οι εικόνες, ο πρώτος διαχειριστής, τα πακέτα .deb και .rpm, το αρχείο έκδοσης.
Διαμόρφωση: ρυθμίσεις στη βάση δεδομένων ή σε αρχείο, μεταβλητές περιβάλλοντος AM_, Κονσόλα συστήματος, amctl, αρχεία καταγραφής.
Δομένιο και HTTPS: διεύθυνση URL του δικτυακού τόπου, Caddy, nginx, διευθύνσεις πελατών.
Κλήσεις και φωνή: θύρες, NAT, TURN, rtcd, μεταγραφή και υπότιτλοι.
Email και push: SMTP, proxy push και κινητή εφαρμογή.
Ενσωματωμένες εφαρμογές: ποιες εφαρμογές είναι ενεργές, οι ρυθμίσεις τους, εγκατάσταση άλλων.
AI: συνδέσεις μοντέλων, οι ενσωματωμένες λειτουργίες AI, πράκτορες, ομιλία και μετάφραση, το κλειφί κρυπτογράφησης και πού πηγαίνουν τα δεδομένα.
Σύνδεση και λογαριασμοί: εγγραφή, κωδικοί πρόσβασης, MFA, μονοσήμαντη σύνδεση, LDAP, επισκέπτες, συνεδρίες.
Αντιγραφή και αναβαθμίσεις: αντιγραφή, επαναφορά, αναβάθμιση, μεταφορά από Mattermost.
Λειτουργίες: παρακολούθηση, κλιμάκωση, διατήρηση δεδομένων, συμμόρφωση, αντιμετώπιση προβλημάτων.
Ασφάλεια: κατάλογος ενίσχυσης και εξωτερικές συνδέσεις.
Δημοσίευση εφαρμογής επιφάνειας εργασίας: το MSI, η Group Policy και το Intune, τα προφίλ macOS και το αρχείο πολιτικής Linux.

Διαχειρίζεστε μια κοινότητα αντί για έναν διακομιστή (κανάλια, ρόλοι, διαχείριση); Δείτε Διαχείριση κοινότητας. Δημιουργείτε ολοκληρώματα; Δείτε Δημιουργία σε Antimatter.

Η πρώτη σας ώρα

Εγκαταστήστε και δημιουργήστε αμέσως τον λογαριασμό διαχειριστή.
Τοποθετήστε τον διακομιστή πίσω από HTTPS σε δικό του δομένιο.
Διαμορφώστε SMTP και στείλτε ένα δοκιμαστικό email.
Ανοίξτε τη θύρα κλήσεων. Για μια εταιρεία, ορίστε τον τύπο των νέων κοινοτήτων σε Χώρο εργασίας, ώστε οι κλήσεις να είναι ενεργές στα κανάλια.
Αποφασίστε ποιοι μπορούν να εγγραφούν και ενεργοποιήστε MFA.
Εξετάστε τις εξωτερικές συνδέσεις στην ενότητα Ασφάλεια.
Ρυθμίστε καθημερινά αντίγραφα ασφαλείας. Πριν προσθέσετε συνδέσεις μοντέλων AI, ορίστε το κλειδί κρυπτογράφησης AI.

Λήψη βοήθειας

Τα ερωτήματα μπορείτε να τα θέτετε στις συζητήσεις της κοινότητας, ενώ τα σφάλματα αναφέρετε στο αποθετήριο της κοινότητας. Τα θέματα ασφαλείας αναφέρονται ιδιωτικά, όπως εξηγεί η πολιτική ασφαλείας.