กู้คืน Matrix Synapse อย่างปลอดภัยด้วยการสำรองข้อมูล PostgreSQL
สำรองข้อมูล Synapse ด้วย pg_dump ป้องกันคีย์ลงนามและสื่อบันทึกข้อมูล และกู้คืนลงในฐานข้อมูล PostgreSQL ที่สะอาดโดยไม่ใช้คีย์แบบใช้ครั้งเดียวที่หมดอายุแล้ว
สำหรับแอปพลิเคชันมือถือ Matrix รุ่นปัจจุบัน อย่าเพิ่ม Sliding Sync Proxy แบบสแตนด์อโลนรุ่นเก่าลงใน Docker Compose Proxy ดังกล่าวถูกเก็บถาวรไปแล้วในเดือนพฤศจิกายน 2025 Synapse ให้บริการ Simplified Sliding Sync ในตัวอยู่แล้ว โดยเปิดใช้งานเป็นค่าเริ่มต้นตั้งแต่ Synapse เวอร์ชัน 1.114 โปรดอัปเดต Synapse เป็นเวอร์ชันที่รองรับ ตรวจสอบว่าฟังก์ชันการทำงานแบบเนทีฟนี้เข้าถึงไคลเอ็นต์ผ่าน URL สาธารณะของคุณได้หรือไม่ และวัดปริมาณการโหลดบนไคลเอ็นต์ที่รองรับฟังก์ชันนี้
“Sliding Sync” เดิมทีหมายถึงการใช้งานพร็อกซีของ MSC3575 ซึ่งทำงานอยู่ด้านหน้า Synapse และต้องการบริการและการตั้งค่าการค้นหาแยกต่างหาก ต่อมาข้อกำหนดของ Matrix ได้พัฒนาขึ้น โดย MSC4186 หรือ Simplified Sliding Sync ได้เข้ามาแทนที่การออกแบบนั้นคลังเก็บพร็อกซีอย่างเป็นทางการถูกเก็บถาวรไปแล้ว และระบุว่าไคลเอนต์รุ่นใหม่ไม่จำเป็นต้องใช้งานร่วมกับมันอีกต่อไป Synapse ได้เพิ่มการสนับสนุนแบบเนทีฟสำหรับ MSC3575 และ MSC4186 และเปิดใช้งานโดยค่าเริ่มต้นตั้งแต่เวอร์ชัน 1.114.0 เป็นต้นไป ตามที่บันทึกไว้ในบันทึกการเปลี่ยนแปลงของ Synapse
คู่มือนี้สมมติว่า Synapse ทำงานร่วมกับ Docker Compose อยู่แล้ว โดยอยู่เบื้องหลัง URL HTTPS สาธารณะ เช่นhttps://matrix.example.orgคุณต้องมีสิทธิ์เข้าถึงเชลล์ของโปรเจกต์ Compose วิธีแก้ไขแท็กรูปภาพและการกำหนดค่าโฮมเซิร์ฟเวอร์ และแอปมือถือเวอร์ชันปัจจุบันที่รองรับ Sliding Sync หากคุณต้องการเพียงแค่การโหลดเริ่มต้นที่เร็วขึ้นในไคลเอนต์ที่ไม่รองรับ การเพิ่มพร็อกซีจะไม่ทำให้ไคลเอนต์นั้นใช้คุณสมบัตินี้
ควรใช้ Synapse เวอร์ชันที่ได้รับการดูแลรักษาอย่างต่อเนื่อง แทนที่จะเลือกใช้เวอร์ชันที่มีฟีเจอร์ขั้นต่ำตามประวัติศาสตร์ ตรวจสอบเวอร์ชัน Synapse อย่างเป็นทางการ และบันทึกการอัปเกรดสำหรับเวอร์ชันที่คุณกำลังจะอัปเกรดจาก สำรองข้อมูลฐานข้อมูลและไดรฟ์ข้อมูล/การกำหนดค่า Synapse ก่อนทำการอัปเกรด และตรวจสอบว่าบันทึกการอัปเกรดระบุขั้นตอนการอัปเกรดระหว่างกลางหรือไม่ เรื่องนี้สำคัญอย่างยิ่งสำหรับการติดตั้งเก่า: คำแนะนำด้านความปลอดภัยของ Synapse เกี่ยวกับการเปิดเผยสถานะห้อง Sliding Syncระบุเวอร์ชันที่ได้รับผลกระทบจนถึง v1.120.0 และแก้ไขใน v1.120.1 เลือกเวอร์ชันที่ได้รับการสนับสนุนในปัจจุบันที่มีการแก้ไขล่าสุด ไม่ใช่เพียงเวอร์ชันที่ได้รับการแก้ไขครั้งแรกเท่านั้น
ในไฟล์ Compose ของคุณ ให้ระบุคีย์บริการสำหรับ Synapse และแท็กรูปภาพที่ใช้ หากแท็กถูกกำหนดไว้กับเวอร์ชันเก่า ให้เปลี่ยนเป็นเวอร์ชันที่รองรับที่คุณเลือกไว้ จากนั้นดึงและสร้างบริการนั้นขึ้นมาใหม่เพียงอย่างเดียวsynapseหากบริการของคุณมีชื่ออื่น ให้แทนที่ข้อมูลด้านล่าง:

