วิธีตั้งค่า Matrix Sliding Sync เพื่อการโหลดบนมือถือที่เร็วขึ้น (โดยไม่ต้องใช้พร็อกซีแบบเดิม)

อัปเดต 6 ตุลาคม 2026:พร็อกซี Matrix Sliding Sync แบบสแตนด์อโลนนั้นไม่ใช่ส่วนประกอบที่เหมาะสมสำหรับการติดตั้งอีกต่อไปแล้ว Matrix.org ได้เก็บmatrix-org/sliding-syncถาวรคลังเก็บข้อมูลของตนในเดือนพฤศจิกายน 2025 เนื่องจากได้ใช้ API MSC3575 รุ่นเก่า ซึ่งถูกแทนที่ด้วย Simplified Sliding Sync (MSC4186) แล้ว Synapse ได้รองรับการใช้งานแบบเนทีฟมาตั้งแต่เวอร์ชัน 1.114 โดยเปิดใช้งานการสนับสนุนโดยค่าเริ่มต้น ในเดือนกรกฎาคม 2026 ทีมงานหลักของข้อกำหนด Matrix ได้ยอมรับข้อเสนอหลักของ MSC4186 แล้ว ส่วนข้อเสนอส่วนขยายที่เกี่ยวข้องยังคงเป็นงานแยกต่างหาก

สำหรับการใช้งาน Synapse บนมือถือในยุคปัจจุบัน การตั้งค่าที่เหมาะสมคือการใช้ Synapse เวอร์ชันล่าสุด ตรวจสอบให้แน่ใจว่ามีการรองรับ Sliding Sync อย่างถูกต้อง ตรวจสอบให้แน่ใจว่า Reverse Proxy ส่งผ่านเส้นทาง API ของไคลเอนต์ Matrix โดยไม่เปลี่ยนแปลง และใช้ไคลเอนต์มือถือที่เข้ากันได้ ไม่จำเป็นต้องใช้คอนเทนเนอร์พร็อกซี ฐานข้อมูลพร็อกซี และ URL การค้นหาพร็อกซีแบบเก่าอีกต่อไป

คุณยังควรติดตั้งโปรแกรมพร็อกซี Sliding Sync แบบแยกต่างหากอยู่หรือไม่?

ไม่ ไม่รองรับการใช้งานใหม่สำหรับแอปพลิเคชันมือถือ Matrix รุ่นปัจจุบัน พร็อกซีที่เก็บไว้ในคลังนั้นใช้มาตรฐาน MSC3575 ไม่ใช่ MSC4186 รุ่นใหม่กว่า โครงการเองก็ระบุว่าไม่ได้มีการดูแลรักษาอีกต่อไป และแอปพลิเคชันมือถือ Matrix รุ่นใหม่ๆ จะไม่สามารถใช้งานร่วมกับมันได้อีกต่อไป นอกจากนี้ Matrix.org ยังประกาศการเปลี่ยนไปใช้การรองรับแบบเนทีฟและการลบการรองรับพร็อกซี MSC3575 ออกจาก Element X ในเดือนมกราคม 2025 ด้วย

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

มีอะไรเปลี่ยนแปลงไปบ้าง และสิ่งนี้หมายความอย่างไรต่อผู้ใช้โทรศัพท์มือถือ?

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

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

คุณต้องเตรียมอะไรบ้างก่อนเปิดใช้งาน?

