Jak skonfigurować moderację pokoju Matrix za pomocą bota Mjolnir

Mjolnir to bot moderacyjny Matrix, który może stosować wspólne zasady banowania, redagować wiadomości, monitorować chronione pokoje i pomagać moderatorom w działaniu bez użycia kont osobistych. Bezpieczna konfiguracja zależy od trzech decyzji: gdzie bot działa, kto może wydawać mu polecenia oraz jakie uprawnienia otrzymuje w każdym chronionym pokoju. Zachowaj prywatność pokoju kontrolnego, chroń tylko te pokoje, do których chcesz się odwołać, i zweryfikuj uprawnienia przed skorzystaniem z bota podczas incydentu.

Niniejszy przewodnik jest zgodny z dokumentacją konfiguracji i moderatora Mjolnir, stworzoną przez producenta, oraz wytycznymi dotyczącymi moderacji społeczności Matrix, sprawdzonymi 6 października 2026 r. Strona wydania projektu podaje wersję 1.12.1 jako najnowszą wersję w momencie recenzji. Sprawdź ponownie stronę wydania i przykład konfiguracji podczas instalacji, ponieważ tagi kontenerów i obsługiwane opcje mogą ulec zmianie.

Czy Mjolnir jest odpowiedni dla Twojej społeczności Matrix?

Użyj Mjolnira, gdy moderatorzy muszą współdzielić zasady moderacji w kilku pokojach, subskrybować wspólne listy zasad lub konsekwentnie stosować powtarzające się działania. Uprawnienia w pokojach w matrycy nadal określają, co bot może robić; Mjolnir nie zyskuje uprawnień tylko dlatego, że dołączył do pokoju. Do zwykłej moderacji małych pokoi, wbudowane narzędzia mogą być wystarczające. Mjolnir jest najbardziej przydatny, gdy ta sama społeczność obsługuje wiele pokoi lub potrzebuje kontrolowanego, współdzielonego przepływu pracy.

Moderacja pokoju i administracja serwerem domowym to oddzielne zakresy. Mjolnir może zarządzać banami i redagowaniem na poziomie pokoju, posiadając odpowiednie uprawnienia do pokoju. Bardziej uciążliwe polecenia na poziomie serwera – takie jak dezaktywacja użytkowników, przenoszenie aliasów czy zamykanie pokoi – wymagają od Mjolnira uprawnień administratora serwera Synapse. Nie udzielaj dostępu administratora serwera domowego, chyba że moderatorzy mają konkretną potrzebę wykonania tych operacji.

Co należy przygotować przed instalacją?

• Konto na serwerze domowym Matrix przeznaczone dla bota, np @mjolnir:example.org. .
• Prywatny pokój zarządzania, w którym autoryzowani moderatorzy mogą wydawać polecenia i otrzymywać wiadomości o stanie.
• Trwały katalog lub wolumin przechowujący konfigurację i stan Mjolnira.
• Plan szyfrowanych pokoi. Obecna konfiguracja Mjolnira obsługuje szyfrowanie natywne; konfiguracja dokumentuje również Pantalaimon jako osobną, wycofaną opcję. Nie należy włączać obu ścieżek jednocześnie.
• Pokój testowy, w którym można potwierdzić zaproszenia, uprawnienia i zachowanie listy przed zabezpieczeniem intensywnie użytkowanych pomieszczeń produkcyjnych.

Jak zainstalować Mjolnir?

Projekt źródłowy dokumentuje instalację Dockera i samodzielną kompilację. Dla większości administratorów korzystających już z kontenerów, Docker Compose jest wygodny, ponieważ umożliwia ponowne uruchomienie bota i wyświetlanie logów bez konieczności otwierania interaktywnego terminala. Postępuj zgodnie z instrukcjami konfiguracji Dockera w projekcie i przypnij zweryfikowaną wersję do środowiska produkcyjnego, zamiast polegać na zmiennym latesttagu w nieskończoność. Oficjalny obraz to matrixdotorg/mjolnir.

Przygotuj konfigurację przed uruchomieniem kontenera. Przewodnik Dockera wymaga, aby konfiguracja znajdowała się w trwałym katalogu danych pod adresem config/production.yaml. Ten katalog powinien być dostępny do odczytu tylko dla administratorów i usług, które go potrzebują. Plik może zawierać token dostępu lub inne dane logowania; nie należy go umieszczać w publicznym repozytorium, wklejać do pokoju wsparcia ani dołączać do logów.

