เชื่อมต่อ Matrix กับ WhatsApp, Telegram และ Discord ด้วยบริดจ์แยกต่างหาก

ในการเชื่อมต่อ WhatsApp, Telegram และ Discord ให้เรียกใช้บริดจ์แยกกันสามตัว ลงทะเบียนแต่ละตัวเป็นบริการแอปพลิเคชัน และลงชื่อเข้าใช้ผ่านขั้นตอนของตนเอง ความสำเร็จหมายความว่าบอทแต่ละตัวรายงานเซสชันที่ได้รับการตรวจสอบสิทธิ์แล้ว และข้อความทดสอบสามารถส่งไปมาได้ทั้งสองทางผ่านห้องพอร์ทัล การที่บอทปรากฏออนไลน์เพียงอย่างเดียวไม่เพียงพอ

นี่สำหรับผู้ดูแลระบบโฮมเซิร์ฟเวอร์ที่อนุญาตให้ใช้งานบริการแอปพลิเคชัน คุณไม่สามารถเพิ่มบริดจ์ที่โฮสต์เองไปยัง matrix.org ได้ เว้นแต่ผู้ดูแลระบบจะจัดหาให้ โปรดใช้เซิร์ฟเวอร์ที่คุณควบคุมหรือบริดจ์ที่โฮสต์อยู่แล้ว เอกสารโครงการได้รับการตรวจสอบเมื่อวันที่ 10 ตุลาคม 2026

1. ตัดสินใจว่าจะเชื่อมต่ออะไร และเตรียมเซิร์ฟเวอร์ให้พร้อม

นี่คือบริการแยกกันสามอย่าง โดยแต่ละอย่างมีการตั้งค่า การลงทะเบียน ฐานข้อมูล และการเข้าสู่ระบบเป็นของตัวเอง mautrix ใช้การควบคุมแบบหุ่นกระบอกเป็นหลัก: ข้อความจะเดินทางผ่านบัญชีระยะไกลที่เชื่อมโยงของคุณและปรากฏใน Matrix ในฐานะบัญชีนั้น ส่วนบอทรีเลย์นั้นแตกต่างออกไป ควรเลือกใช้เฉพาะเมื่อคุณต้องการใช้ข้อมูลประจำตัวบอทร่วมกันแทนที่จะใช้บัญชีส่วนตัวของคุณ

คุณต้องมีโฮมเซิร์ฟเวอร์ที่รองรับบริการแอปพลิเคชัน สิทธิ์การเข้าถึงของผู้ดูแลระบบ และการเชื่อมต่อเครือข่ายไปยังแต่ละบริดจ์ Docker มีเอกสารอธิบายไว้แล้ว กำหนดไดเร็กทอรีข้อมูลให้กับแต่ละบริดจ์ และเลือกแท็กเวอร์ชันที่ได้รับการดูแลรักษา Mautrix ระบุว่าlatestอาจติดตามการคอมมิตล่าสุดมากกว่าการเผยแพร่

ใช้ฐานข้อมูลแยกต่างหากสำหรับแต่ละบริดจ์ เซิร์ฟเวอร์ PostgreSQL อาจใช้ร่วมกันได้ แต่ฐานข้อมูลนั้นต้องไม่ใช้ร่วมกับบริดจ์อื่นหรือ Synapse SQLite เป็นอีกทางเลือกหนึ่งสำหรับอินสแตนซ์ขนาดเล็ก ตัดสินใจเกี่ยวกับการเข้ารหัสแบบ end-to-bridge ก่อนเข้าสู่ระบบ เนื่องจากเป็นการยากที่จะเปิดใช้งานในภายหลังสำหรับห้องพอร์ทัลที่มีอยู่แล้ว

รายการไดเร็กทอรีในเทอร์มินัลแสดงโฟลเดอร์ mautrix-whatsapp, mautrix-telegram และ mautrix-discord แยกกัน โดยแต่ละโฟลเดอร์แสดงการกำหนดค่าและไฟล์ฐานข้อมูลของตนเอง
ก่อนเริ่มคอนเทนเนอร์ ให้เก็บไฟล์การกำหนดค่าและฐานข้อมูลของแต่ละบริดจ์ไว้ในไดเร็กทอรีการทำงานของแต่ละบริดจ์โดยเฉพาะ

