Rulează Mjölnir ca un bot de moderare a camerei Matrix cu Docker

Dacă moderarea Matrix este dispersată pe conturi și camere personale, rulați Mjölnir ca bot dedicat și oferiți moderatorilor o cameră privată de administrare pentru comenzi. Cea mai simplă configurare auto-găzduită folosește Docker Compose, un cont Matrix separat și o cameră de administrare criptată; apoi adăugați camerele comunitare pe care Mjölnir ar trebui să le protejeze și să își verifice permisiunile.

Ce face Mjölnir - și de ce are nevoie

Mjölnir este un bot de moderare Matrix care aplică liste de politici și acțiuni de moderare ca propriul cont. Un server de acasă este serverul Matrix care găzduiește conturi de utilizator și camere. O cameră de administrare este camera privată în care moderatorii autorizați emit comenzi de bot. O cameră protejată este o cameră pe care Mjölnir o monitorizează și o poate modera.

Pentru acest ghid, aveți nevoie de acces la un cont Matrix pe serverul de acasă, permisiunea de a crea un cont de bot și camere și o gazdă cu Docker Engine și pluginul Docker Compose. Nu este nevoie să-l setați pe Mjölnir ca administrator de server de acasă pentru moderarea obișnuită a camerelor. Unele acțiuni la nivel de server - cum ar fi dezactivarea utilizatorilor sau închiderea camerelor - necesită un server de acasă Synapse și privilegii de administrator de server; omiteți aceste privilegii, cu excepția cazului în care cazul dvs. de utilizare le necesită. Consultați depozitul oficial Mjölnir al proiectului .

1. Creați un cont de bot și o cameră de control privată

Înregistrează un cont dedicat, cum ar fi @mjolnir:example.orgpe serverul tău de acasă. Nu folosește contul personal al unui moderator: acreditările separate facilitează rotirea accesului și păstrează acțiunile botului distincte. Creează o cameră privată pentru moderatori, activează criptarea end-to-end și invită atât moderatorii umani, cât și botul. Păstrează calitatea de membru limitată la persoanele în care ai încredere. Oricine din camera de administrare configurată poate emite comenzi, iar Mjölnir nu oferă permisiuni de comandă mai detaliate în interiorul acelei camere.

Conectați-vă ca bot într-un profil de browser separat sau într-o fereastră privată pentru a obține token-ul de acces Matrix prin setările Ajutor și Despre ale Element . Copiați token-ul în configurație în siguranță. Închideți fereastra browserului fără a vă deconecta; deconectarea invalidează token-ul. Documentația oficială de configurare recomandă criptarea pentru camera de administrare și spune să activați criptarea în configurația lui Mjölnir, astfel încât bot-ul să poată comunica acolo.

Formular de configurare a contului Matrix pentru un bot Mjölnir dedicat, cu token-ul său de acces mascat.
Prima sarcină de configurare este o identitate separată a botului; nu expuneți niciodată token-ul său de acces într-o captură de ecran sau într-un jurnal public.

2. Configurați Mjölnir pentru serverul dvs. de acasă

Pe gazda Docker, creați un director de date persistent și copiați configurația exemplu a proiectului în ./mjolnir/config/production.yaml. Fișierul exemplu documentează opțiuni suplimentare; setați doar valorile necesare pentru implementare. Cel puțin, utilizați adresa URL API client a serverului de acasă, token-ul botului, criptarea nativă și ID-ul sau aliasul camerei Matrix al camerei de administrare:

homeserverUrl: "https://matrix.example.org"
accessToken: "YOUR_BOT_ACCESS_TOKEN"
encryption:
  use: true
managementRoom: "!roomid:example.org"

Înlocuiți fiecare valoare exemplu. Un ID de cameră începe cu !; un alias începe cu #. Nu lipiți un matrix.tolink în managementRoom. Tratați fișierul de configurare și token-ul ca secrete: restricționați accesul la fișiere, păstrați fișierul în afara controlului sursei și nu îl publicați în solicitările de asistență. Dacă botul nu poate decripta camera de administrare, verificați din nou setarea de criptare și confirmați că botul s-a alăturat camerei.

Un exemplu de configurare YAML care prezintă adresa URL a serverului de domiciliu, tokenul de acces mascat, criptarea activată și un ID al camerei de administrare.
Exemplul ilustrează câmpurile de configurare necesare; înlocuiți serverul, tokenul și ID-ul camerei din exemplu cu propriile valori.

3. Porniți serviciul Docker Compose

Instrucțiunile oficiale Docker folosesc imaginea matrixdotorg/mjolnirși montează un director gazdă la /data. Creați docker-compose.ymllângă mjolnirdirector:

services:
  mjolnir:
    image: matrixdotorg/mjolnir:latest
    restart: unless-stopped
    volumes:
      - ./mjolnir:/data

Din acel director, porniți Mjölnir cu docker compose up -d. Directorul montat păstrează datele de configurare și cele ale botului atunci când containerul este recreat. Ghidul oficial folosește latesteticheta ca exemplu; pentru un server de producție, alegeți o etichetă de lansare pe care ați testat-o ​​și înregistrați-o astfel încât actualizările să fie deliberate. Urmați pornirea cu docker compose logs -f --tail 100 mjolnir. Așteptați mesajele de pornire ale lui Mjölnir în camera de administrare înainte de a continua.

Un terminal afișează serviciul Mjölnir Docker Compose pornind cu un volum de date persistent.
Porniți serviciul din directorul care conține fișierul Compose, apoi verificați jurnalele sale pentru erori de pornire.

4. Creați o listă de politici și protejați camerele

