Podnieś limit plików Systemd w Synapse bez zgadywania
Sprawdź, czy Synapse osiągnął limit otwartych plików dla każdego procesu, ustaw drop-in systemd dla właściwej usługi lub pracownika i zweryfikuj limit aktywności.
Na dzień 10 października 2026 r. PyPI wymienia Simple-Matrix-Bot-Lib 2.13.1, wydaną 29 marca 2026 r. Pakiet wymaga Pythona w wersji 3.9 lub nowszej, ale Python 3.9 osiągnął koniec wsparcia technicznego; należy używać utrzymywanej wersji Pythona, którą obsługuje dany pakiet. W hostowanej dokumentacji projektu nadal widnieje wersja 2.11.0 i ostrzeżenie, że nie jest ona utrzymywana, dlatego niniejszy przewodnik opiera się na aktualnym przykładzie PyPI dla API bota, a starszy podręcznik zawiera jedynie wyraźnie oznaczone uwagi dotyczące konfiguracji. Sprawdź wydanie pakietu i metadane w PyPI . Przeczytaj status dokumentacji projektu .
Najszybszą i niezawodną konfiguracją jest dedykowany użytkownik Matrix, wirtualne środowisko Pythona i mały bot echo, który odpowiada !echow pomieszczeniu testowym. Przykład dotyczy pomieszczenia niezaszyfrowanego; pokoje zaszyfrowane wymagają dodatkowej konfiguracji.
Utwórz lub poproś o utworzenie konta na serwerze domowym, na którym będzie działał bot. Nadaj mu unikalną nazwę użytkownika, taką jak echo_bot; nie potrzebuje on uprawnień administratora serwera domowego. Rejestracja może być wyłączona lub ograniczona przez ten serwer, dlatego należy przestrzegać jego zasad tworzenia kont. Zaproś konto tylko do prywatnego pokoju testowego, gdzie może wysyłać wiadomości.
Użyj Pythona 3.11 lub innej aktualnie obsługiwanej gałęzi Pythona. Chociaż metadane pakietu nadal dopuszczają Pythona 3.9, Python.org oznacza koniec wsparcia dla tej gałęzi z dniem 31 października 2025 r., więc minimalna wersja pakietu nie jest dobrą rekomendacją wdrożenia. Informacja o wsparciu dla Pythona 3.9 na stronie Python.org .
Uruchom te polecenia z nowego folderu projektu. Wirtualne środowisko oddziela pakiety tego bota od innych projektów Pythona. Przypięcie wersji umożliwia odtworzenie przykładu w najnowszej wersji zweryfikowanej na potrzeby tego artykułu; podczas aktualizacji sprawdź aktualną wersję PyPI i jej informacje o zgodności.
python3 --version
python3 -m venv .venv
source .venv/bin/activate
python -m pip install "simplematrixbotlib==2.13.1"
W programie Windows PowerShell aktywuj środowisko za pomocą polecenia .venv\Scripts\Activate.ps1zamiast sourcepolecenia. Następnie utwórz plik o nazwie bot.py. Strona projektu PyPI dokumentuje nazwę pakietu i polecenie instalacji, a w opublikowanym przykładzie użyto Creds, Bot, nasłuchiwacza komunikatów i MessageMatch. Zobacz aktualny przykład użycia PyPI .

Zapisz poniższy kod jako bot.py. Podczas uruchamiania pojawi się monit o podanie hasła bota, więc hasło nie zostanie zapisane w pliku źródłowym. W przypadku nienadzorowanego wdrażania usługi, zamiast zapisywać je na stałe, należy odczytać klucz tajny z menedżera kluczy tajnych systemu operacyjnego lub z chronionej zmiennej środowiskowej. Traktuj każdą sesję lub magazyn tokenów dostępu utworzony przez bibliotekę jako dane uwierzytelniające: przechowuj je w tajemnicy i poza kontrolą wersji.
import getpass
import simplematrixbotlib as botlib
creds = botlib.Creds(
homeserver="https://matrix.example.org",
username="echo_bot",
password=getpass.getpass("Bot password: "),
)
bot = botlib.Bot(creds)
PREFIX = "!"
@bot.listener.on_message_event
async def echo(room, message):
match = botlib.MessageMatch(room, message, bot, PREFIX)
if (match.is_not_from_this_bot()
and match.prefix()
and match.command("echo")):
text = " ".join(match.args())
reply = text or "Usage: !echo <text>"
await bot.api.send_text_message(room.room_id, reply)
bot.run()
Zastąp przykładowy adres URL serwera domowego adresem URL swojego serwera bazowego i użyj nazwy użytkownika i hasła konta bota. Nasłuchiwacz odbiera wiadomości z pokoju; MessageMatchignoruje własne wiadomości i obsługuje tylko !echopolecenie. Wywołanie API odsyła pozostałe słowa z powrotem do tego samego pokoju. Te nazwy i wywołania metod są zgodne z opublikowanym przykładem biblioteki PyPI. Porównaj z szybkim startem Simple-Matrix-Bot-Lib .


