Conectează Matrix la WhatsApp, Telegram și Discord cu Bridge-uri separate

Pentru a conecta WhatsApp, Telegram și Discord, rulați trei punți separate, înregistrați fiecare ca serviciu de aplicație și conectați-vă prin propriul flux. Succesul înseamnă că fiecare bot raportează o sesiune autentificată, iar mesajele de test circulă în ambele sensuri prin sălile portalului; un bot care apare doar online nu este suficient.

Acest document este destinat administratorului unui server de acasă care permite servicii de aplicații. Nu puteți adăuga o punte auto-găzduită la matrix.org decât dacă administratorii acesteia oferă una; utilizați un server pe care îl controlați sau o punte găzduită disponibilă. Documentația proiectului a fost verificată pe 10 octombrie 2026.

1. Decideți ce conectați și pregătiți serverul

Acestea sunt trei servicii separate, fiecare cu propria configurație, înregistrare, bază de date și autentificare. Mautrix folosește în principal puppeting: mesajele circulă prin contul dvs. la distanță conectat și apar în Matrix ca acel cont. Un bot de relay este diferit; alegeți-l numai dacă doriți o identitate de bot partajată, mai degrabă decât contul dvs. personal.

Aveți nevoie de un server de acasă capabil să gestioneze servicii de aplicații, acces de administrator și conectivitate la rețea pentru fiecare bridge. Docker este documentat. Dați fiecărui bridge propriul director de date și alegeți o etichetă de versiune întreținută; mautrix notează că latestpoate urmări cea mai recentă modificare (commit) mai degrabă decât o versiune.

Folosește o bază de date separată pentru fiecare bridge; un server PostgreSQL poate fi partajat, dar baza de date în sine nu trebuie partajată cu un alt bridge sau Synapse. SQLite este o opțiune pentru instanțe mici. Decide-te cu privire la criptarea end-to-bridge înainte de autentificare, deoarece activarea acesteia ulterior pentru sălile portal existente este dificilă.

Listarea directoarelor terminalului cu foldere separate mautrix-whatsapp, mautrix-telegram și mautrix-discord, fiecare afișând propriul fișier de configurare și bază de date.
Păstrați configurația și baza de date a fiecărei punți în propriul director de lucru înainte de a porni containerele.

2. Configurați și înregistrați toate cele trei servicii ale aplicației

  1. Generați configurația inițială a fiecărui bridge. Urmați pagina de configurare Docker pentru acel bridge și rulați containerul său o dată cu propriul director de date montat. Editați configurația generată înainte de a o porni normal. Completați domeniul și adresa serverului de bază, adresa bridge-ului, URI-ul bazei de date și permisiunile. Aceste valori sunt specifice implementării dvs.; nu lipiți secrete exemple în producție.
  2. Folosiți adrese accesibile din containere. Când Synapse și bridge-urile partajează o rețea Docker, adresa serverului de bază al bridge-ului poate utiliza numele serviciului Synapse, cum ar fi http://synapse:8008. Adresa serviciului aplicației trebuie să indice înapoi la numele serviciului și portul de ascultare al bridge-ului respectiv. localhostdin interiorul unui container bridge indică către același container, nu către Synapse sau către un alt bridge, deci de obicei întrerupe comunicarea. Dacă serverul de bază este în afara Docker, publicați sau rutați în schimb portul bridge necesar.
  3. Generați și instalați câte un fișier de înregistrare per bridge. Rulați comanda de configurare a fiecărui bridge pentru a genera fișierul YAML de înregistrare, apoi plasați toate cele trei fișiere unde Synapse le poate citi. În homeserver.yaml, adăugați căile lor sub app_service_config_files, de exemplu:
app_service_config_files:
  - /data/appservices/mautrix-whatsapp-registration.yaml
  - /data/appservices/mautrix-telegram-registration.yaml
  - /data/appservices/mautrix-discord-registration.yaml

Montați fișierele de înregistrare în containerul Synapse dacă Synapse rulează în Docker. Reporniți Synapse după editarea listei. O greșeală de scriere YAML, o cale greșită, o montare ilizibilă sau o adresă de bridge nepotrivită pot împiedica înregistrarea sau pot opri pornirea Synapse. Dacă modificați ulterior setările bridge legate de înregistrare, regenerați fișierul de înregistrare relevant și reporniți Synapse din nou.

