Menjalankan pelayan

Panduan ini adalah untuk pentadbir sistem yang memasang dan mengendalikan pelayan Antimatter. Ia andaikan anda memahami Linux, Docker dan proksi songsang, tetapi tidak Antimatter.

Apa yang membentuk satu pelayaran

Antimatter ialah sembang pasukan yang dihoskan sendiri, sebuah fork Mattermost. Satu pelayaran lengkap mempunyai bahagian-bahagian berikut. Hanya tiga bahagian pertama yang diperlukan.

Bahagian	Fungsinya	Diperlukan
Pelayan Antimatter	Satu program Go (`antimatter`) yang menyediakan aplikasi web, API dan websockets pada port 8065, menjalankan aplikasi terikat (plugin), dan membawa media panggilan pada port 8443. Alat baris arahan `amctl` mengendalikannya.	ya
PostgreSQL	Pangkalan data: mesej, pengguna, komuniti dan, dalam tetapan yang disyorkan, konfigurasi pelayan. Versi 15 atau lebih baharu.	ya
Penyimpanan fail	Fail, imej dan aplikasi yang dimuat naik: perkhidmatan yang serasi dengan S3 (fail compose menjalankan RustFS), atau direktori setempat.	ya
Proksi songsang	HTTPS di hadapan pelayan: profil Caddy dalam fail compose, atau nginx anda sendiri.	untuk pengeluaran
Perkhidmatan GIF (`gifs-server`)	GIF dan pelekat untuk pemilih GIF, daripada katalog anda sendiri. Ia bercakap API Tenor.	tidak
Proksi tolakan	Meneruskan pemberitahuan ke aplikasi mudah alih melalui Apple dan Google.	untuk pemberitahuan mudah alih
rtcd, sebuah pelayan TURN	Pelayan media berasingan untuk banyak panggilan, dan relay untuk orang di sebalik tembok api yang ketat.	tidak
Titik akhir AI	Model di sebalik penulisan semula, ringkasan, penterjemahan, pembacaan suara, ejen AI dan transkripsi panggilan, yang ditambah sebagai sambungan model: pelayan awan atau pelayan yang anda kendalikan.	tidak

Antimatter tiada lesen dan tiada edisi berbayar: log masuk tunggal, LDAP, kebolehgunaan tinggi, eksport pematuhan, pemeliharaan data dan ciri-ciri lain yang Mattermost simpan untuk pelan berbayarnya semuanya disertakan.

Keperluan

Pelayan Linux, amd64 atau arm64, dengan 2 teras CPU dan 4 GB memori atau lebih untuk beberapa ratus orang, dan ruang cakera untuk fail yang dimuat naik oleh pengguna.
Docker Engine dengan plugin Compose (docker compose), untuk pemasangan yang disyorkan. Atau, untuk pakej, pelayan yang serasi dengan Debian, Ubuntu, Fedora atau RHEL dengan systemd.
Untuk pengeluaran: nama domain yang menunjuk ke pelayan, dan port 80 dan 443 dibuka untuk HTTPS.
Untuk panggilan: port 8443, UDP dan TCP, boleh dicapai oleh orang yang membuat panggilan.
Untuk e-mel: pelayan SMTP yang Antimatter boleh hantar melaluinya.

Mula cepat

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

Kemudian buka URL laman web dan cipta akaun anda: akaun pertama menjadi pentadbir sistem. Pemasangan menerangkan setiap langkah dan cara pemasangan yang lain.

Dalam panduan ini

Pemasangan: Docker Compose, imej, pentadbir pertama, pakej .deb dan .rpm, arkib pelepasan.
Konfigurasi: tetapan dalam pangkalan data atau fail, pemboleh ubah persekitaran AM_, Konsol Sistem, amctl, log.
Domain dan HTTPS: URL laman web, Caddy, nginx, alamat klien.
Panggilan dan suara: port, NAT, TURN, rtcd, transkripsi dan kapsyen.
E-mel dan tolakan: SMTP, proksi tolakan dan aplikasi mudah alih.
Aplikasi terikat: aplikasi yang diaktifkan, tetapan mereka, pemasangan aplikasi lain.
AI: sambungan model, ciri AI terbina dalam, ejen, suara dan penterjemahan, kunci penyulitan, dan data yang dihantar ke mana.
Log masuk dan akaun: daftar, kata laluan, MFA, log masuk tunggal, LDAP, tetamu, sesi.
Sandaran dan peningkatan: sandaran, pulih, peningkatan, perpindahan dari Mattermost.
Operasi: pemantauan, penskalaan, pemeliharaan data, pematuhan, penyelesaian masalah.
Keselamatan: senarai semak pengukuhan dan sambungan luaran.
Pelaksanaan aplikasi desktop: MSI, Group Policy dan Intune, profil macOS dan fail dasar Linux.

Mengurus komuniti bukannya pelayan (saluran, peranan, moderasi)? Lihat Mengurus komuniti. Membina integrasi? Lihat Membina di atas Antimatter.

Jam pertama anda

Pasang, dan cipta akaun pentadbir serta-merta.
Letakkan pelayen di belakang HTTPS pada domainnya sendiri.
Konfigurasikan SMTP dan hantar e-mel ujian.
Buka port panggilan. Untuk sebuah syarikat, tetapkan jenis komuniti baharu kepada Tempat kerja, supaya panggilan dihidupkan dalam saluran.
Tentukan siapa yang boleh mendaftar, dan aktifkan MFA.
Semak sambungan luaran dalam Keselamatan.
Tetapkan sandaran harian. Sebelum menambah sambungan model AI, tetapkan kunci penyulitan AI.

Mendapat bantuan

Tanya soalan dalam perbincangan komuniti, dan laporkan pepijat dalam repo komuniti. Laporkan masalah keselamatan secara peribadi, seperti yang diterangkan dalam dasar keselamatan.