AntimatterVận hành máy chủ
Hướng dẫn này dành cho quản trị viên hệ thống cài đặt và vận hành máy chủ Antimatter. Giả định rằng bạn đã quen thuộc với Linux, Docker và reverse proxy, nhưng chưa biết về Antimatter.
Các thành phần của một triển khai
Antimatter là ứng dụng trò chuyện nhóm tự lưu trữ, một nhánh (fork) của Mattermost. Một triển khai hoàn chỉnh bao gồm các phần sau. Chỉ ba phần đầu tiên là bắt buộc.
| Thành phần | Chức năng | Bắt buộc |
|---|---|---|
| Máy chủ Antimatter | Một chương trình Go (antimatter) phục vụ ứng dụng web, API và websockets trên cổng 8065, chạy các ứng dụng tích hợp sẵn (plugins) và truyền tải phương tiện cuộc gọi trên cổng 8443. Công cụ dòng lệnh amctl dùng để quản lý máy chủ. | có |
| PostgreSQL | Cơ sở dữ liệu: tin nhắn, người dùng, cộng đồng và, trong cấu hình được khuyến nghị, cấu hình của máy chủ. Phiên bản 15 hoặc mới hơn. | có |
| Lưu trữ tệp | Tệp tải lên, hình ảnh và ứng dụng đã cài đặt: dịch vụ tương thích S3 (tệp compose chạy RustFS) hoặc một thư mục cục bộ. | có |
| Reverse proxy | HTTPS phía trước máy chủ: hồ sơ Caddy trong tệp compose, hoặc nginx của riêng bạn. | cho môi trường sản xuất |
Dịch vụ GIF (gifs-server) | GIF và sticker cho trình chọn GIF, từ danh mục của riêng bạn. Nó sử dụng API của Tenor. | không |
| Push proxy | Chuyển tiếp thông báo đến ứng dụng di động thông qua Apple và Google. | cho thông báo di động |
| rtcd, máy chủ TURN | Máy chủ phương tiện riêng biệt cho nhiều cuộc gọi, và máy chủ trung gian (relay) cho những người dùng sau tường lửa nghiêm ngặt. | không |
| Điểm cuối AI | Các mô hình hỗ trợ tính năng viết lại, tóm tắt, dịch, đọc to, trợ lý AI và bản chép lời cuộc gọi, được thêm dưới dạng kết nối mô hình: nhà cung cấp đám mây hoặc máy chủ do bạn vận hành. | không |
Antimatter không có giấy phép trả phí và không có phiên bản trả phí: đăng nhập đơn nhất (SSO), LDAP, khả năng sẵn sàng cao (high availability), xuất dữ liệu tuân thủ, chính sách giữ dữ liệu và các tính năng khác mà Mattermost dành riêng cho các gói trả phí đều được bao gồm.
Yêu cầu
- Máy chủ Linux,
amd64hoặcarm64, với 2 lõi CPU và 4 GB bộ nhớ trở lên cho vài trăm người dùng, cùng không gian đĩa cho các tệp mà người dùng tải lên. - Docker Engine với plugin Compose (
docker compose), cho phương pháp cài đặt được khuyến nghị. Hoặc, cho các gói phần mềm, một máy chủ tương thích Debian, Ubuntu, Fedora hoặc RHEL có systemd. - Cho môi trường sản xuất: tên miền trỏ đến máy chủ, và cổng 80 và 443 mở cho HTTPS.
- Cho cuộc gọi: cổng 8443, UDP và TCP, phải có thể truy cập được bởi những người thực hiện cuộc gọi.
- Cho email: máy chủ SMTP mà Antimatter có thể gửi thông qua.
Bắt đầu nhanh
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 -dSau đó, mở URL của trang web và tạo tài khoản của bạn: tài khoản đầu tiên sẽ trở thành quản trị viên hệ thống. Cài đặt giải thích từng bước và các cách cài đặt khác.
Trong hướng dẫn này
- Cài đặt: Docker Compose, các image, quản trị viên đầu tiên, các gói .deb và .rpm, và tệp lưu trữ phát hành.
- Cấu hình: cài đặt trong cơ sở dữ liệu hoặc tệp, các biến môi trường
AM_, Bảng điều khiển Hệ thống,amctl, nhật ký. - Domain và HTTPS: URL của trang web, Caddy, nginx, địa chỉ máy khách.
- Cuộc gọi và giọng nói: cổng, NAT, TURN, rtcd, bản chép lời và phụ đề.
- Email và thông báo đẩy: SMTP, proxy thông báo đẩy và ứng dụng di động.
- Ứng dụng tích hợp sẵn: ứng dụng nào đang bật, cài đặt của chúng, cài đặt các ứng dụng khác.
- AI: kết nối mô hình, các tính năng AI tích hợp sẵn, trợ lý, giọng nói và dịch, khóa mã hóa, và dữ liệu được gửi đến đâu.
- Đăng nhập và tài khoản: đăng ký, mật khẩu, xác thực đa yếu tố (MFA), đăng nhập đơn điểm (SSO), LDAP, khách, phiên làm việc.
- Sao lưu và nâng cấp: sao lưu, khôi phục, nâng cấp, chuyển từ Mattermost.
- Vận hành: giám sát, mở rộng quy mô, chính sách lưu trữ dữ liệu, tuân thủ quy định, khắc phục sự cố.
- Bảo mật: danh sách kiểm tra tăng cường bảo mật và các kết nối bên ngoài.
- Triển khai ứng dụng desktop: tệp MSI, Group Policy và Intune, hồ sơ macOS và tệp chính sách Linux.
Bạn đang vận hành một cộng đồng thay vì một máy chủ (kênh, vai trò, điều hành)? Xem Vận hành một cộng đồng. Bạn đang xây dựng tích hợp? Xem Xây dựng trên Antimatter.
Giờ đầu tiên của bạn
- Cài đặt và tạo tài khoản quản trị viên ngay lập tức.
- Đặt máy chủ sau HTTPS trên domain riêng.
- Cấu hình SMTP và gửi một email thử nghiệm.
- Mở cổng cho cuộc gọi. Đối với doanh nghiệp, đặt loại cộng đồng mới thành Nơi làm việc, để cuộc gọi được bật trong các kênh.
- Quyết định ai có thể đăng ký và bật xác thực đa yếu tố (MFA).
- Xem xét các kết nối bên ngoài trong Bảo mật.
- Thiết lập sao lưu hàng ngày. Trước khi thêm kết nối mô hình AI, hãy đặt khóa mã hóa AI.
Nhận hỗ trợ
Đặt câu hỏi trong thảo luận cộng đồng và báo cáo lỗi trong kho mã nguồn cộng đồng. Báo cáo các vấn đề bảo mật một cách riêng tư, như được mô tả trong chính sách bảo mật.