docker compose pull synapse

docker compose up -d synapse
docker compose logs --tail=100 synapse
ตรวจสอบบันทึกข้อผิดพลาดในการเริ่มต้นระบบและการอัปเกรดฐานข้อมูลที่เสร็จสมบูรณ์ก่อนดำเนินการต่อ อย่าทำการดาวน์เกรดโดยไม่ตรวจสอบข้อมูลหากการเริ่มต้นระบบล้มเหลว โปรดศึกษาคำแนะนำในการอัปเกรดเฉพาะเวอร์ชันและกู้คืนข้อมูลสำรองโดยใช้กระบวนการกู้คืนที่เหมาะสมกับฐานข้อมูลของคุณเท่านั้น
โดยปกติ Synapse จะเปิดใช้งาน Sliding Sync แบบเนทีฟโดยค่าเริ่มต้น ดังนั้นการติดตั้งใหม่จึงมักไม่จำเป็นต้องใช้ไฟล์ YAML เพิ่มเติม การตั้งค่านี้ยังคงใช้ชื่อ MSC เดิม ซึ่งอาจทำให้สับสนได้: มันควบคุมการใช้งานแบบเนทีฟของ Synapse และไม่ใช่การร้องขอให้เรียกใช้พร็อกซีที่เลิกใช้งานแล้ว ตรวจสอบการตั้งค่าที่มีอยู่ของคุณhomeserver.yamlว่ามีค่าเป็น false อย่างชัดเจนหรือไม่ หากพบ ให้เปลี่ยนในบล็อกคุณสมบัติที่มีอยู่:

experimental_features:
msc3575_enabled: true
หากexperimental_featuresมีอยู่แล้ว ให้แก้ไขบล็อกนั้นแทนการเพิ่มคีย์ YAML ที่ซ้ำกัน หากไม่มีการตั้งค่าหรือตั้งค่าเป็นจริงอยู่แล้ว ให้ปล่อยไว้เช่นเดิม สร้างบริการ Synapse ขึ้นใหม่หลังจากเปลี่ยนแปลงการกำหนดค่าและตรวจสอบบันทึก การผิดพลาดเกี่ยวกับการเยื้องใน YAML อาจทำให้ Synapse ไม่สามารถเริ่มต้นได้
ตรวจสอบ JSON ที่ให้บริการที่https://matrix.example.org/.well-known/matrix/client. หากมีorg.matrix.msc3575.proxyคุณสมบัติเก่าอยู่ ให้ลบคุณสมบัตินั้นออกโดยคงรายการค้นหาไคลเอ็นต์ที่ไม่เกี่ยวข้องไว้ นอกจากนี้ ให้ลบกฎพร็อกซีแบบย้อนกลับใดๆ ที่ส่งคำขอไคลเอ็นต์ Matrix ไปยังพร็อกซีที่เลิกใช้งานแล้ว/_matrix/client/เส้นทาง API มาตรฐานต้องเข้าถึง Synapse ได้ อย่าเพิ่มพอร์ตพร็อกซีใหม่หรือประกาศ URL พร็อกซีสำหรับ MSC4186 ดั้งเดิม เก็บค่าอื่นๆ ที่ทราบทั้งหมดไว้ รวมถึง URL โฮมเซิร์ฟเวอร์ของคุณ ตามที่การตั้งค่าของคุณต้องการ
จากเครื่องที่สามารถเข้าถึงโฮมเซิร์ฟเวอร์สาธารณะได้ ให้สอบถามเอนด์พอยต์เวอร์ชันไคลเอ็นต์-เซิร์ฟเวอร์ การตรวจสอบนี้จะตรวจสอบบริการที่ไคลเอ็นต์ค้นพบจริง ๆ แทนที่จะตรวจสอบเฉพาะคอนเทนเนอร์บนเครือข่าย Docker ส่วนตัวเท่านั้น:

