เพิ่มขีดจำกัดไฟล์ Systemd ของ Synapse โดยไม่ต้องคาดเดา
ตรวจสอบว่า Synapse ถึงขีดจำกัดการเปิดไฟล์ต่อกระบวนการแล้วหรือไม่ ตั้งค่า systemd drop-in สำหรับบริการหรือ worker ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์
ในการเชื่อมต่อ WhatsApp, Telegram และ Discord ให้เรียกใช้บริดจ์แยกกันสามตัว ลงทะเบียนแต่ละตัวเป็นบริการแอปพลิเคชัน และลงชื่อเข้าใช้ผ่านขั้นตอนของตนเอง ความสำเร็จหมายความว่าบอทแต่ละตัวรายงานเซสชันที่ได้รับการตรวจสอบสิทธิ์แล้ว และข้อความทดสอบสามารถส่งไปมาได้ทั้งสองทางผ่านห้องพอร์ทัล การที่บอทปรากฏออนไลน์เพียงอย่างเดียวไม่เพียงพอ
นี่สำหรับผู้ดูแลระบบโฮมเซิร์ฟเวอร์ที่อนุญาตให้ใช้งานบริการแอปพลิเคชัน คุณไม่สามารถเพิ่มบริดจ์ที่โฮสต์เองไปยัง matrix.org ได้ เว้นแต่ผู้ดูแลระบบจะจัดหาให้ โปรดใช้เซิร์ฟเวอร์ที่คุณควบคุมหรือบริดจ์ที่โฮสต์อยู่แล้ว เอกสารโครงการได้รับการตรวจสอบเมื่อวันที่ 10 ตุลาคม 2026
นี่คือบริการแยกกันสามอย่าง โดยแต่ละอย่างมีการตั้งค่า การลงทะเบียน ฐานข้อมูล และการเข้าสู่ระบบเป็นของตัวเอง mautrix ใช้การควบคุมแบบหุ่นกระบอกเป็นหลัก: ข้อความจะเดินทางผ่านบัญชีระยะไกลที่เชื่อมโยงของคุณและปรากฏใน Matrix ในฐานะบัญชีนั้น ส่วนบอทรีเลย์นั้นแตกต่างออกไป ควรเลือกใช้เฉพาะเมื่อคุณต้องการใช้ข้อมูลประจำตัวบอทร่วมกันแทนที่จะใช้บัญชีส่วนตัวของคุณ
คุณต้องมีโฮมเซิร์ฟเวอร์ที่รองรับบริการแอปพลิเคชัน สิทธิ์การเข้าถึงของผู้ดูแลระบบ และการเชื่อมต่อเครือข่ายไปยังแต่ละบริดจ์ Docker มีเอกสารอธิบายไว้แล้ว กำหนดไดเร็กทอรีข้อมูลให้กับแต่ละบริดจ์ และเลือกแท็กเวอร์ชันที่ได้รับการดูแลรักษา Mautrix ระบุว่าlatestอาจติดตามการคอมมิตล่าสุดมากกว่าการเผยแพร่
ใช้ฐานข้อมูลแยกต่างหากสำหรับแต่ละบริดจ์ เซิร์ฟเวอร์ PostgreSQL อาจใช้ร่วมกันได้ แต่ฐานข้อมูลนั้นต้องไม่ใช้ร่วมกับบริดจ์อื่นหรือ Synapse SQLite เป็นอีกทางเลือกหนึ่งสำหรับอินสแตนซ์ขนาดเล็ก ตัดสินใจเกี่ยวกับการเข้ารหัสแบบ end-to-bridge ก่อนเข้าสู่ระบบ เนื่องจากเป็นการยากที่จะเปิดใช้งานในภายหลังสำหรับห้องพอร์ทัลที่มีอยู่แล้ว

http://synapse:8008`<homeserver_name>` แอดเดรสบริการแอปพลิเคชันต้องชี้กลับไปยังชื่อบริการและพอร์ตการฟังของบริดจ์นั้น `<homeserver_name>` localhostภายในคอนเทนเนอร์บริดจ์จะชี้ไปยังคอนเทนเนอร์นั้นเอง ไม่ใช่ Synapse หรือบริดจ์อื่น ดังนั้นมักจะทำให้การสื่อสารล้มเหลว หาก homeserver อยู่นอก Docker ให้เผยแพร่หรือกำหนดเส้นทางพอร์ตบริดจ์ที่จำเป็นแทน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 อีกครั้ง


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

