Cum se configurează moderarea camerei Matrix cu botul Mjolnir

Mjolnir este un bot de moderare Matrix care poate aplica politici de interdicție partajate, poate redacta mesaje, poate monitoriza camere protejate și poate ajuta moderatorii să acționeze fără a utiliza conturi personale. O configurare sigură depinde de trei decizii: unde rulează botul, cine îi poate emite comenzi și ce permisiuni primește în fiecare cameră protejată. Păstrați camera de control privată, protejați doar camerele pe care le intenționați și verificați permisiunile înainte de a vă baza pe bot în timpul unui incident.

Acest ghid respectă documentația de configurare și moderare a Mjolnir din amonte și îndrumările de moderare a comunității Matrix verificate pe 6 octombrie 2026. Pagina de lansare a proiectului listează v1.12.1 ca fiind cea mai recentă versiune la momentul revizuirii. Verificați din nou pagina de lansare și exemplul de configurare la instalare, deoarece etichetele containerului și opțiunile acceptate se pot modifica.

Este Mjolnir potrivit pentru comunitatea ta Matrix?

Folosește Mjolnir atunci când moderatorii trebuie să partajeze reguli de moderare în mai multe camere, să se aboneze la liste de politici comune sau să aplice acțiuni repetate în mod constant. Permisiunile camerelor de tip matrice determină în continuare ce poate face botul; Mjolnir nu câștigă autoritate doar pentru că s-a alăturat unei camere. Pentru moderarea obișnuită a camerelor mici, instrumentele integrate în cameră pot fi suficiente. Mjolnir este cel mai util atunci când aceeași comunitate operează mai multe camere sau are nevoie de un flux de lucru controlat și partajat.

Moderarea camerelor și administrarea serverului de acasă sunt domenii de aplicare separate. Mjolnir poate gestiona interdicțiile și censurile la nivel de cameră cu permisiunile corespunzătoare. Comenzile mai disruptive la nivel de server - cum ar fi dezactivarea utilizatorilor, mutarea aliasurilor sau închiderea camerelor - necesită ca Mjolnir să fie administrator de server Synapse. Nu acordați acces de administrator serverului de acasă decât dacă moderatorii au o nevoie specifică pentru aceste operațiuni.

Ce ar trebui să pregătești înainte de a-l instala?

• Un cont de server de acasă Matrix dedicat botului, cum ar fi @mjolnir:example.org.
• O cameră privată de administrare unde moderatorii autorizați pot emite comenzi și pot primi mesaje de stare.
• Un director sau volum persistent pentru configurația și starea lui Mjolnir.
• Un plan pentru camere criptate. Configurația actuală a Mjolnir acceptă criptarea nativă; configurația documentează și Pantalaimon ca o opțiune separată, depreciată. Nu activați ambele căi simultan.
• O cameră de testare unde poți confirma invitațiile, permisiunile și comportamentul listelor înainte de a proteja sălile de producție aglomerate.

Cum instalezi Mjolnir?

Proiectul din amonte documentează instalarea Docker și a celor construite în sistem self-build. Pentru majoritatea administratorilor care rulează deja containere, Docker Compose este convenabil deoarece poate reporni botul și afișa jurnalele fără a menține un terminal interactiv deschis. Urmați instrucțiunile de configurare Docker ale proiectului și fixați o versiune revizuită în producție, în loc să vă bazați pe termen nelimitat pe o latestetichetă flotantă. Imaginea oficială este matrixdotorg/mjolnir.

Pregătiți configurația înainte de a porni containerul. Ghidul Docker din amonte se așteaptă ca configurația să fie plasată într-un director de date persistent la config/production.yaml. Păstrați directorul respectiv lizibil doar de către administratorii și serviciul care au nevoie de el. Fișierul poate conține un token de acces sau alte acreditări de conectare; nu îl trimiteți într-un depozit public, nu îl lipiți într-o cameră de asistență și nu îl includeți în jurnale.