curl -fsS https://matrix.example.org/_matrix/client/versions | jq '.unstable_features["org.matrix.simplified_msc3575"]'
สำหรับ Synapse เวอร์ชันที่มีการเปิดใช้งานการสนับสนุนแบบเนทีฟและปลายทางที่กำหนดเส้นทางอย่างถูกต้อง ควรแสดงผลลัพธ์ดังนี้trueหากjqไม่สามารถใช้งานได้ ให้เรียกใช้curlคำขอโดยไม่มีเครื่องหมายไปป์ และตรวจสอบฟิลด์ JSON ค่าที่หายไปหรือค่าเท็จเป็นสัญญาณบ่งชี้ข้อผิดพลาดที่มีประโยชน์: ตรวจสอบว่า DNS และ HTTPS เข้าถึงเซิร์ฟเวอร์ที่คาดหวังได้หรือไม่ ว่าพร็อกซีแบบย้อนกลับส่งผ่านเส้นทาง API ของไคลเอ็นต์ไปยัง Synapse ว่าอิมเมจที่ใช้งานอยู่เป็นเวอร์ชันที่คุณเลือก และไม่มีการกำหนดค่าใด ๆ ที่ปิดใช้งานคุณสมบัตินี้โดยชัดแจ้ง อย่าเปิดเผยโทเค็นการเข้าถึงเมื่อแชร์เอาต์พุตการวินิจฉัย คำขอเวอร์ชันสาธารณะนี้ไม่จำเป็นต้องมีโทเค็นการเข้าถึง
ลงชื่อเข้าใช้หรือเชื่อมต่อใหม่ด้วยเวอร์ชันไคลเอ็นต์ที่รองรับโปรโตคอลดั้งเดิม โดยใช้บัญชีและโทรศัพท์เครื่องเดียวกับที่คุณจะใช้ในการเปรียบเทียบ บันทึกค่าพื้นฐานก่อนเปลี่ยนเซิร์ฟเวอร์หากเป็นไปได้ เปรียบเทียบการเริ่มต้นแอปแบบเย็นหลังจากล้างหรือสร้างข้อมูลแอปในเครื่องใหม่เฉพาะเมื่อคุณเข้าใจว่าการทำเช่นนี้จะลบเนื้อหาที่แคชไว้ จากนั้นเปรียบเทียบการเริ่มต้นแบบอุ่นตามปกติและการเชื่อมต่อใหม่หลังจากที่โทรศัพท์ออฟไลน์ รักษาเครือข่าย บัญชี ชุดห้อง และวิธีการทดสอบให้สม่ำเสมอ
การแสดงรายการห้องครั้งแรกที่เร็วขึ้นและการเชื่อมต่อใหม่ที่ราบรื่นหลังจากเชื่อมต่อใหม่ เป็นสัญญาณที่แสดงให้เห็นว่าไคลเอนต์กำลังใช้เส้นทางที่คาดหวังไว้ ไม่มีวิธีใดที่จะเพิ่มความเร็วได้โดยอัตโนมัติ: การใช้งานไคลเอนต์และแคชในเครื่อง ความหน่วงของเครือข่าย ประสิทธิภาพของฐานข้อมูล จำนวนห้องในบัญชี และภาระงานของเซิร์ฟเวอร์ ล้วนส่งผลต่อผลลัพธ์ Sliding Sync ยังไม่เร่งความเร็วในการดาวน์โหลดสื่อหรือซ่อมแซมฐานข้อมูลที่โอเวอร์โหลด หากการตรวจสอบความสามารถผ่าน แต่แอปยังคงทำงานช้า ให้เปรียบเทียบกับไคลเอนต์อื่นที่รองรับ และตรวจสอบปัญหาคอขวดเหล่านั้นก่อนที่จะเปลี่ยนการตั้งค่าพร็อกซีหรือแคช หากคุณยังคงใช้ไคลเอนต์รุ่นเก่าที่ขึ้นอยู่กับพร็อกซี MSC3575 ที่เลิกใช้งานแล้ว ให้ทดสอบความเข้ากันได้แยกต่างหากก่อนที่จะลบเส้นทางการค้นหาเก่า อย่าคิดว่าปลายทางเดียวรองรับไคลเอนต์ทุกรุ่น
สำรองข้อมูล Synapse ด้วย pg_dump ป้องกันคีย์ลงนามและสื่อบันทึกข้อมูล และกู้คืนลงในฐานข้อมูล PostgreSQL ที่สะอาดโดยไม่ใช้คีย์แบบใช้ครั้งเดียวที่หมดอายุแล้ว
ตั้งค่า Mjölnir ด้วยบัญชี Matrix เฉพาะ, ห้องจัดการที่เข้ารหัส, Docker Compose, รายการนโยบาย และการตรวจสอบสิทธิ์
ข้ามขั้นตอนการใช้พร็อกซีที่เลิกใช้งานแล้ว และกำหนดค่า Sliding Sync ที่มีอยู่ใน Synapse ตรวจสอบการค้นหาไคลเอ็นต์ จากนั้นวัดการโหลดรายการห้องและพฤติกรรมการเชื่อมต่อใหม่บนโทรศัพท์ที่ใช้งานร่วมกันได้
ติดตั้ง Element Web เป็นเว็บไซต์แบบคงที่ ชี้ไปยังโฮมเซิร์ฟเวอร์ Matrix ของคุณ เพิ่ม HTTPS และกำหนดค่า Nginx เพื่อให้บริการอัปเดตโดยไม่มีไฟล์เก่าค้างอยู่
ติดตั้ง Conduit บน Raspberry Pi 4 แบบ 64 บิต โดยตั้งค่าให้เก็บข้อมูลถาวร การเชื่อมต่อ HTTPS การลงทะเบียนที่ปลอดภัย และตรวจสอบว่าโฮมเซิร์ฟเวอร์ทำงานได้หรือไม่
กำหนดที่อยู่เว็บไซต์ที่แชร์ได้ง่ายให้กับห้อง Matrix บนโดเมนของคุณโดยใช้ Element หรือ Matrix API พร้อมการตรวจสอบสิทธิ์ การตั้งชื่อ Synapse และการเชื่อมโยงระบบ
กำหนดค่า coturn และ Synapse ด้วยข้อมูลรับรอง TURN ที่ตรงกัน เปิดพอร์ตรีเลย์ที่จำเป็น และตรวจสอบว่าไคลเอ็นต์ Matrix สามารถรับผู้สมัครรีเลย์ได้
ตั้งค่าโฮมเซิร์ฟเวอร์ Synapse แบบถาวรด้วย Docker Compose, PostgreSQL, การกำหนดค่าส่วนตัว และการตรวจสอบต่างๆ ก่อนที่จะเปิดเผยผ่าน HTTPS
กำหนดชื่อแบรนด์ สีที่กำหนดเอง และองค์ประกอบการเข้าสู่ระบบสำหรับการใช้งาน Element Web ของคุณ พร้อมทั้งทำความเข้าใจว่าส่วนใดบ้างที่ยังคงใช้แบรนด์ Element อยู่
ตรวจสอบว่า Synapse ถึงขีดจำกัดการเปิดไฟล์ต่อกระบวนการแล้วหรือไม่ ตั้งค่า systemd drop-in สำหรับบริการหรือ worker ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์