În camera de administrare, întreabă botul !mjolnir helpdacă nu răspunde. Creează o listă de interdicții cu un cod scurt și un nume alias pentru cameră, apoi setează-o ca listă implicită:

!mjolnir list create COC code-of-conduct-ban-list
!mjolnir default COC

Mjölnir creează camera cu listă și te invită să intri în ea. O listă cu politici este o cameră Matrix care conține reguli de moderare, așa că verifică-i vizibilitatea și calitatea de membru înainte de a o partaja. Adaugă fiecare cameră comunitară pe care dorești ca Mjölnir să o monitorizeze:

!mjolnir rooms add #community:example.org
!mjolnir verify

Botul are nevoie de suficientă putere în fiecare cameră protejată pentru a efectua acțiuni de moderare, de obicei capacitatea de a interzice utilizatori și de a redacta evenimente. Folosește setările nivelului de putere ale camerei pentru a acorda doar permisiunile necesare. Comanda verifyverifică dacă Mjölnir are permisiunile necesare în camerele protejate. Adaugă botul într-o cameră înainte de a o proteja. Nu seta protectAllJoinedRoomsîntâmplător: extinde protecția la camerele la care se alătură botul și face selecția cameră cu cameră mai puțin utilă.

O cameră de moderator Matrix criptată îl arată pe Mjölnir online și o comandă care creează o listă de politici COC.
După ce botul răspunde în camera privată de administrare, creați o listă și testați comenzile acolo.

Verificați configurarea și evitați greșelile comune

  • Botul este online: docker compose ps arată că serviciul rulează, jurnalele nu arată erori repetate de autentificare sau criptare, iar botul își postează starea de pornire în camera de administrare.
  • Comenzile sunt restricționate: moderatorii pot folosi !mjolnir statusși !mjolnir rulesîn camera configurată. Nu testați comenzile într-o cameră publică.
  • Camerele sunt protejate: !mjolnir rooms listează camerele vizate și !mjolnir verifyraportează nivelurile de putere adecvate.
  • Secretele rămân private: tokenul nu se află într-un depozit public, istoricul shell-ului sau jurnalele postate. Dacă este expus, revocați-l sau rotiți-l deconectând sesiunea botului și actualizați configurația înainte de a reporni.

Dacă botul rămâne silențios, confirmați mai întâi că ID-ul sau aliasul camerei de administrare este exact și că botul este un membru alăturat. Pentru camerele criptate, verificați dacă criptarea este activată și dacă botul poate decripta mesajele. Dacă moderarea eșuează doar într-o singură cameră, verificați dacă aceasta este protejată și dacă nivelurile sale de putere permit acțiunea solicitată. Pentru sintaxa comenzii și opțiunile de configurare, consultați ghidul actual al moderatorului Mjölnir , ghidul de configurare Docker și configurația exemplu .

Lasă un comentariu

Restaurarea sinapselor matriceale în siguranță cu un dump PostgreSQL

Faceți o copie de rezervă a Synapse cu pg_dump, protejați cheia de semnare și mediul de stocare și restaurați-le într-o bază de date PostgreSQL curată, fără a reutiliza chei de unică folosință învechite.

Rulează Mjölnir ca un bot de moderare a camerei Matrix cu Docker

Rulează Mjölnir ca un bot de moderare a camerei Matrix cu Docker

Configurați Mjölnir cu un cont Matrix dedicat, o cameră de administrare criptată, Docker Compose, o listă de politici și verificări de permisiuni.

Activați sincronizarea glisantă nativă a matricei pentru o încărcare mobilă mai rapidă

Activați sincronizarea glisantă nativă a matricei pentru o încărcare mobilă mai rapidă

Sari peste proxy-ul retras și configurează funcția Sliding Sync încorporată în Synapse. Verifică descoperirea clienților, apoi măsoară comportamentul de încărcare și reconectare a listei de camere pe un telefon compatibil.

Găzduiți Element Web pe Nginx cu un server de acasă personalizat

Implementează Element Web ca site static, direcționează-l către serverul tău principal Matrix, adaugă HTTPS și configurează Nginx pentru a servi actualizări fără fișiere învechite.

Rulați un server de acasă cu matrice ușoară pe Raspberry Pi 4

Configurați Conduit pe un Raspberry Pi 4 pe 64 de biți cu date persistente, federație HTTPS, înregistrare protejată și verificări pentru un server de acasă funcțional.

Configurați un alias personalizat pentru camera matricei pe propriul domeniu

Oferă unei camere Matrix o adresă ușor de partajat pe domeniul tău folosind Element sau API-ul Matrix, cu verificări pentru permisiuni, denumire Synapse și federație.

Configurați Coturn pentru apeluri vocale și video Matrix fiabile

Configurați coturn și Synapse cu acreditări TURN corespunzătoare, deschideți porturile de retransmisie necesare și verificați dacă clienții Matrix pot obține candidați de retransmisie.

Implementați Matrix Synapse cu Docker Compose și PostgreSQL

Implementați Matrix Synapse cu Docker Compose și PostgreSQL

Configurați un server de acasă Synapse persistent cu Docker Compose, PostgreSQL, o configurație privată și verificări înainte de expunerea acestuia prin HTTPS.

Personalizați tema și brandingul Element Web

Setați un nume de marcă, culori personalizate și resurse de conectare pentru implementarea Element Web, înțelegând în același timp care părți rămân cu marca Element.

Creșteți limita de fișiere Systemd a Synapse fără a face presupuneri

Creșteți limita de fișiere Systemd a Synapse fără a face presupuneri

Diagnosticați dacă Synapse a atins limita de fișiere deschise per proces, setați un drop-in systemd pentru serviciul sau worker-ul corect și verificați limita de funcționare.