• คู่มือนี้กล่าวถึงโฮมเซิร์ฟเวอร์ Matrix ที่ใช้งาน Synapse โดยไม่ได้หมายความว่า Dendrite, Conduit หรือโฮมเซิร์ฟเวอร์อื่นๆ จะมีการใช้งาน Synapse ในรูปแบบเดียวกันเสมอไป
• Synapse เวอร์ชันที่ได้รับการดูแลรักษาอย่างต่อเนื่อง เวอร์ชัน 1.114 ได้เพิ่มการรองรับ MSC4186 แบบเนทีฟ แต่ควรใช้เวอร์ชันที่ได้รับการสนับสนุนในปัจจุบันแทนที่จะถือว่าเวอร์ชัน 1.114 เป็นคำแนะนำด้านความปลอดภัยหรือการบำรุงรักษา
• แอปพลิเคชันไคลเอ็นต์บนมือถือที่รองรับ Simplified Sliding Sync โฮมเซิร์ฟเวอร์ที่มีประสิทธิภาพไม่สามารถทำให้ไคลเอ็นต์รุ่นเก่าใช้งาน API ที่โฮมเซิร์ฟเวอร์ไม่ได้รองรับได้
• การตั้งค่าเอนด์พอยต์ไคลเอ็นต์ HTTPS และรีเวิร์สพร็อกซีที่ใช้งานได้สำหรับโฮมเซิร์ฟเวอร์
• ควรสำรองข้อมูลฐานข้อมูลและการกำหนดค่าล่าสุดก่อนทำการอัปเกรดหรือเปลี่ยนแปลงเส้นทางการกำหนดเส้นทางเซิร์ฟเวอร์

คุณจะตรวจสอบได้อย่างไรว่า Synapse ได้ประกาศใช้งาน Sliding Sync แบบเนทีฟแล้วหรือไม่?

สอบถามเอนด์พอยต์เวอร์ชัน API ไคลเอ็นต์-เซิร์ฟเวอร์สาธารณะจากเทอร์มินัล แทนที่โฮสต์ตัวอย่างด้วย URL พื้นฐานสาธารณะที่ไคลเอ็นต์ Matrix ของคุณใช้:

curl -fsS https://matrix.example.org/_matrix/client/versions   | jq -r '.unstable_features["org.matrix.simplified_msc3575"]'

การตอบสนองที่เป็นtrueหมายความว่าเซิร์ฟเวอร์กำลังโฆษณาฟีเจอร์แฟล็ก Simplified Sliding Sync ดั้งเดิม การตอบสนองที่เป็นfalse, null, หรือคีย์ที่หายไป หมายความว่าคุณควรตรวจสอบเวอร์ชันและการกำหนดค่าของ Synapse ก่อนทดสอบไคลเอ็นต์ หากjqไม่ได้ติดตั้ง ให้ขอ URL เดียวกันในเบราว์เซอร์ หรือเรียกใช้curl -fsS https://matrix.example.org/_matrix/client/versionsและตรวจสอบการตอบสนอง JSON

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

จะเปิดใช้งานการรองรับเนทีฟใน Synapse ได้อย่างไร?

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

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

experimental_features:
  msc3575_enabled: true

ควรเพิ่มหรือเปลี่ยนแปลงการตั้งค่านี้หลังจากตรวจสอบเอกสารการกำหนดค่าสำหรับเวอร์ชัน Synapse ที่ติดตั้งไว้แล้วเท่านั้น สำรองข้อมูลhomeserver.yamlรักษาบล็อกที่มีอยู่ส่วนที่เหลือexperimental_featuresและรักษาการเยื้องของ YAML ให้สอดคล้องกัน ตรวจสอบความถูกต้องของไฟล์โดยใช้คำสั่งตรวจสอบความถูกต้องของการกำหนดค่าของ Synapse สำหรับการติดตั้งของคุณ จากนั้นรีสตาร์ท Synapse ผ่านตัวจัดการบริการหรือวิธีการจัดการคอนเทนเนอร์ที่คุณใช้อยู่แล้ว ตรวจสอบอีกครั้ง/_matrix/client/versionsหลังจากนั้น

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

พร็อกซีแบบย้อนกลับของคุณจำเป็นต้องใช้เส้นทาง Sliding Sync พิเศษหรือไม่?