Folosește configurația implicită curentă a proiectului, cu comentarii ca sursă de adevăr pentru numele opțiunilor. Cel puțin, setează adresa URL a serverului principal și camera de administrare, apoi configurează autentificarea și criptarea pentru implementarea aleasă. Dacă folosești o configurație bazată pe token-uri, tratează token-ul ca o parolă. Ghidul de configurare din amonte descrie obținerea acestuia prin conectarea ca bot dintr-un profil de browser separat în Element și deschiderea Setări, Ajutor și Despre și secțiunea Token de acces. Te avertizează să nu te deconectezi ulterior, deoarece acest lucru poate invalida token-ul; închide în schimb profilul de browser respectiv. Pentru o cameră de administrare criptată, activează și testează suportul pentru criptare al Mjolnir înainte de a te baza pe comenzile de acolo.

# Illustrative values only; use the exact keys and authentication method
# from the current upstream configuration sample. Never share real secrets.
homeserverUrl: https://matrix.example.org
managementRoom: '!privateRoomId:example.org'
accessToken: '[STORE A SECRET HERE, NOT IN PUBLIC]'

Acest mic fragment nu reprezintă o configurație completă. În special, setările de criptare și conectare depind de utilizarea criptării native sau a căii opționale Pantalaimon. Consultați exemplul curent în loc să copiați un blog vechi sau un fișier de compunere. Ghidul de configurare Mjolnir recomandă, de asemenea, păstrarea botului aproape de serverul de acasă din punct de vedere al rețelei pentru a reduce latența răspunsului.

Cum ar trebui să securizați camera de management?

Creați o cameră pentru moderatorii de încredere, invitați contul botului și faceți camera privată pentru echipa de moderare. ID-ul sau aliasul camerei este introdus în [numele managementRoomutilizatorului/platformei/etc.]. Configurația actuală descrie această cameră drept sursa comenzilor și avertizează că oricine poate trimite comenzi acolo poate controla Mjolnir; nu oferă un nivel de control al accesului per comandă mai granular. Acest lucru face ca verificarea calității de membru să fie esențială. Îndepărtați prompt foștii moderatori și nu folosiți camera de control a botului ca pe un chat comunitar general.

Criptarea este recomandată pentru camera de administrare. Dacă o criptați, verificați dacă Mjolnir poate citi și răspunde la mesaje cu metoda sa de criptare configurată. Un bot care s-a alăturat unei camere criptate, dar nu își poate decripta evenimentele, poate apărea online în timp ce ignoră comenzile. Folosiți configurația și jurnalele de criptare din amonte pentru a diagnostica acest lucru, în loc să dezactivați criptarea camerei ca prim pas.

Ce permisiuni ar trebui să primească Mjolnir?

Invită botul în fiecare cameră pe care ar trebui să o protejeze și oferă-i suficientă putere pentru a efectua acțiunile de moderare așteptate. Matrix folosește nivelurile de putere ale camerei pentru operațiuni precum interzicerea, eliminarea, redactarea evenimentelor altor utilizatori și schimbarea stării camerei. Valoarea necesară este definită de evenimentul de nivel de putere al camerei; Valorile implicite Matrix pentru interzicere, eliminare și redactare sunt de obicei 50 atunci când nu sunt specificate, dar camerele individuale le pot modifica.

Îndrumările comunității Matrix descriu nivelul de putere 100 ca o configurație comună pentru Mjolnir, astfel încât să poată impune decizii de moderare. Cu toate acestea, acest nivel este substanțial: oricine poate controla efectiv contul Mjolnir are acea autoritate în camerele protejate, iar botul poate deveni proprietar de facto al acestora. Revizuiți nivelurile de putere ale fiecărei camere și alegeți un nivel care permite acțiunile necesare ale botului, limitând în același timp autoritatea inutilă. Nu îi acordați statutul de administrator de server principal pentru moderarea obișnuită a camerelor.

În Element, poți invita botul din panoul membrilor camerei sau poți introduce o comandă de invitație, cum ar fi /invite @mjolnir:example.org. După ce se alătură, ajustează-i rolul în lista de membri a camerei. Repetă pentru fiecare cameră de protejat. Mjolnir nu poate păzi camerele la care nu s-a alăturat, ceea ce rezultă din modelul de permisiuni descentralizat, cameră cu cameră, al Matrix.

Cum creezi o listă de interdicții și adaugi camere protejate?

