Acasă
» Cum să
»
Conectează Matrix la WhatsApp, Telegram și Discord cu Bridge-uri separate
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ă.
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
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.
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.
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:
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.
Synapse are nevoie de o cale de înregistrare separată și lizibilă pentru fiecare bridge, urmată de o repornire a serverului principal.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.
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.