ส่งข้อความส่วนตัว (DM) ไปยังบอทเชื่อมต่อแต่ละตัวและยืนยันสถานะการเข้าสู่ระบบ ในห้องพอร์ทัลหนึ่งห้องต่อบริการ ให้ส่งข้อความทดสอบจาก Matrix และตอบกลับจากแอประยะไกล ตรวจสอบว่าทั้งสองข้อความมาถึงในห้องที่ถูกต้อง สำหรับกลุ่มหรือช่อง Discord ให้ตรวจสอบก่อนว่าบัญชีเชื่อมต่อมีอยู่และมีสิทธิ์อ่าน/โพสต์ การเข้าสู่ระบบสำเร็จเพียงอย่างเดียวไม่ได้พิสูจน์ว่าข้อความส่งถึงแล้ว
หากบอทเงียบ ให้ตรวจสอบบันทึก (log) ของบอทเพื่อหาค่าที่หายไป ข้อผิดพลาดของฐานข้อมูล หรือการเชื่อมต่อกับเซิร์ฟเวอร์หลัก หากการเข้าสู่ระบบใช้งานได้ แต่ห้องไม่ปรากฏ ให้ตรวจสอบการตั้งค่าพอร์ทัลและการเติมข้อมูลย้อนหลัง สำหรับข้อความในช่อง Discord ที่หายไป ให้ตรวจสอบการเป็นสมาชิกของบอท สิทธิ์ และการเข้าถึงตามเจตนา หาก Synapse ไม่สามารถเริ่มต้นได้ ให้ตรวจสอบการเยื้องของ YAML และการเมานต์ไฟล์ลงทะเบียนที่อ่านได้
การรองรับฟีเจอร์ต่างๆ จะแตกต่างกันไปตามเวอร์ชันของบริดจ์และประเภทบัญชี การโทร การตอบกลับ การแชทที่เข้ารหัส สื่อ และการนำเข้าประวัติอาจแตกต่างกันหรืออาจไม่รองรับ ตรวจสอบรายการฟีเจอร์ปัจจุบันของแต่ละบริดจ์ก่อนที่จะใช้เป็นจุดเชื่อมต่อเพียงจุดเดียว จำกัดการเข้าถึงไฟล์การลงทะเบียนและข้อมูลประจำตัว สำรองข้อมูลบริดจ์อย่างปลอดภัย และยกเลิกเซสชันหรือโทเค็นที่เชื่อมโยงหากมีการรั่วไหล
โปรดใช้คำแนะนำ การ ใช้ งาน Docker ของ mautrixในปัจจุบันคู่มือการลงทะเบียน ข้อมูลอ้างอิงการกำหนดค่าและ หน้าการตรวจสอบสิทธิ์ของ WhatsApp , TelegramและDiscordสำหรับคำสั่งเฉพาะเวอร์ชัน ตรวจสอบนโยบายบอทอัตโนมัติ ของ Discord ด้วย
ตรวจสอบว่า Synapse ถึงขีดจำกัดการเปิดไฟล์ต่อกระบวนการแล้วหรือไม่ ตั้งค่า systemd drop-in สำหรับบริการหรือ worker ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์
ตรวจสอบว่าข้อผิดพลาดนั้นเกิดขึ้นเฉพาะกับเบราว์เซอร์เดียวหรือเหตุการณ์เดียวหรือไม่ จากนั้นใช้รหัสกู้คืนของ Element หรืออุปกรณ์ที่เชื่อถือได้โดยไม่ต้องเสี่ยงกับประวัติการเข้ารหัสที่เหลืออยู่ของคุณ
ใช้ API สำหรับล้างประวัติและสื่อของ Synapse หรือการตั้งค่าการเก็บรักษาข้อมูลเพื่อลบข้อมูลที่ล้าสมัยอย่างปลอดภัย จากนั้นตรวจสอบความสมบูรณ์และการกู้คืนพื้นที่ดิสก์
ติดตั้งไลบรารีเวอร์ชันปัจจุบัน เชื่อมต่อบัญชี Matrix เฉพาะ และเรียกใช้บอท !echo ขนาดเล็กที่มีการจัดการข้อมูลประจำตัวที่ปลอดภัยยิ่งขึ้นและการทดสอบที่ชัดเจน
ตั้งค่าบริดจ์ Mautrix สามตัว โดยแยกการลงทะเบียน การเข้าสู่ระบบ และการทดสอบออกจากกัน เพื่อหลีกเลี่ยงปัญหาที่อาจเกิดขึ้นจากการเชื่อมต่อเครือข่าย Docker นโยบายบัญชี และการซิงค์ข้อมูล
ค้นหาสิ่งที่กำลังทำให้พื้นที่เก็บข้อมูลของ Synapse เต็ม ตั้งค่าการเก็บรักษาข้อมูลสื่ออย่างปลอดภัย และล้างแคชระยะไกลโดยไม่ต้องลบไฟล์โดยตรงจากดิสก์
ตรวจสอบกิจกรรมของอุปกรณ์ ปิดใช้งานบัญชี Synapse ที่ได้รับการยืนยันว่าไม่ได้ใช้งานผ่านทาง Admin API และเรียนรู้ว่าตัวเลือก "ลบข้อมูล" นั้นลบอะไรออกไปบ้าง
ตรวจสอบว่าหน่วยความจำของ PostgreSQL มาจากงานประมวลผลคำสั่งค้นหา บัฟเฟอร์ที่ใช้ร่วมกัน การเชื่อมต่อ หรือการบำรุงรักษา จากนั้นทำการเปลี่ยนแปลงที่ปลอดภัยต่อการใช้งาน Synapse ตามเป้าหมาย
ตรวจสอบการเข้าร่วมห้อง Matrix ที่ช้าไปยังโฮมเซิร์ฟเวอร์ระยะไกลเครื่องใดเครื่องหนึ่ง การหน่วงเวลาของเฟเดอเรชัน การโหลดฐานข้อมูลภายใน หรือคิวผู้ส่งขาออก ก่อนที่จะเปลี่ยนการตั้งค่า Synapse
หยุดการสร้างบัญชีแบบเปิดบนเซิร์ฟเวอร์ Synapse ที่โฮสต์เอง หรือจำกัดการลงทะเบียนเฉพาะผู้ได้รับเชิญเท่านั้น โดยใช้โทเค็นการลงทะเบียนที่มีจำนวนการใช้งานจำกัด