執行伺服器
本指南適用於安裝並執行 Antimatter 伺服器的系統管理員。假設您熟悉 Linux、Docker 和反向代理,但不熟悉 Antimatter。
部署的組成
Antimatter 是一款自託管的團隊聊天工具,是 Mattermost 的分支。完整的部署包含以下部分,其中僅前三項為必要。
| 部分 | 功能說明 | 必要 |
|---|---|---|
| Antimatter 伺服器 | 一個 Go 程式(antimatter),在 8065 埠上提供網頁應用程式、API 和 WebSocket 服務,執行內建應用程式(外掛程式),並在 8443 埠上承載通話媒體。使用命令列工具 amctl 進行管理。 | 是 |
| PostgreSQL | 資料庫:儲存訊息、使用者、社群,以及在建議設定中儲存伺服器的設定。版本需為 15 或更新。 | 是 |
| 檔案儲存 | 上傳的檔案、圖片和已安裝的應用程式:使用 S3 相容服務(Compose 檔案執行 RustFS)或本地目錄。 | 是 |
| 反向代理 | 在伺服器前提供 HTTPS:使用 Compose 檔案的 Caddy 設定檔,或您自己的 nginx。 | 用於生產環境 |
GIF 服務(gifs-server) | 為 GIF 選擇器提供 GIF 和貼紙,來自您自己的目錄。它使用 Tenor API。 | 否 |
| 推送代理 | 透過 Apple 和 Google 將通知轉發至行動應用程式。 | 用於行動通知 |
| rtcd、TURN 伺服器 | 用於大量通話的獨立媒體伺服器,以及供位於嚴格防火牆後的使用者使用的中繼。 | 否 |
| AI 端點 | 驅動輸入欄重寫、摘要、翻譯、朗讀、AI 代理程式與通話文字轉錄的模型,以模型連線的方式加入:雲端供應商或您自行運行的伺服器。 | 否 |
Antimatter 沒有授權限制或付費版本:單一登入、LDAP、高可用性、合規性匯出、資料保留以及 Mattermost 保留給付費方案的其它功能,全部包含在內。
需求
- 一台 Linux 伺服器,
amd64或arm64,供數百人使用時需具備 2 個 CPU 核心和 4 GB 以上的記憶體,以及供使用者上傳檔案的磁碟空間。 - 搭配 Compose 外掛的 Docker Engine(
docker compose),用於建議的安裝方式。或者,若要使用套件,則需具備 systemd 的 Debian、Ubuntu、Fedora 或 RHEL 相容伺服器。 - 用於生產環境:指向伺服器的網域名稱,並開啟 80 和 443 埠以進行 HTTPS。
- 用於通話:8443 埠,UDP 和 TCP,需可被通話的使用者存取。
- 用於電子郵件:Antimatter 可透過其發送郵件的 SMTP 伺服器。
快速入門
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
接著開啟網站網址並建立您的帳號:第一個建立的帳號將成為系統管理員。安裝 說明每個步驟以及其他安裝方式。
本指南內容
- 安裝:Docker Compose、映像檔、首位管理員、.deb 與 .rpm 套件,以及發行版檔案。
- 設定:資料庫或檔案中的設定、
AM_環境變數、系統控制台、amctl、日誌。 - 網域與 HTTPS:網站網址、Caddy、nginx、用戶端位址。
- 通話與語音:埠號、NAT、TURN、rtcd、文字轉錄與即時字幕。
- 電子郵件與推送:SMTP、推送代理程式與行動應用程式。
- 內建應用程式:哪些應用程式已啟用、其設定、安裝其他應用程式。
- AI:模型連線、內建 AI 功能、代理程式、語音與翻譯、加密金鑰,以及資料流向。
- 登入與帳號:註冊、密碼、多因素驗證、單一登入、LDAP、訪客、工作階段。
- 備份與升級:備份、還原、升級、從 Mattermost 遷移。
- 營運:監控、擴展、資料保留、合規性、疑難排解。
- 安全性:強化檢查清單與外部連線。
- 桌面應用程式部署:MSI、群組原則與 Intune、macOS 設定檔,以及 Linux 原則檔案。
要營運社群而非伺服器(頻道、角色、內容管理)?請參閱 營運社群。要建置整合?請參閱 在 Antimatter 上建置。
您的第一個小時
- 安裝並立即建立管理員帳號。
- 將伺服器放在 HTTPS 後端,並使用專屬網域。
- 設定 SMTP 並傳送一封測試電子郵件。
- 開啟通話埠。若為公司使用,請將新社群的類型設為工作場所,以便在頻道中啟用通話。
- 決定誰可以註冊,並啟用多因素驗證。
- 檢視 安全性 中的外部連線。
- 設定每日備份。在加入 AI 模型連線之前,請先設定 AI 加密金鑰。