Menjalankan server

Panduan ini ditujukan untuk administrator sistem yang menginstal dan menjalankan server Antimatter. Panduan ini mengasumsikan Anda sudah familiar dengan Linux, Docker, dan reverse proxy, tetapi belum familiar dengan Antimatter.

Komponen sebuah deployment

Antimatter adalah obrolan tim self-hosted, sebuah fork dari Mattermost. Deployment lengkap terdiri dari bagian-bagian berikut. Hanya tiga bagian pertama yang wajib.

Bagian	Fungsinya	Wajib
Server Antimatter	Satu program Go (`antimatter`) yang menyajikan web app, API, dan websockets pada port 8065, menjalankan aplikasi bawaan (plugin), dan membawa media panggilan pada port 8443. Alat baris perintah `amctl` mengelolanya.	ya
PostgreSQL	Basis data: pesan, pengguna, komunitas, dan, dalam konfigurasi yang direkomendasikan, konfigurasi server. Versi 15 atau lebih baru.	ya
Penyimpanan file	File, gambar, dan aplikasi yang diunggah: layanan kompatibel S3 (file compose menjalankan RustFS), atau direktori lokal.	ya
Reverse proxy	HTTPS di depan server: profil Caddy dari file compose, atau nginx Anda sendiri.	untuk produksi
Layanan GIF (`gifs-server`)	GIF dan stiker untuk pemilih GIF, dari katalog Anda sendiri. Layanan ini berbicara API Tenor.	tidak
Push proxy	Meneruskan notifikasi ke aplikasi seluler melalui Apple dan Google.	untuk notifikasi seluler
rtcd, server TURN	Server media terpisah untuk banyak panggilan, dan relay untuk orang-orang di balik firewall ketat.	tidak
Endpoint AI	Model-model di balik penulisan ulang, ringkasan, terjemahan, pembacaan suara, agen AI, dan transkripsi panggilan oleh composer, yang ditambahkan sebagai koneksi model: penyedia cloud atau server yang Anda jalankan.	tidak

Antimatter tidak memiliki lisensi dan tidak ada edisi berbayar: single sign-on, LDAP, ketersediaan tinggi, ekspor kepatuhan, retensi data, dan fitur-fitur lain yang Mattermost simpan untuk paket berbayarnya semuanya disertakan.

Persyaratan

Server Linux, amd64 atau arm64, dengan 2 core CPU dan 4 GB memori atau lebih untuk beberapa ratus orang, serta ruang disk untuk file yang diunggah oleh pengguna.
Docker Engine dengan plugin Compose (docker compose), untuk instalasi yang direkomendasikan. Atau, untuk paket, server Debian, Ubuntu, Fedora, atau kompatibel RHEL dengan systemd.
Untuk produksi: nama domain yang menunjuk ke server, dan port 80 dan 443 terbuka untuk HTTPS.
Untuk panggilan: port 8443, UDP dan TCP, dapat dijangkau oleh orang-orang yang melakukan panggilan.
Untuk email: server SMTP yang dapat digunakan Antimatter untuk mengirim.

Mulai 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

Lalu buka URL situs dan buat akun Anda: akun pertama menjadi administrator sistem. Pemasangan menjelaskan setiap langkah dan cara pemasangan lainnya.

Dalam panduan ini

Instalasi: Docker Compose, image, administrator pertama, paket .deb dan .rpm, arsip rilis.
Konfigurasi: pengaturan di database atau file, variabel lingkungan AM_, Konsol Sistem, amctl, log.
Domain dan HTTPS: URL situs, Caddy, nginx, alamat klien.
Panggilan dan suara: port, NAT, TURN, rtcd, transkripsi dan teks langsung.
Email dan push: SMTP, proxy push, dan aplikasi seluler.
Aplikasi bawaan: aplikasi yang aktif, pengaturannya, dan pemasangan aplikasi lain.
AI: koneksi model, fitur AI bawaan, agen, suara dan terjemahan, kunci enkripsi, dan ke mana data dikirim.
Masuk dan akun: pendaftaran, kata sandi, MFA, single sign-on, LDAP, tamu, sesi.
Cadangan dan peningkatan: cadangan, pemulihan, peningkatan, migrasi dari Mattermost.
Operasi: pemantauan, penskalaan, retensi data, kepatuhan, pemecahan masalah.
Keamanan: daftar periksa penguatan dan koneksi keluar.
Distribusi aplikasi desktop: MSI, Group Policy dan Intune, profil macOS, dan file kebijakan Linux.

Mengelola komunitas alih-alih server (kanal, peran, moderasi)? Lihat Mengelola komunitas. Membangun integrasi? Lihat Membangun di Antimatter.

Jam pertama Anda

Pasang, dan buat akun administrator segera.
Letakkan server di belakang HTTPS pada domain sendiri.
Konfigurasikan SMTP dan kirim email uji.
Buka port panggilan. Untuk perusahaan, atur jenis komunitas baru menjadi Tempat kerja, sehingga panggilan aktif di kanal.
Tentukan siapa yang boleh mendaftar, dan aktifkan MFA.
Tinjau koneksi keluar di Keamanan.
Atur cadangan harian. Sebelum menambahkan koneksi model AI, atur kunci enkripsi AI.

Mendapat bantuan

Ajukan pertanyaan di diskusi komunitas, dan laporkan bug di repositori komunitas. Laporkan masalah keamanan secara pribadi, seperti dijelaskan dalam kebijakan keamanan.