โดยปกติแล้วไม่ใช่ Native Sliding Sync ใช้เส้นทาง API ไคลเอ็นต์-เซิร์ฟเวอร์ของ Matrix ภายใต้/_matrix/clientดังนั้นพร็อกซีแบบย้อนกลับที่มีอยู่ของคุณควรส่งต่อเนมสเปซ API ไคลเอ็นต์ของ Matrix ไปยัง Synapse คู่มือพร็อกซีแบบย้อนกลับอย่างเป็นทางการของ Synapse ระบุให้ส่งต่อ/_matrixและ/_synapse/clientรักษา URI ของคำขอไว้แทนที่จะทำการแปลงเป็นรูปแบบมาตรฐานหรือทำให้เป็นปกติ

ตรวจสอบกฎพร็อกซีของคุณ หาก/_matrix/client/versionsใช้งานได้แต่แอปที่เข้ากันได้ไม่สามารถซิงค์ได้ ยืนยันว่าคำขอเข้าถึง/_matrix/client/unstable/org.matrix.simplified_msc3575/Synapse และไม่ได้ถูกส่งไปยังพร็อกซี MSC3575 ที่เหลืออยู่ ถูกบล็อกโดยไฟร์วอลล์แอปพลิเคชันเว็บ หรือถูกเขียนทับโดยกฎเส้นทาง หาก Synapse ทำงานอยู่เบื้องหลังพร็อกซี ให้คงส่วนหัว forwarded-protocol และ client-IP ที่ถูกต้องตามที่อธิบายไว้ในเอกสารของ Synapse

อย่าสร้างorg.matrix.msc3575.proxyรายการ ใหม่ /.well-known/matrix/clientเพื่อรองรับระบบเนทีฟ คีย์นั้นเป็นการโฆษณา API พร็อกซีที่เลิกใช้งานแล้ว หากคุณเคยเพิ่มไว้ในไฟล์ JSON ที่รู้จักกันดีแบบคงที่หรือใน Synapse extra_well_known_client_contentให้ลบเฉพาะคุณสมบัติพร็อกซีแบบเก่าออกหลังจากตรวจสอบแล้วว่าไม่มีไคลเอ็นต์รุ่นเก่าใดที่จำเป็นต้องใช้คุณสมบัตินั้น เก็บข้อมูลการค้นหาโฮมเซิร์ฟเวอร์ตามปกติไว้ให้ครบถ้วน

คุณควรย้ายการติดตั้งพร็อกซีที่มีอยู่แล้วอย่างไร?

1. บันทึกเวอร์ชัน Synapse ปัจจุบัน เวอร์ชันไคลเอ็นต์ URL พร็อกซี เส้นทางรีเวิร์สพร็อกซี และตำแหน่งฐานข้อมูลและข้อมูลลับของพร็อกซีเก่า
2. สำรองข้อมูลฐานข้อมูลโฮมเซิร์ฟเวอร์ การกำหนดค่า และฐานข้อมูลพร็อกซี เก็บรักษาข้อมูลสำรองเหล่านั้นไว้จนกว่าการเข้าสู่ระบบและการซิงค์ข้อมูลของไคลเอ็นต์ดั้งเดิมได้รับการตรวจสอบเรียบร้อยแล้ว
3. หาก Synapse เวอร์ชันเก่ากว่า 1.114 ให้อัปเกรดตามขั้นตอนการเผยแพร่ที่ระบุไว้ จากนั้นตรวจสอบว่าแฟล็กความสามารถดั้งเดิมกลับมาใช้งานได้แล้วหรือtrueไม่
4. อัปเดตแอปพลิเคชันบนมือถือเป็นเวอร์ชันที่รองรับ Simplified Sliding Sync โดยตรง ทำตามคำแนะนำในการย้ายข้อมูลหรือเข้าสู่ระบบใหม่ในแอป บางเซสชันที่มีอยู่แล้วอาจต้องเข้าสู่ระบบอีกครั้งเพื่อเปลี่ยนจากโปรโตคอลเก่า
5. ลบโฆษณาพร็อกซีที่เลิกใช้งานแล้ว และกำหนดเส้นทาง API ไคลเอ็นต์ Matrix ไปยัง Synapse โหลดพร็อกซีแบบย้อนกลับใหม่และตรวจสอบการกำหนดค่าก่อนนำไปใช้งาน
6. ทดสอบด้วยบัญชีผู้ใช้และอุปกรณ์มือถือเพียงเครื่องเดียวก่อน ตรวจสอบการเข้าสู่ระบบ การโหลดรายชื่อห้อง การเปิดห้องเข้ารหัส การส่งและรับข้อความ และการเชื่อมต่อใหม่หลังจากเปลี่ยนเครือข่าย
7. หลังจากที่การทดสอบประสบความสำเร็จสำหรับลูกค้าที่คุณดูแลแล้ว ให้หยุดการทำงานของพร็อกซีแบบเก่า เก็บสำเนาสำรองฐานข้อมูลไว้ตามระยะเวลาที่ตกลงกันไว้สำหรับการย้อนกลับข้อมูล ลบข้อมูลเก่าก็ต่อเมื่อคุณยืนยันแล้วว่าไม่จำเป็นอีกต่อไป

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