2. กำหนดค่าและลงทะเบียนบริการแอปพลิเคชันทั้งสามรายการ

  1. สร้างการกำหนดค่าเริ่มต้นสำหรับแต่ละบริดจ์ทำตามหน้าการตั้งค่า Docker สำหรับบริดจ์นั้น ๆ และเรียกใช้คอนเทนเนอร์หนึ่งครั้งโดยเชื่อมต่อไดเร็กทอรีข้อมูลของตัวเอง แก้ไขการกำหนดค่าที่สร้างขึ้นก่อนที่จะเริ่มต้นใช้งานตามปกติ กรอกโดเมนและที่อยู่ของโฮมเซิร์ฟเวอร์ ที่อยู่บริดจ์ URI ของฐานข้อมูล และสิทธิ์การเข้าถึง ค่าเหล่านี้เป็นค่าเฉพาะสำหรับการใช้งานของคุณ อย่าคัดลอกข้อมูลลับตัวอย่างไปใช้ในสภาพแวดล้อมการผลิต
  2. ใช้แอดเดรสที่เข้าถึงได้จากคอนเทนเนอร์เมื่อ Synapse และบริดจ์ใช้เครือข่าย Docker ร่วมกัน แอดเดรส homeserver ของบริดจ์สามารถใช้ชื่อบริการของ Synapse ได้ เช่นhttp://synapse:8008`<homeserver_name>` แอดเดรสบริการแอปพลิเคชันต้องชี้กลับไปยังชื่อบริการและพอร์ตการฟังของบริดจ์นั้น `<homeserver_name>` localhostภายในคอนเทนเนอร์บริดจ์จะชี้ไปยังคอนเทนเนอร์นั้นเอง ไม่ใช่ Synapse หรือบริดจ์อื่น ดังนั้นมักจะทำให้การสื่อสารล้มเหลว หาก homeserver อยู่นอก Docker ให้เผยแพร่หรือกำหนดเส้นทางพอร์ตบริดจ์ที่จำเป็นแทน
  3. สร้างและติดตั้งไฟล์ลงทะเบียนหนึ่งไฟล์ต่อบริดจ์หนึ่งตัวเรียกใช้คำสั่ง setup ของแต่ละบริดจ์เพื่อสร้างไฟล์ YAML สำหรับการลงทะเบียน จากนั้นวางไฟล์ทั้งสามไฟล์ไว้ในตำแหน่งที่ Synapse สามารถอ่านได้ ในไฟล์ ให้homeserver.yamlเพิ่มพาธของไฟล์เหล่านั้นไว้ใต้app_service_config_filesตัวอย่างเช่น:
app_service_config_files:
  - /data/appservices/mautrix-whatsapp-registration.yaml
  - /data/appservices/mautrix-telegram-registration.yaml
  - /data/appservices/mautrix-discord-registration.yaml

หาก Synapse ทำงานใน Docker ให้ทำการเมานต์ไฟล์ลงทะเบียนไว้ภายในคอนเทนเนอร์ Synapse จากนั้นรีสตาร์ท Synapse หลังจากแก้ไขรายการเสร็จแล้ว การพิมพ์ผิดในไฟล์ YAML เส้นทางที่ไม่ถูกต้อง การเมานต์ที่ไม่สามารถอ่านได้ หรือที่อยู่บริดจ์ที่ไม่ตรงกัน อาจขัดขวางการลงทะเบียนหรือทำให้ Synapse ไม่สามารถเริ่มต้นได้ หากคุณเปลี่ยนแปลงการตั้งค่าบริดจ์ที่เกี่ยวข้องกับการลงทะเบียนในภายหลัง ให้สร้างไฟล์ลงทะเบียนที่เกี่ยวข้องขึ้นมาใหม่และรีสตาร์ท Synapse อีกครั้ง

โปรแกรมแก้ไขโค้ดแสดงไฟล์ Synapse homeserver.yaml ซึ่งมีเส้นทางการลงทะเบียนบริการแอปพลิเคชันแยกกันสามเส้นทางสำหรับ WhatsApp, Telegram และ Discord
Synapse ต้องการเส้นทางการลงทะเบียนที่อ่านได้แยกต่างหากสำหรับแต่ละบริดจ์ ตามด้วยการรีสตาร์ทโฮมเซิร์ฟเวอร์
แผงแสดงสถานะคอนเทนเนอร์แสดงรายการ Synapse และคอนเทนเนอร์ Mautrix Bridge สามรายการที่กำลังทำงานอยู่บนเครือข่าย Matrix ที่ใช้ร่วมกัน
ตรวจสอบให้แน่ใจว่า Synapse และคอนเทนเนอร์บริดจ์ทั้งสามตัวทำงานอยู่บนเครือข่ายที่ชื่อบริการของพวกมันสามารถระบุได้อย่างถูกต้อง

