Работа със сървър

Това ръководство е за системни администратори, които инсталират и експлоатират сървър на Antimatter. Предполага се, че познавате Linux, Docker и обратните прокси, но не и Antimatter.

От какво се състои разполагането

Antimatter е самохостинг екипна чат апликация, форк на Mattermost. Пълно разполагане има следните части. Само първите три са задължителни.

Часть	Какво прави	Задължително
Сървърът на Antimatter	Една Go програма (`antimatter`), която обслужва уеб приложението, API-то и уебsocket-ите на порт 8065, изпълнява вградените приложения (плъгини) и понася медиите за обажданията на порт 8443. Командният инструмент `amctl` го управлява.	да
PostgreSQL	Базата данни: съобщения, потребители, общности и, в препоръчителната конфигурация, настройките на сървъра. Версия 15 или по-нова.	да
Файлово хранилище	Качени файлове, изображения и инсталирани приложения: S3-съвместима услуга (compose файлът стартира RustFS) или локален директорий.	да
Обратен прокси	HTTPS пред сървъра: Caddy профила на compose файла или вашия собствен nginx.	за продуктивна среда
Услуга за GIF (`gifs-server`)	GIF-ове и стикери за GIF изборника, от вашата собствена колекция. Използва Tenor API.	не
Push прокси	Препраща известията към мобилното приложение чрез Apple и Google.	за мобилни известия
rtcd, TURN сървър	Отделен медиен сървър за много обаждания и релей за хора зад строги файрвол-и.	не
AI краища	Моделите, които осигуряват преразписване, обобщения, превод, четене на глас, AI агенти и транскрипция на обажданията, добавени като връзки към модели: облаков доставчик или сървъри, които управлявате.	не

Antimatter няма лиценз и няма платена версия: единно вход, LDAP, висока наличност, експорти за съответствие, задържане на данни и другите функции, които Mattermost запазва за платените си планове, са всички включени.

Изисквания

Linux сървър, amd64 или arm64, с 2 CPU ядра и 4 GB памет или повече за няколко стотини души, и дисково пространство за файловете, които хората качват.
Docker Engine с плъгин Compose (docker compose) за препоръчителната инсталация. Или, за пакетите, сървър, съвместим с Debian, Ubuntu, Fedora или RHEL, с systemd.
За продуктивна среда: домейн, който сочи към сървъра, и отворени портове 80 и 443 за HTTPS.
За обаждания: порт 8443, UDP и TCP, достъпен за хората, които се обаждат.
За имейл: 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, транскрипция и субтитри.
Имейл и пуш: SMTP, пуш прокси и мобилното приложение.
Вградени приложения: кои приложения са активни, техните настройки, инсталиране на други.
AI: връзки към модели, вградените AI функции, агенти, реч и превод, ключът за шифроване и къде отиват данните.
Вход и акаунти: регистрация, пароли, MFA, единен вход, LDAP, гости, сесии.
Резервни копия и ъпгрейди: резервно копие, възстановяване, ъпгрейд, преход от Mattermost.
Операции: мониторинг, мащабиране, задържане на данни, съответствие, отстраняване на проблеми.
Сигурност: чеклист за засилване и външни връзки.
Разпространение на десктоп приложението: MSI, Group Policy и Intune, профили за macOS и файл за политика за Linux.

Управлявате общност, а не сървър (канали, роли, модерация)? Вижте Управление на общност. Създавате интеграции? Вижте Създаване на Antimatter.

Първият ви час

Инсталирайте и веднага създайте акаунта на администратора.
Поставете сървъра зад HTTPS на собствен домейн.
Конфигурирайте SMTP и изпратете тестов имейл.
Отворете порта за обаждания. За компания задайте вида на новите общности на Работно пространство, за да са активни обажданията в каналите.
Решете кой може да се регистрира и включете MFA.
Прегледайте външните връзки в Сигурност.
Настройте ежедневни резервни копия. Преди да добавите връзки към AI модели, задайте ключа за шифроване на AI.

Получаване на помощ

Поставяйте въпроси в общностните обсъждания и докладвайте за грешки в репозиторията на общността. Докладвайте за проблеми с сигурността поверително, както е обяснено в политиката за сигурност.