Użyj bieżącej domyślnej konfiguracji projektu z komentarzami jako źródła wiarygodnych nazw opcji. Ustaw co najmniej adres URL serwera domowego i salę zarządzania, a następnie skonfiguruj uwierzytelnianie i szyfrowanie dla wybranego wdrożenia. Jeśli korzystasz z konfiguracji opartej na tokenie, traktuj token jak hasło. W przewodniku konfiguracji opisano, jak uzyskać token, logując się jako bot z osobnego profilu przeglądarki w Element i otwierając Ustawienia, Pomoc i Informacje oraz sekcję Token dostępu. Ostrzega on, aby nie wylogowywać się później, ponieważ może to spowodować unieważnienie tokena; zamiast tego zamknij ten profil przeglądarki. W przypadku szyfrowanej sali zarządzania, włącz i przetestuj obsługę szyfrowania Mjolnira przed wykonaniem poleceń w tej sali.

# 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]'

Ten krótki fragment nie stanowi kompletnej konfiguracji. W szczególności ustawienia szyfrowania i logowania zależą od tego, czy używasz szyfrowania natywnego, czy opcjonalnej ścieżki Pantalaimon. Zamiast kopiować stary wpis na blogu lub plik do tworzenia wiadomości, skorzystaj z bieżącego przykładu. Instrukcja konfiguracji Mjolnira zaleca również, aby bot znajdował się blisko serwera domowego, aby zmniejszyć opóźnienie odpowiedzi.

Jak zabezpieczyć pomieszczenie zarządcze?

Stwórz pokój dla zaufanych moderatorów, zaproś konto bota i ustaw pokój jako prywatny dla zespołu moderującego. Wprowadź identyfikator pokoju lub alias managementRoom. Aktualna konfiguracja opisuje ten pokój jako źródło poleceń i ostrzega, że ​​każdy, kto może je tam wysyłać, może kontrolować Mjolnir; nie zapewnia bardziej szczegółowej kontroli dostępu dla poszczególnych poleceń. Z tego powodu weryfikacja członkostwa jest niezbędna. Niezwłocznie usuwaj byłych moderatorów i nie używaj pokoju kontrolnego bota jako ogólnego czatu społecznościowego.

Zalecane jest szyfrowanie pokoju zarządzania. Jeśli go szyfrujesz, sprawdź, czy Mjolnir może odczytywać i odpowiadać na wiadomości za pomocą skonfigurowanej metody szyfrowania. Bot, który dołączył do zaszyfrowanego pokoju, ale nie może odszyfrować swoich zdarzeń, może wydawać się online, ignorując polecenia. Użyj konfiguracji szyfrowania i logów nadrzędnych, aby zdiagnozować problem, zamiast wyłączać szyfrowanie pokoju jako pierwszy krok.

Jakie uprawnienia powinien otrzymać Mjolnir?

Zaproś bota do każdego pokoju, który ma chronić, i daj mu wystarczająco dużo miejsca, aby mógł wykonywać oczekiwane przez Ciebie działania moderacyjne. Matrix używa poziomów mocy pokoju do operacji takich jak banowanie, wyrzucanie, redagowanie wydarzeń innych użytkowników i zmiana stanu pokoju. Wymagana wartość jest definiowana przez zdarzenie poziomu mocy pokoju. Domyślne wartości Matrix dla banowania, wyrzucania i redagowania to zazwyczaj 50, jeśli nie są określone, ale poszczególne pokoje mogą je zmieniać.

W poradniku społeczności Matrixa opisano poziom mocy 100 jako typową konfigurację Mjolnira, umożliwiającą egzekwowanie decyzji moderacyjnych. Jednak ten poziom jest istotny: każdy, kto może skutecznie kontrolować konto Mjolnira, ma takie uprawnienia w chronionych pokojach, a bot może stać się ich faktycznym właścicielem. Przejrzyj poziomy mocy każdego pokoju i wybierz poziom, który pozwala botowi na wykonywanie wymaganych działań, jednocześnie ograniczając zbędne uprawnienia. Nie nadawaj mu statusu administratora serwera domowego do zwykłej moderacji pokoju.

W Element możesz zaprosić bota z panelu członkowskiego pokoju lub wpisać komendę zaproszenia, taką jak /invite @mjolnir:example.org. Po dołączeniu dostosuj jego rolę na liście członków pokoju. Powtórz tę czynność dla każdego pokoju, aby go chronić. Mjolnir nie może chronić pokoi, do których nie dołączył, co wynika ze zdecentralizowanego modelu uprawnień dla poszczególnych pokoi w Matrixie.

Jak utworzyć listę zakazów i dodać chronione pokoje?