3. เพิ่มข้อมูลประจำตัวเฉพาะบริการและเข้าสู่ระบบ

WhatsApp

เริ่มใช้งาน mautrix-whatsapp และเปิดข้อความโดยตรงของ Matrix กับบอทเชื่อมต่อ (โดยทั่วไปคือ@whatsappbot:your.server) ส่งข้อความlogin qrจากนั้นสแกนคิวอาร์โค้ดจากหน้าจออุปกรณ์ที่เชื่อมโยงของ WhatsApp บนโทรศัพท์ของคุณ รอให้บอทยืนยันการตรวจสอบสิทธิ์ เอกสารของตัวเชื่อมต่อระบุว่าห้องสนทนาอาจใช้เวลาประมาณหนึ่งนาทีในการปรากฏ WhatsApp ถูกเชื่อมต่อเป็นอุปกรณ์ ดังนั้นนี่จึงไม่ใช่บัญชีคลาวด์แบบสแตนด์อโลน เอกสารของตัวเชื่อมต่อระบุว่าอุปกรณ์ที่เชื่อมโยงจะตัดการเชื่อมต่อหากโทรศัพท์ออฟไลน์นานกว่าสองสัปดาห์ หากคุณไม่สามารถเปิดใช้งานโทรศัพท์ได้ โปรดพิจารณาว่าตัวเชื่อมต่อนี้ตรงกับความต้องการด้านความน่าเชื่อถือของคุณหรือไม่ ก่อนที่จะพึ่งพามันสำหรับการสนทนาที่สำคัญ

Telegram

ก่อนเข้าสู่ระบบ Telegram ให้สร้างแอปพลิเคชัน API ที่my.telegram.org/appsและใส่ค่าapi_idต่างๆapi_hashลงในการตั้งค่าของ mautrix-telegram ค่า API เหล่านี้จะช่วยให้บริดจ์เชื่อมต่อกับ API ของ Telegram ได้ แต่จะไม่ตรวจสอบสิทธิ์บัญชี Telegram ด้วยตัวเอง จากนั้นส่งข้อความ@telegrambot:your.serverและใช้login qrโดยสแกนจากแอป Telegram บนมือถือภายใต้ การตั้งค่า อุปกรณ์ และ เชื่อมโยงอุปกรณ์เดสก์ท็อป ตัวเลือกโค้ดอาจถูกส่งไปยังเซสชัน Telegram ที่มีอยู่แล้วแทนที่จะเป็น SMS และบริดจ์อาจขอให้คุณป้อนรหัสผ่านยืนยันสองขั้นตอน ตรวจสอบการตั้งค่าการเติมข้อความเก่าของบริดจ์ก่อนเข้าสู่ระบบหากการนำเข้าข้อความเก่ามีความสำคัญ การเปลี่ยนแปลงความคาดหวังหลังจากสร้างห้องพอร์ทัลแล้วอาจสายเกินไป

ดิสคอร์ด

สำหรับการใช้งานเป็นเซิร์ฟเวอร์ ให้ใช้บอท Discord เฉพาะ ไม่ใช่การใช้บัญชีส่วนตัวของคุณโดยอัตโนมัติ: Discord ห้ามใช้บอทส่วนตัวและอาจปิดบัญชีได้ สร้างแอปพลิเคชันและบอทใน Developer Portal เปิดใช้งานเฉพาะสิทธิ์ที่จำเป็นที่บริดจ์ต้องการและแอปของคุณสามารถเข้าถึงได้ จากนั้นเชิญด้วยขอบเขตบอท OAuth2 และสิทธิ์ช่องขั้นต่ำ การเข้าถึงสิทธิ์นั้นถูกควบคุมโดยนโยบาย หากไม่มีเนื้อหาข้อความหรือสิทธิ์การเข้าถึงสมาชิกที่จำเป็น ฟังก์ชันบางอย่างอาจใช้งานไม่ได้ ใน Matrix ให้ส่งข้อความส่วนตัว@discordbot:your.serverและทำตามคำแนะนำการเข้าสู่ระบบโทเค็นบอทของ mautrix-discord บอทไม่ได้ให้สิทธิ์การเข้าถึงข้อความส่วนตัวแบบเดียวกับบริดจ์บัญชีผู้ใช้

