Antimatter

הפעלת שרת

מדריך זה מיועד למנהלי מערכת שמקימים ומפעילים שרת Antimatter. הוא מניח שאתם מכירים את Linux, Docker ופרוקסיות הפוך, אך לא את Antimatter.

מה מרכיב פריסה

Antimatter הוא צ'אט צוותים עצמאית, ענף של Mattermost. פריסה מלאה מורכבת מהחלקים הבאים. רק שלושת הראשונים הם חובה.

חלקמה היא עושהחובה
שרת Antimatterתוכנית Go אחת (antimatter) שמספקת את אפליקציית ה-Web, את ה-API ואת ה-websockets על פורט 8065, מפעילה את האפליקציות המובנות (תוספים) ומעבירה מדיה של שיחות על פורט 8443. כלי שורת הפקודה amctl מנהל אותה.כן
PostgreSQLמסד הנתונים: הודעות, משתמשים, קהילות ו, בהגדרה המומלצת, הגדרות השרת. גרסה 15 או חדשה יותר.כן
אחסון קבציםקבצים שהועלו, תמונות ואפליקציות שהותקנו: שירות תואם S3 (קובץ ה-compose מפעיל RustFS), או תיקייה מקומית.כן
פרוקסי הפוךHTTPS מול השרת: פרופיל Caddy של קובץ ה-compose, או nginx שלכם.לשימוש בייצור
שירות GIF (gifs-server)GIFs ומדבקות לבחירת GIF, מהקטלוג שלכם. הוא משתמש ב-Tenor API.לא
פרוקסי התראות דחיפהמעביר התראות לאפליקציה המובייל דרך Apple ו-Google.להתראות במובייל
rtcd, שרת TURNשרת מדיה נפרד לרבות שיחות, ו-relay לאנשים שמאחורי חומות אש קפדניות.לא
נקודות קצה AIהמודלים העומדים מאחורי כתיבה מחדש, סיכומים, תרגום, קריאה בקול, סוכני AI ותמלול שיחות, שנוספו כחיבורי מודלים: ספק ענן או שרתים שאתם מפעילים.לא

ל-Antimatter אין רישיון ואין גרסה בתשלום: התחברות מאוחדת, LDAP, זמינות גבוהה, ייצואי עמידה, שמירת נתונים והתכונות האחרות שמattermost שומרת לתוכניות בתשלום – כולן כלולות.

דרישות

  • שרת Linux, amd64 או arm64, עם 2 ליבות CPU ו-4 GB זיכרון לפחות למספר מאות אנשים, ונפח דיסק לקבצים שהמשתמשים מעלים.
  • Docker Engine עם תוסף Compose (docker compose), להתקנה המומלצת. או, עבור החבילות, שרת תואם Debian, Ubuntu, Fedora או RHEL עם systemd.
  • לשימוש בייצור: שם דומיין שמכוון לשרת, ופורטים 80 ו-443 פתוחים ל-HSTS.
  • לשיחות: פורט 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

לאחר מכן, פתחו את כתובת האתר וצרו את החשבון שלכם: החשבון הראשון הופך למנהל המערכת. התקנה מסבירה כל שלב ואת הדרכים האחרות להתקנה.

במדריך זה

  • התקנה: Docker Compose, התמונות, המנהל הראשון, חבילות ה-.deb וה-.rpm, וארכיון הגרסה.
  • הגדרות: הגדרות במסד הנתונים או בקובץ, משתני סביבה AM_, קונסולת מערכת, amctl, יומנים.
  • דומיין ו-HTTPS: כתובת האתר, Caddy, nginx, כתובות הלקוחות.
  • שיחות וקול: פורטים, NAT, TURN, rtcd, תמלול וכתוביות.
  • אימייל והתראות דחיפה: SMTP, פרוקסי ההתראות והאפליקציה המוביילית.
  • אפליקציות מובנות: אילו אפליקציות פעילות, ההגדרות שלהן, התקנת אפליקציות נוספות.
  • AI: חיבורי מודלים, תכונות AI מובנות, סוכנים, דיבור ותרגום, מפתח ההצפנה, ואיזה נתונים נשלחים לאן.
  • התחברות וחשבונות: הרשמה, סיסמאות, אימות דו-שלבי, התחברות מאוחדת, LDAP, אורחים, סשנים.
  • גיבויים ושדרוגים: גיבוי, שחזור, שדרוג, מעבר מ-Mattermost.
  • תפעול: ניטור, הרחבה, שמירת נתונים, עמידה בתקנים, פתרון תקלות.
  • אבטחה: רשימת בדיקות לחיזוק האבטחה וחיבורים חיצוניים.
  • הפצת אפליקציית שולחן העבודה: MSI, Group Policy ו-Intune, פרופילים ל-macOS וקובע מדיניות ל-Linux.

מנהלים קהילה ולא שרת (ערוצים, תפקידים, ניטור)? ראו ניהול קהילה. בונים אינטגרציות? ראו בנייה על Antimatter.

שעתכם הראשונה

  1. התקינו וצרו מידע את חשבון המנהל.
  2. הציבו את השרת מאחורי HTTPS על דומיין ייעודי.
  3. הגדירו SMTP ושלחו אימייל בדיקה.
  4. פתחו את פורט השיחות. עבור חברה, הגדירו את סוג הקהילות החדשות למקום עבודה, כך ששיחות יהיו פעילות בערוצים.
  5. החליטו谁能 להירשם והפעילו אימות דו-שלבי.
  6. בדקו את החיבורים החיצוניים באבטחה.
  7. הגדירו גיבויים יומיים. לפני הוספת חיבורי מודלי AI, הגדירו את מפתח ההצפנה של AI.

קבלת עזרה

שאלו שאלות בהדיונים הקהילתיים, ודווחו על תקלות במאגר הקהילה. דווחו על בעיות אבטחה בפרטיות, כפי שמסביר מדיניות האבטחה.