Z aktywowanego środowiska wirtualnego uruchom:
python bot.py
Wprowadź hasło do konta bota po wyświetleniu monitu. W pokoju testowym wyślij !echo hello. Działający bot odpowiada hello. Jeśli nie odpowiada, sprawdź, czy konto bota dołączyło do tego pokoju, czy użytkownik ma uprawnienia do wysyłania tam wiadomości, czy adres URL serwera domowego jest poprawny, a wiadomość zaczyna się od dokładnego !prefiksu. Nie przerywaj procesu; zamknięcie terminala zatrzymuje to proste wdrożenie na pierwszym planie.

Przykład nie przetwarza kompleksowo szyfrowanych wiadomości z pokoi. Biblioteka reklamuje obsługę E2EE, ale jej aktualnie hostowany podręcznik nosi oznaczenie 2.11.0 i może być nieaktualny; podręcznik ten opisuje dodatkowe matrix-nio[e2e]zależności i Config.encryption_enabledustawienie. Przed włączeniem szyfrowania sprawdź dokładne kroki instalacji i weryfikacji dla instalowanej wersji. Starsza dokumentacja również udostępnia join_on_inviteustawienie: zaproś bota tylko do pokoi, do których powinien mieć dostęp, i sprawdź to ustawienie, jeśli wdrożenie musi kontrolować automatyczne dołączanie do pokoi. Zapoznaj się z podręcznikiem biblioteki dotyczącym E2EE i konfiguracji .
Konfiguracja jest zakończona, gdy bot pozostaje zalogowany, jest członkiem sali testowej i odpowiada !echo hello. helloW środowisku produkcyjnym należy uruchomić go w menedżerze procesów i zabezpieczyć jego hasło oraz dane sesji.
Sprawdź, czy Synapse osiągnął limit otwartych plików dla każdego procesu, ustaw drop-in systemd dla właściwej usługi lub pracownika i zweryfikuj limit aktywności.
Sprawdź, czy błąd dotyczy jednej przeglądarki lub jednego zdarzenia, a następnie użyj klucza odzyskiwania Element lub zaufanego urządzenia, nie ryzykując utraty zaszyfrowanej historii.
Użyj interfejsów API Synapse do czyszczenia historii i multimediów lub ustawień przechowywania, aby bezpiecznie usunąć nieaktualne dane, a następnie zweryfikuj ukończenie operacji i odzyskanie miejsca na dysku.
Zainstaluj aktualną bibliotekę, podłącz dedykowane konto Matrix i uruchom małego bota !echo z bezpieczniejszą obsługą poświadczeń i przejrzystym testem.
Skonfiguruj trzy mosty Mautrix z oddzielnymi rejestracjami, logowaniami i testami, aby uniknąć niespodzianek związanych z siecią Docker, polityką kont i synchronizacją.
Znajdź elementy zapełniające pamięć masową Synapse, ustaw bezpieczne przechowywanie multimediów i wyczyść zdalną pamięć podręczną bez konieczności usuwania plików bezpośrednio z dysku.
Przejrzyj aktywność urządzenia, dezaktywuj potwierdzone nieaktywne konta Synapse za pomocą interfejsu API administratora i dowiedz się, co tak naprawdę usuwa opcjonalna flaga usuwania.
Sprawdź, czy pamięć PostgreSQL pochodzi z obsługi zapytań, współdzielonych buforów, połączeń czy konserwacji, a następnie wprowadź ukierunkowane zmiany bezpieczne dla Synapse.
Śledź powolne dołączanie pokoju Matrix do jednego zdalnego serwera domowego, wycofywanie federacji, obciążenie lokalnej bazy danych lub kolejkę nadawcy wychodzącego przed zmianą ustawień Synapse.
Zatrzymaj możliwość tworzenia otwartych kont na samodzielnie hostowanym serwerze Synapse lub zachowaj możliwość rejestracji wyłącznie na zaproszenia, korzystając z tokenów rejestracyjnych o ograniczonym zastosowaniu.