โปรแกรมแก้ไขการกำหนดค่าบริดจ์ที่แสดงที่อยู่บริการ Synapse ที่อยู่บริการ mautrix-whatsapp และชื่อฐานข้อมูลบริดจ์ที่ไม่ซ้ำกัน
ตรวจสอบชื่อโฮสต์ของบริการ ตัวรับฟังของบริดจ์ และรายละเอียดฐานข้อมูลเฉพาะในไฟล์การกำหนดค่าของบริดจ์แต่ละตัว

4. ทดสอบการส่งมอบ จากนั้นปรับแต่งเฉพาะสิ่งที่ผลลัพธ์แสดงให้เห็น

ส่งข้อความส่วนตัว (DM) ไปยังบอทเชื่อมต่อแต่ละตัวและยืนยันสถานะการเข้าสู่ระบบ ในห้องพอร์ทัลหนึ่งห้องต่อบริการ ให้ส่งข้อความทดสอบจาก Matrix และตอบกลับจากแอประยะไกล ตรวจสอบว่าทั้งสองข้อความมาถึงในห้องที่ถูกต้อง สำหรับกลุ่มหรือช่อง Discord ให้ตรวจสอบก่อนว่าบัญชีเชื่อมต่อมีอยู่และมีสิทธิ์อ่าน/โพสต์ การเข้าสู่ระบบสำเร็จเพียงอย่างเดียวไม่ได้พิสูจน์ว่าข้อความส่งถึงแล้ว

หากบอทเงียบ ให้ตรวจสอบบันทึก (log) ของบอทเพื่อหาค่าที่หายไป ข้อผิดพลาดของฐานข้อมูล หรือการเชื่อมต่อกับเซิร์ฟเวอร์หลัก หากการเข้าสู่ระบบใช้งานได้ แต่ห้องไม่ปรากฏ ให้ตรวจสอบการตั้งค่าพอร์ทัลและการเติมข้อมูลย้อนหลัง สำหรับข้อความในช่อง Discord ที่หายไป ให้ตรวจสอบการเป็นสมาชิกของบอท สิทธิ์ และการเข้าถึงตามเจตนา หาก Synapse ไม่สามารถเริ่มต้นได้ ให้ตรวจสอบการเยื้องของ YAML และการเมานต์ไฟล์ลงทะเบียนที่อ่านได้

การรองรับฟีเจอร์ต่างๆ จะแตกต่างกันไปตามเวอร์ชันของบริดจ์และประเภทบัญชี การโทร การตอบกลับ การแชทที่เข้ารหัส สื่อ และการนำเข้าประวัติอาจแตกต่างกันหรืออาจไม่รองรับ ตรวจสอบรายการฟีเจอร์ปัจจุบันของแต่ละบริดจ์ก่อนที่จะใช้เป็นจุดเชื่อมต่อเพียงจุดเดียว จำกัดการเข้าถึงไฟล์การลงทะเบียนและข้อมูลประจำตัว สำรองข้อมูลบริดจ์อย่างปลอดภัย และยกเลิกเซสชันหรือโทเค็นที่เชื่อมโยงหากมีการรั่วไหล

โปรดใช้คำแนะนำ การ ใช้ งาน Docker ของ mautrixในปัจจุบันคู่มือการลงทะเบียน ข้อมูลอ้างอิงการกำหนดค่าและ หน้าการตรวจสอบสิทธิ์ของ WhatsApp , TelegramและDiscordสำหรับคำสั่งเฉพาะเวอร์ชัน ตรวจสอบนโยบายบอทอัตโนมัติ ของ Discord ด้วย

ฝากความเห็น

เพิ่มขีดจำกัดไฟล์ Systemd ของ Synapse โดยไม่ต้องคาดเดา

เพิ่มขีดจำกัดไฟล์ Systemd ของ Synapse โดยไม่ต้องคาดเดา

ตรวจสอบว่า Synapse ถึงขีดจำกัดการเปิดไฟล์ต่อกระบวนการแล้วหรือไม่ ตั้งค่า systemd drop-in สำหรับบริการหรือ worker ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์

หากพบข้อความ “ถอดรหัสไม่สำเร็จ” ให้กู้คืนรหัสห้องที่หายไป

หากพบข้อความ “ถอดรหัสไม่สำเร็จ” ให้กู้คืนรหัสห้องที่หายไป

ตรวจสอบว่าข้อผิดพลาดนั้นเกิดขึ้นเฉพาะกับเบราว์เซอร์เดียวหรือเหตุการณ์เดียวหรือไม่ จากนั้นใช้รหัสกู้คืนของ Element หรืออุปกรณ์ที่เชื่อถือได้โดยไม่ต้องเสี่ยงกับประวัติการเข้ารหัสที่เหลืออยู่ของคุณ