Editor de cod care prezintă fișierul Synapse homeserver.yaml cu trei căi separate de înregistrare a serviciilor de aplicații pentru WhatsApp, Telegram și Discord.
Synapse are nevoie de o cale de înregistrare separată și lizibilă pentru fiecare bridge, urmată de o repornire a serverului principal.
Panoul de stare a containerului listează Synapse și trei containere Mautrix Bridge care rulează într-o rețea Matrix partajată.
Verificați dacă Synapse și toate cele trei containere bridge rulează într-o rețea în care numele serviciilor lor se rezolvă.

3. Adăugați acreditările specifice serviciului și conectați-vă

WhatsApp

Pornește mautrix-whatsapp și deschide un mesaj direct Matrix cu botul său bridge, de obicei @whatsappbot:your.server. Trimite login qr, apoi scanează codul QR din ecranul Dispozitive conectate al WhatsApp de pe telefon. Așteaptă ca botul să confirme autentificarea; documentația bridge-ului spune că poate dura aproximativ un minut până când apare portal rooms. WhatsApp este conectat ca dispozitiv, deci acesta nu este un cont cloud independent. Documentația bridge-ului spune că dispozitivele conectate se deconectează dacă telefonul rămâne offline mai mult de două săptămâni. Dacă nu poți menține telefonul activ, analizează dacă acest bridge îndeplinește nevoile tale de fiabilitate înainte de a te baza pe el pentru conversații importante.

Telegram

Înainte de a te conecta la Telegram, creează o aplicație API la my.telegram.org/apps și pune-i valorile api_idși api_hashîn configurația mautrix-telegram. Aceste valori API permit bridge-ului să se conecteze la API-ul Telegram; ele nu autentifică singure un cont Telegram. Apoi trimite mesajul @telegrambot:your.serverși folosește login qr[comment], scanându-l din aplicația mobilă Telegram din Setări, Dispozitive și Conectează dispozitivul desktop. Opțiunea de cod poate fi livrată către o sesiune Telegram existentă, nu prin SMS, iar bridge-ul poate solicita parola de verificare în doi pași. Verifică setările de completare ale bridge-ului înainte de a te conecta dacă importul de mesaje mai vechi este important; modificarea așteptărilor după crearea camerelor portalului poate fi prea târzie.

Discord

Pentru un server, folosește un bot Discord dedicat, nu automatizarea contului tău personal: Discord interzice auto-boții și poate închide conturi. Creează o aplicație și un bot în Portalul pentru dezvoltatori, activează doar intențiile privilegiate pe care le necesită bridge-ul și pe care aplicația ta le poate obține, apoi invită-l cu domeniul de aplicare al botului OAuth2 și permisiunile minime pentru canal. Accesul la intenție este controlat prin politici; fără accesul necesar la conținutul mesajelor sau la membri, este posibil ca unele funcții să nu funcționeze. În Matrix, trimite mesaje private @discordbot:your.serverși urmează instrucțiunile de conectare la bot-token din mautrix-discord. Un bot nu oferă același acces personal prin mesaje private ca un bridge cu cont de utilizator.

Un editor de configurare a bridge-ului care afișează o adresă de serviciu Synapse, o adresă de serviciu mautrix-whatsapp și un nume distinct pentru baza de date a bridge-ului.
Verificați numele de gazdă al serviciului, listener-ul bridge-ului și detaliile unice ale bazei de date în configurația fiecărei bridge-uri.

4. Testați livrarea, apoi ajustați doar ceea ce arată rezultatul

Trimiteți un mesaj direct fiecărui bot de bridge și confirmați statusul de autentificare. Într-o cameră portal pentru fiecare serviciu, trimiteți un mesaj de test de la Matrix și răspundeți din aplicația de la distanță. Verificați ca ambele să ajungă în camera corectă. Pentru grupuri sau canale Discord, confirmați mai întâi că există un cont de bridge și că are permisiuni de citire/postare. O autentificare reușită nu dovedește livrarea.

