Sunucu Çalıştırma

Bu rehber, Antimatter sunucusu kuran ve işleten sistem yöneticileri içindir. Linux, Docker ve ters vekilleri (reverse proxy) bildiğiniz, ancak Antimatter'ı bilmediğiniz varsayılır.

Bir dağıtımın bileşenleri

Antimatter, kendi kendine barındırılan (self-hosted) bir takım sohbet uygulamasıdır ve Mattermost'un bir çatallamasıdır (fork). Tam bir dağıtım şu bileşenlerden oluşur. Sadece ilk üçü zorunludur.

Bileşen	Ne işe yarar	Zorunlu mu?
Antimatter sunucusu	Web uygulamasını, API'yi ve 8065 portundaki websockets'i sunan, paketlenmiş uygulamaları (eklentileri) çalıştıran ve 8443 portunda arama medyasını taşıyan tek bir Go programı (`antimatter`). Komut satırı aracı `amctl` ile yönetilir.	evet
PostgreSQL	Veritabanı: iletiler, kullanıcılar, topluluklar ve önerilen yapılandırmada sunucunun yapılandırması. Sürüm 15 veya üzeri.	evet
Dosya depolama alanı	Yüklenen dosyalar, görseller ve kurulan uygulamalar: S3 uyumlu bir hizmet (compose dosyası RustFS çalıştırır) veya yerel bir dizin.	evet
Ters vekil (Reverse proxy)	Sunucunun önünde HTTPS: compose dosyasının Caddy profili veya kendi nginx'iniz.	üretim için
GIF hizmeti (`gifs-server`)	GIF seçicisi için GIF'ler ve çıkartmalar, kendi kataloğunuzdan. Tenor API'si ile konuşur.	hayır
İtme vekili (Push proxy)	Bildirimleri Apple ve Google üzerinden mobil uygulamaya iletir.	mobil bildirimler için
rtcd, bir TURN sunucusu	Çoklu aramalar için ayrı bir medya sunucusu ve katı güvenlik duvarlarının arkasındaki kişiler için bir röle.	hayır
Yapay zeka uç noktaları	Yazıcının yeniden yazma, özetleme, çeviri, sesli okuma, yapay zeka ajanları ve arama transkripsiyonu işlevlerinin arkasındaki modeller, model bağlantıları olarak eklendi: bir bulut sağlayıcısı veya sizin çalıştırdığınız sunucular.	hayır

Antimatter'ın lisansı veya ücretli sürümü yoktur: tek oturum açma (single sign-on), LDAP, yüksek kullanılabilirlik, uyumluluk dışa aktarımları, veri saklama süresi ve Mattermost'un ücretli planlarına ayırdığı diğer tüm özellikler dahildir.

Gereksinimler

Birkaç yüz kişi için 2 CPU çekirdeği ve 4 GB bellek veya daha fazlasına sahip, amd64 veya arm64 mimarili bir Linux sunucusu ve insanların yüklediği dosyalar için disk alanı.
Önerilen kurulum için Compose eklonlu Docker Engine (docker compose). Paketler için ise systemd'ye sahip Debian, Ubuntu, Fedora veya RHEL uyumlu bir sunucu.
Üretim için: sunucuya işaret eden bir alan adı ve HTTPS için açık 80 ve 443 portları.
Aramalar için: aramayı yapan kişiler tarafından erişilebilir, UDP ve TCP destekli 8443 portu.
E-posta için: Antimatter'ın üzerinden gönderebileceği bir SMTP sunucusu.

Hızlı başlangıç

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

Ardından site URL'sini açın ve hesabınızı oluşturun: ilk hesap sistem yöneticisi olur. Yükleme bölümü her adımı ve diğer yükleme yöntemlerini açıklar.

Bu kılavuzda

Kurulum: Docker Compose, görüntüler, ilk yönetici, .deb ve .rpm paketleri, sürüm arşivi.
Yapılandırma: veritabanı veya dosya içindeki ayarlar, AM_ ortam değişkenleri, Sistem Konsolu, amctl, günlükler.
Alan adı ve HTTPS: site URL'si, Caddy, nginx, istemci adresleri.
Aramalar ve ses: portlar, NAT, TURN, rtcd, transkripsiyon ve altyazılar.
E-posta ve push: SMTP, push vekili ve mobil uygulama.
Gömülü uygulamalar: hangi uygulamaların açık olduğu, ayarları ve diğerlerini yükleme.
Yapay zeka: model bağlantıları, yerleşik yapay zeka özellikleri, ajanlar, ses ve çeviri, şifreleme anahtarı ve verilerin nereye gittiği.
Giriş ve hesaplar: kayıt, şifreler, MFA, tek oturum açma, LDAP, konuklar, oturumlar.
Yedekleme ve yükseltme: yedekleme, geri yükleme, yükseltme, Mattermost'tan geçiş.
İşletme: izleme, ölçeklendirme, veri saklama, uyumluluk, sorun giderme.
Güvenlik: güçlendirme denetim listesi ve dış bağlantılar.
Masaüstü uygulaması dağıtımı: MSI, Group Policy ve Intune, macOS profilleri ve Linux politika dosyası.

Bir sunucu yerine bir topluluk işletmek (kanallar, roller, moderasyon) istiyor musunuz? Bir topluluk işletme bölümüne bakın. Entegrasyonlar mı geliştiriyorsunuz? Antimatter üzerinde geliştirme bölümüne bakın.

İlk saatiniz

Yükleme yapın ve hemen yönetici hesabını oluşturun.
Sunucuyu kendi alan adında HTTPS arkasına alın.
SMTP'yi yapılandırın ve bir test e-postası gönderin.
Arama portunu açın. Bir şirket için yeni topluluk türünü Çalışma alanı olarak ayarlayın, böylece kanallarda aramalar etkin olur.
Kimlerin kayıt olabileceğine karar verin ve MFA'yı etkinleştirin.
Güvenlik bölümündeki dış bağlantıları gözden geçirin.
Günlük yedeklemeleri yapılandırın. Yapay zeka model bağlantıları eklemeyi planlıyorsanız, yapay zeka şifreleme anahtarını ayarlayın.

Yardım alma

Sorularınızı topluluk tartışmalarında sorun, hataları ise topluluk deposunda bildirin. Güvenlik sorunlarını gizli olarak bildirin; güvenlik politikası bu konuda açıklamalar içerir.