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.
Aby połączyć WhatsApp, Telegram i Discord, należy uruchomić trzy oddzielne mosty, zarejestrować każdy z nich jako usługę aplikacji i zalogować się za pomocą osobnego procesu. Sukces oznacza, że każdy bot zgłasza uwierzytelnioną sesję, a wiadomości testowe są przesyłane w obie strony przez pokoje portalowe; samo pojawienie się bota online nie wystarczy.
To jest przeznaczone dla administratora serwera domowego, który zezwala na usługi aplikacyjne. Nie można dodać samodzielnie hostowanego mostu do matrix.org, chyba że administratorzy go zaoferują; należy użyć serwera, nad którym sprawujesz kontrolę, lub dostępnego hostowanego mostu. Dokumentacja projektu została sprawdzona 10 października 2026 r.
Są to trzy oddzielne usługi, każda z własną konfiguracją, rejestracją, bazą danych i logowaniem. Mautrix wykorzystuje głównie mechanizm „puppeting”: wiadomości są przesyłane przez połączone konto zdalne i pojawiają się w Matrixie jako to konto. Bot przekaźnikowy działa inaczej; wybierz go tylko wtedy, gdy chcesz korzystać ze wspólnej tożsamości bota, a nie z konta osobistego.
Potrzebujesz serwera domowego obsługującego usługi aplikacyjne, dostępu administratora i połączenia sieciowego z każdym mostem. Docker jest udokumentowany. Przypisz każdemu mostowi własny katalog danych i wybierz tag „wersja utrzymywana”; notatki Mautrix mogą latestśledzić najnowsze zatwierdzenie, a nie wydanie.
Użyj oddzielnej bazy danych dla każdego mostu; serwer PostgreSQL może być współdzielony, ale sama baza danych nie może być współdzielona z innym mostem ani Synapse. SQLite jest opcją dla małych instancji. Zdecyduj o szyfrowaniu typu „end-to-bridge” przed zalogowaniem, ponieważ późniejsze włączenie go w istniejących pokojach portalu jest trudne.

http://synapse:8008. Adres usługi aplikacji musi wskazywać na nazwę usługi i port nasłuchu tego mostu. localhostAdres wewnątrz kontenera mostu wskazuje na ten sam kontener, a nie na Synapse ani inny most, więc zazwyczaj przerywa komunikację. Jeśli serwer macierzysty znajduje się poza Dockerem, opublikuj lub przekieruj wymagany port mostu.homeserver.yaml, dodaj ich ścieżki w app_service_config_files, na przykład:app_service_config_files:
- /data/appservices/mautrix-whatsapp-registration.yaml
- /data/appservices/mautrix-telegram-registration.yaml
- /data/appservices/mautrix-discord-registration.yaml
Zamontuj pliki rejestracyjne w kontenerze Synapse, jeśli Synapse działa w Dockerze. Po edycji listy uruchom ponownie Synapse. Błąd w pliku YAML, nieprawidłowa ścieżka, nieczytelny montaż lub niezgodny adres mostu mogą uniemożliwić rejestrację lub uruchomienie Synapse. Jeśli później zmienisz ustawienia mostu związane z rejestracją, wygeneruj ponownie odpowiedni plik rejestracyjny i ponownie uruchom Synapse.