Dacă un bot este silențios, verificați jurnalele sale pentru valori lipsă, erori în baza de date sau conectivitate la serverul principal. Dacă autentificarea funcționează, dar camerele nu apar, verificați portalul și setările de completare. Pentru mesajele lipsă ale canalului Discord, verificați apartenența botului, permisiunile și intenția de acces. Dacă Synapse nu pornește, verificați indentarea YAML și montările fișierelor de înregistrare lizibile.

Funcțiile suportate variază în funcție de versiunea bridge-ului și de tipul de cont; apelurile, reacțiile, chat-urile criptate, fișierele media și importul istoricului pot diferi sau pot fi neacceptate. Verificați lista curentă de funcții a fiecărui bridge înainte de a vă baza pe acesta ca unic punct de acces. Restricționați accesul la fișierele de înregistrare și la acreditări, faceți copii de rezervă ale datelor bridge-ului în siguranță și revocați o sesiune sau un token conectat dacă este expus.

Folosește instrucțiunile actuale Mautrix Docker , ghidul de înregistrare , referința de configurare și paginile de autentificare WhatsApp , Telegram și Discord pentru comenzi specifice versiunii. Consultă politica Discord privind auto-boții .

Lasă un comentariu

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.

Elementul afișează „Decriptare eșuată”? Restaurați cheia camerei lipsă

Elementul afișează „Decriptare eșuată”? Restaurați cheia camerei lipsă

Află dacă eroarea este limitată la un singur browser sau la un singur eveniment, apoi folosește cheia de recuperare Element sau un dispozitiv de încredere fără a risca istoricul criptat rămas.

Curățați mesajele și fișierele media vechi din sinapse fără a pierde date

Folosește API-urile sau setările de retenție pentru istoric și epurare media ale Synapse pentru a elimina în siguranță datele învechite, apoi verifică finalizarea și recuperarea spațiului pe disc.

Construiți un bot Matrix Echo în Python cu Simple-Matrix-Bot-Lib

Construiți un bot Matrix Echo în Python cu Simple-Matrix-Bot-Lib

Instalați biblioteca curentă, conectați un cont Matrix dedicat și rulați un mic bot !echo cu o gestionare mai sigură a acreditărilor și un test clar.

Conectează Matrix la WhatsApp, Telegram și Discord cu Bridge-uri separate

Conectează Matrix la WhatsApp, Telegram și Discord cu Bridge-uri separate

Configurați trei punți Mautrix cu înregistrări, conectări și teste separate - și evitați surprizele legate de rețelele Docker, politicile de cont și sincronizare.

Recuperați spațiul de pe disc Synapse Media fără a deteriora fișierele partajate

Găsiți ce umple spațiul de stocare Synapse, setați retenția sigură a suporturilor media și goliți memoria cache la distanță fără a șterge fișierele direct de pe disc.

Dezactivarea utilizatorilor inactivi din matrice fără a șterge istoricul camerei

Dezactivarea utilizatorilor inactivi din matrice fără a șterge istoricul camerei

Verifică activitatea dispozitivului, dezactivează conturile Synapse inactive confirmate prin intermediul API-ului Admin și află ce elimină de fapt indicatorul opțional de ștergere.

Reduceți presiunea memoriei PostgreSQL în sinapsa matriceală

Află dacă memoria PostgreSQL provine din interogări, buffere partajate, conexiuni sau mentenanță, apoi fă modificări specifice, sigure pentru sinapse.

De ce sunt lente alăturările la Matrix Synapse Room și ce trebuie verificat

De ce sunt lente alăturările la Matrix Synapse Room și ce trebuie verificat

Urmăriți alăturările lente ale camerei Matrix la un server de acasă la distanță, retragerea temporară a federației, încărcarea bazei de date locale sau o coadă de expediere înainte de a modifica setările Synapse.

Închideți înscrierile la Matrix sau solicitați token-uri de invitație pe Synapse

Opriți crearea de conturi deschise pe un server Synapse auto-găzduit sau mențineți înscrierile doar pe bază de invitație cu token-uri de înregistrare cu utilizare limitată.