După ce botul a pornit și și-a postat starea în camera de administrare, creați acolo o listă de politici. Ghidul de pornire rapidă Mjolnir folosește acest exemplu:

!mjolnir list create COC code-of-conduct-ban-list
!mjolnir default COC
!mjolnir rooms add #community:example.org
!mjolnir verify
!mjolnir status

Prima comandă creează o cameră cu listă de interdicții cu shortcode-ul COC; persoana care o creează este invitată pentru a-i putea gestiona vizibilitatea. A doua selectează acea listă ca implicită pentru comenzile de moderare ulterioare. A treia adaugă o cameră la setul de camere protejate al lui Mjolnir. Comanda de verificare verifică dacă botul are permisiunile necesare în camerele protejate, în timp ce status ajută la confirmarea faptului că rulează conform așteptărilor. Folosește comanda !mjolnir helppentru a vedea sintaxa comenzii disponibilă în versiunea instalată.

Păstrați o listă de politici privată dacă conține note interne sau este destinată exclusiv echipei dvs. Faceți-o publică doar atunci când doriți ca alte comunități să descopere și să se aboneze la reguli. Regulile Mjolnir sunt aditive între liste, așa că verificați listele urmărite înainte de a vă baza pe ele; o listă poate continua să corespundă unui utilizator sau server chiar dacă eliminați o regulă duplicată dintr-o altă listă.

Ce ar trebui să testezi înainte de a-l utiliza într-un incident real?

• Confirmați că botul postează mesaje de pornire și de stare în camera de administrare configurată.
• Aleargă !mjolnir verifydupă ce îl inviți în camera de testare și îi acordi rolul ales.
• Execută !mjolnir roomsși confirmă că apare camera dorită, fără a include nicio cameră fără legătură.
• Verificați !mjolnir protectionsși activați doar protecțiile pe care le înțelegeți; protecțiile automate pot afecta utilizatorii legitimi.
• Folosește un cont de testare și o cameră de unică folosință pentru a valida procedurile de interdicție, anulare a interdicției și redactare a echipei înainte de a le aplica membrilor reali.
• Verificați jurnalele containerului și mesajele din sala de administrare a lui Mjolnir dacă botul ratează comenzi sau raportează permisiuni lipsă.

Nu testați interzicând accesul unui membru real al comunității sau utilizând un wildcard pe un server live. Interdicțiile cu wildcard pot afecta mulți utilizatori; configurația implicită actuală necesită un flag de confirmare suplimentar pentru interdicțiile cu wildcard. Citiți ghidul moderatorului înainte de a activa protecțiile automate și documentați cine poate aproba o acțiune cu impact mare.

Care sunt greșelile frecvente de configurare?

• Acordarea de drepturi de administrator serverului botului pentru comoditate: moderarea la nivel de cameră necesită de obicei putere în cameră, nu drepturi de administrator Synapse.
• Lăsând camera de administrare accesibilă pe scară largă: fiecărui membru care poate emite comenzi i se încredințează controalele de moderare ale botului.
• Uitarea permisiunilor pentru camerele protejate: un bot poate fi online și totuși să nu reușească să interzică sau să elimine accesul dacă nivelul său de putere este prea scăzut.
• Utilizarea camerelor criptate fără configurarea criptării: apartenența în sine nu permite botului să citească comenzile criptate.
• Copierea unei vechi rețete de configurare: configurația și suportul pentru criptare pentru Mjolnir evoluează; utilizați exemplul implicit curent și documentația de configurare.
• Presupunând că o eliminare de pe o listă anulează fiecare interdicție: o altă listă urmărită ar putea aplica în continuare aceeași regulă.

Unde puteți verifica detaliile actuale?

Începeți cu ghidul de configurare Mjolnir din amonte , ghidul moderatorului și istoricul lansărilor . Pentru permisiunile camerei, consultați ghidul de moderare a comunității Matrix și specificația Matrix pentru nivelurile de putere ale camerei . Comenzile exacte de instalare și setările de criptare depind de serverul dvs. de acasă, de configurarea containerului și de versiunea Mjolnir; aceste referințe din amonte ar trebui să aibă prioritate dacă instrucțiunile lor se modifică.