Uruchom aplikację Mautrix-WhatsApp i otwórz bezpośrednią wiadomość Matrix z botem mostu, zazwyczaj @whatsappbot:your.server. Wyślij login qr, a następnie zeskanuj kod QR z ekranu „Połączone urządzenia” WhatsApp na telefonie. Poczekaj, aż bot potwierdzi uwierzytelnienie; dokumentacja mostu informuje, że pojawienie się pokoi portalowych może zająć około minuty. WhatsApp jest połączony jako urządzenie, więc nie jest to samodzielne konto w chmurze. Dokumentacja mostu informuje, że połączone urządzenia rozłączają się, jeśli telefon pozostaje offline przez ponad dwa tygodnie. Jeśli nie możesz utrzymać telefonu w trybie aktywnym, zastanów się, czy ten most spełnia Twoje wymagania dotyczące niezawodności, zanim zaczniesz na nim polegać w ważnych rozmowach.
Przed zalogowaniem się do Telegrama utwórz aplikację API na stronie my.telegram.org/apps i umieść jej api_idwartość ▲ api_hashw konfiguracji mautrix-telegram. Te wartości API umożliwiają mostowi połączenie z API Telegrama; same w sobie nie uwierzytelniają konta Telegrama. Następnie wyślij wiadomość @telegrambot:your.serveri użyj ▼ login qr, skanując ją z aplikacji mobilnej Telegrama w Ustawieniach, Urządzeniach i Połącz urządzenie stacjonarne. Opcja kodu może zostać wysłana do istniejącej sesji Telegrama, a nie SMS-em, a most może poprosić o podanie hasła do weryfikacji dwuetapowej. Sprawdź ustawienia uzupełniania mostu przed zalogowaniem, jeśli importowanie starszych wiadomości ma znaczenie; zmiana oczekiwań po utworzeniu pokoi w portalu może być zbyt późna.
W przypadku serwera użyj dedykowanego bota Discord, a nie automatyzacji swojego konta osobistego: Discord zabrania self-botów i może zamknąć konta. Utwórz aplikację i bota w Portalu Dewelopera, włącz tylko uprzywilejowane intencje wymagane przez most, które Twoja aplikacja może uzyskać, a następnie zaproś go z zakresem bota OAuth2 i minimalnymi uprawnieniami do kanału. Dostęp do intencji jest kontrolowany przez zasady; bez wymaganej zawartości wiadomości lub dostępu członka, niektóre funkcje mogą nie działać. W Matrix, wyślij wiadomość prywatną @discordbot:your.serveri postępuj zgodnie z instrukcjami logowania za pomocą tokena bota z Mautrix-Discord. Bot nie zapewnia takiego samego dostępu do wiadomości prywatnej, jak most konta użytkownika.

Napisz wiadomość prywatną do każdego bota mostu i potwierdź status uwierzytelnienia. W jednym pokoju portalu na usługę wyślij wiadomość testową z Matrix i odpowiedz z aplikacji zdalnej. Sprawdź, czy obie wiadomości dotrą do właściwego pokoju. W przypadku grup lub kanałów Discord najpierw sprawdź, czy konto mostu jest obecne i ma uprawnienia do odczytu/publikowania. Samo pomyślne zalogowanie nie jest dowodem na dostarczenie wiadomości.
Jeśli bot jest cichy, sprawdź jego logi pod kątem brakujących wartości, błędów bazy danych lub łączności z serwerem domowym. Jeśli logowanie działa, ale pokoje się nie pojawiają, sprawdź ustawienia portalu i uzupełniania. W przypadku brakujących wiadomości na kanale Discord sprawdź członkostwo bota, uprawnienia i dostęp do intencji. Jeśli Synapse nie uruchamia się, sprawdź wcięcia w YAML i czytelne montowania plików rejestracyjnych.
Obsługa funkcji różni się w zależności od wersji mostu i typu konta; połączenia, reakcje, szyfrowane czaty, multimedia i import historii mogą się różnić lub być nieobsługiwane. Sprawdź aktualną listę funkcji każdego mostu, zanim zaczniesz używać go jako jedynego punktu dostępu. Ogranicz dostęp do plików rejestracyjnych i danych uwierzytelniających, bezpiecznie twórz kopie zapasowe danych mostu i unieważniaj powiązaną sesję lub token w przypadku ujawnienia.
Skorzystaj z aktualnych instrukcji Mautrix Docker , przewodnika rejestracji , informacji o konfiguracji oraz stron uwierzytelniania WhatsApp , Telegram i Discord , aby zapoznać się z poleceniami specyficznymi dla danej wersji. Zapoznaj się z polityką Discord dotyczącą self-botów .
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.