ล้างข้อความและไฟล์มีเดียเก่าๆ ของ Synapse โดยไม่สูญเสียข้อมูล

ใช้ API สำหรับล้างประวัติและสื่อของ Synapse หรือการตั้งค่าการเก็บรักษาข้อมูลเพื่อลบข้อมูลที่ล้าสมัยอย่างปลอดภัย จากนั้นตรวจสอบความสมบูรณ์และการกู้คืนพื้นที่ดิสก์

สร้างบอท Matrix Echo ในภาษา Python โดยใช้ Simple-Matrix-Bot-Lib

สร้างบอท Matrix Echo ในภาษา Python โดยใช้ Simple-Matrix-Bot-Lib

ติดตั้งไลบรารีเวอร์ชันปัจจุบัน เชื่อมต่อบัญชี Matrix เฉพาะ และเรียกใช้บอท !echo ขนาดเล็กที่มีการจัดการข้อมูลประจำตัวที่ปลอดภัยยิ่งขึ้นและการทดสอบที่ชัดเจน

เชื่อมต่อ Matrix กับ WhatsApp, Telegram และ Discord ด้วยบริดจ์แยกต่างหาก

เชื่อมต่อ Matrix กับ WhatsApp, Telegram และ Discord ด้วยบริดจ์แยกต่างหาก

ตั้งค่าบริดจ์ Mautrix สามตัว โดยแยกการลงทะเบียน การเข้าสู่ระบบ และการทดสอบออกจากกัน เพื่อหลีกเลี่ยงปัญหาที่อาจเกิดขึ้นจากการเชื่อมต่อเครือข่าย Docker นโยบายบัญชี และการซิงค์ข้อมูล

เรียกคืนพื้นที่ดิสก์ Synapse Media โดยไม่ทำให้ไฟล์ที่แชร์เสียหาย

ค้นหาสิ่งที่กำลังทำให้พื้นที่เก็บข้อมูลของ Synapse เต็ม ตั้งค่าการเก็บรักษาข้อมูลสื่ออย่างปลอดภัย และล้างแคชระยะไกลโดยไม่ต้องลบไฟล์โดยตรงจากดิสก์

ปิดใช้งานผู้ใช้ Matrix ที่ไม่ได้ใช้งานโดยไม่ต้องลบประวัติห้อง

ปิดใช้งานผู้ใช้ Matrix ที่ไม่ได้ใช้งานโดยไม่ต้องลบประวัติห้อง

ตรวจสอบกิจกรรมของอุปกรณ์ ปิดใช้งานบัญชี Synapse ที่ได้รับการยืนยันว่าไม่ได้ใช้งานผ่านทาง Admin API และเรียนรู้ว่าตัวเลือก "ลบข้อมูล" นั้นลบอะไรออกไปบ้าง

ลดภาระการใช้หน่วยความจำของ PostgreSQL ใน Matrix Synapse

ตรวจสอบว่าหน่วยความจำของ PostgreSQL มาจากงานประมวลผลคำสั่งค้นหา บัฟเฟอร์ที่ใช้ร่วมกัน การเชื่อมต่อ หรือการบำรุงรักษา จากนั้นทำการเปลี่ยนแปลงที่ปลอดภัยต่อการใช้งาน Synapse ตามเป้าหมาย

เหตุใดการเข้าร่วมห้องสนทนา Matrix Synapse จึงช้า และควรตรวจสอบอะไรบ้าง

เหตุใดการเข้าร่วมห้องสนทนา Matrix Synapse จึงช้า และควรตรวจสอบอะไรบ้าง

ตรวจสอบการเข้าร่วมห้อง Matrix ที่ช้าไปยังโฮมเซิร์ฟเวอร์ระยะไกลเครื่องใดเครื่องหนึ่ง การหน่วงเวลาของเฟเดอเรชัน การโหลดฐานข้อมูลภายใน หรือคิวผู้ส่งขาออก ก่อนที่จะเปลี่ยนการตั้งค่า Synapse

ปิดการลงทะเบียนผ่าน Matrix หรือกำหนดให้ต้องใช้โทเค็นเชิญบน Synapse

หยุดการสร้างบัญชีแบบเปิดบนเซิร์ฟเวอร์ Synapse ที่โฮสต์เอง หรือจำกัดการลงทะเบียนเฉพาะผู้ได้รับเชิญเท่านั้น โดยใช้โทเค็นการลงทะเบียนที่มีจำนวนการใช้งานจำกัด