Gdy bot uruchomi się i opublikuje swój status w pokoju zarządzania, utwórz tam listę zasad. Szybki start Mjolnira korzysta z tego przykładu:

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

Pierwsze polecenie tworzy pokój z listą banów za pomocą krótkiego kodu COC; osoba, która go tworzy, zostaje zaproszona, aby mogła zarządzać jego widocznością. Drugie wybiera tę listę jako domyślną dla późniejszych poleceń moderacji. Trzecie dodaje pokój do zestawu chronionych pokoi Mjolnira. Polecenie weryfikacji sprawdza, czy bot ma wymagane uprawnienia w chronionych pokojach, a polecenie statusu pomaga potwierdzić, że działa zgodnie z oczekiwaniami. Użyj !mjolnir help, aby wyświetlić składnię polecenia dostępną w zainstalowanej wersji.

Utrzymuj listę zasad w trybie prywatnym, jeśli zawiera wewnętrzne notatki lub jest przeznaczona tylko dla Twojego zespołu. Upublicznij ją tylko wtedy, gdy chcesz, aby inne społeczności mogły ją odkryć i subskrybować. Reguły Mjolnira są addytywne między listami, dlatego przejrzyj listy obserwowane przed ich zastosowaniem. Jedna lista może nadal odpowiadać użytkownikowi lub serwerowi, nawet jeśli usuniesz duplikat reguły z innej listy.

Co należy przetestować przed użyciem w rzeczywistym incydencie?

• Potwierdź, że bot publikuje komunikaty o uruchomieniu i stanie w skonfigurowanym pokoju zarządzania.
• Uruchom !mjolnir verifypo zaproszeniu do pokoju testowego i przyznaniu wybranej roli.
• Uruchom !mjolnir roomsi sprawdź, czy pojawi się żądany pokój, bez żadnych niepowiązanych pomieszczeń.
• Przeglądaj !mjolnir protectionsi włączaj tylko te zabezpieczenia, które rozumiesz; automatyczne zabezpieczenia mogą mieć wpływ na uprawnionych użytkowników.
• Użyj konta testowego i pokoju jednorazowego użytku, aby sprawdzić procedurę zespołu dotyczącą banowania, odbanowywania i redagowania, zanim zastosujesz ją wobec prawdziwych członków.
• Sprawdź logi kontenera i wiadomości z sali zarządzania Mjolnirem, jeśli bot pominie polecenia lub zgłosi brakujące uprawnienia.

Nie testuj, banując prawdziwego członka społeczności ani używając symbolu wieloznacznego na serwerze live. Blokady symboli wieloznacznych mogą dotyczyć wielu użytkowników; obecna domyślna konfiguracja wymaga dodatkowej flagi potwierdzającej dla blokad symboli wieloznacznych. Przeczytaj przewodnik moderatora przed włączeniem automatycznej ochrony i udokumentuj, kto może zatwierdzić działanie o dużym znaczeniu.

Jakie są najczęstsze błędy konfiguracji?

• Dla wygody nadaję uprawnienia administratora serwera botów: moderacja na poziomie pokoju zwykle wymaga uprawnień pokoju, a nie administratora Synapse.
• Pozostawienie pokoju zarządzania szerokim dostępem: każdy członek, który może wydawać polecenia, ma uprawnienia do moderowania bota.
• Zapominanie o uprawnieniach do chronionego pokoju: bot może być online, a mimo to nie blokować ani nie redagować treści, jeśli jego poziom mocy jest zbyt niski.
• Korzystanie z szyfrowanych pokoi bez skonfigurowania szyfrowania: samo członkostwo nie pozwala botowi na odczytywanie zaszyfrowanych poleceń.
• Kopiowanie starego przepisu konfiguracji: konfiguracja Mjolnir i obsługa szyfrowania ewoluują; należy używać bieżącego domyślnego przykładu i dokumentacji konfiguracji.
• Zakładając, że usunięcie jednej listy cofa wszystkie bany: inna obserwowana lista może nadal stosować tę samą regułę.

Gdzie można sprawdzić aktualne dane?

Zacznij od przewodnika konfiguracji Mjolnir , przewodnika moderatora i historii wydań . Aby uzyskać uprawnienia do pokoju, zapoznaj się z przewodnikiem moderacji społeczności Matrix oraz specyfikacją Matrix dotyczącą poziomów mocy pokoju . Dokładne polecenia instalacji i ustawienia szyfrowania zależą od serwera domowego, konfiguracji kontenera i wydania Mjolnir; te odniesienia do źródeł powinny mieć pierwszeństwo, jeśli ich instrukcje ulegną zmianie.