คุณจะรู้ได้อย่างไรว่าการโหลดบนมือถือดีขึ้นแล้ว?

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

หากไคลเอ็นต์ยังคงทำการ/syncร้องขอตามปกติและไม่เคยโฆษณาหรือพยายามใช้การสนับสนุนแบบเนทีฟ ให้ตรวจสอบเวอร์ชันไคลเอ็นต์และการตั้งค่าการซิงโครไนซ์ของไคลเอ็นต์เอง หากมีการร้องขอปลายทางแบบง่ายแต่ได้รับข้อผิดพลาด ให้ตรวจสอบบันทึกของ Synapse และพร็อกซีแบบย้อนกลับสำหรับการร้องขอนั้น ตรวจสอบสถานะของฐานข้อมูลและภาระงานของเซิร์ฟเวอร์หากผู้ใช้จำนวนมากรายงานว่าโหลดช้า Sliding Sync สามารถลดงานการซิงโครไนซ์ได้ แต่ไม่สามารถชดเชยฐานข้อมูลที่โอเวอร์โหลดหรือการร้องขอ API ที่ส่งผิดเส้นทางได้

ตัวเลือกการตั้งค่าหลักมีอะไรบ้าง?

แหล่งที่มาและหมายเหตุเกี่ยวกับเวอร์ชัน

ที่เก็บพร็อกซีแบบสแตนด์อโลนถูกเก็บถาวรแล้ว การใช้งานดั้งเดิมของ Synapse มีมาตั้งแต่ Synapse เวอร์ชัน 1.114 ทีมหลักของข้อกำหนด Matrix ได้ยอมรับข้อเสนอหลัก MSC4186 ในเดือนกรกฎาคม 2026 ในขณะที่ส่วนขยายที่เกี่ยวข้องยังคงแยกจากกัน Synapse ไคลเอนต์มือถือ และข้อกำหนด Matrix ยังคงมีการพัฒนาอย่างต่อเนื่อง ดังนั้นโปรดตรวจสอบเอกสารและบันทึกการเผยแพร่สำหรับเวอร์ชันที่คุณใช้งานอย่างถูกต้อง

• คลังเก็บข้อมูลพร็อกซี Sliding Sync ที่เก็บถาวร และบันทึกการตั้งค่าแบบเก่า
• Matrix.org: ยุติการใช้งานพร็อกซีและเริ่มใช้การสนับสนุนแบบเนทีฟ
• Matrix.org: การซิงค์แบบเลื่อนที่เรียบง่ายในตัวใน Synapse 1.114
• บันทึกการเปลี่ยนแปลงของ Synapse: เปิดใช้งานการรองรับ MSC4186 เป็นค่าเริ่มต้นในเวอร์ชัน 1.114
• เอกสารประกอบการใช้งาน Synapse: การกำหนดเส้นทางพร็อกซีแบบย้อนกลับและการจัดการ URI
• Matrix.org: การตอบรับ MSC4186 และงานที่เหลือในการต่อเติม