กู้คืน Matrix Synapse อย่างปลอดภัยด้วยการสำรองข้อมูล PostgreSQL

ใช้รูปแบบการดัมพ์แบบกำหนดเองของ PostgreSQL สำหรับการสำรองฐานข้อมูล Synapse โดยไม่รวมตารางคีย์แบบใช้ครั้งเดียว และกู้คืนลงในฐานข้อมูลว่างที่สร้างขึ้นใหม่ การดัมพ์ฐานข้อมูลเพียงอย่างเดียวไม่ใช่การสำรองข้อมูลโฮมเซิร์ฟเวอร์ที่สมบูรณ์: ต้องเก็บรักษาการกำหนดค่า Synapse คีย์ลงนาม และสื่อในเครื่องไว้ด้วย คำแนะนำการสำรองข้อมูลอย่างเป็นทางการของ Synapse ซึ่งตรวจสอบเมื่อวันที่ 10 ตุลาคม 2026 ได้เตือนไว้อย่างชัดเจนว่าไม่ควรกู้คืนทับตารางที่มีอยู่ และไม่ควรกู้คืนคีย์การเข้ารหัสแบบ end-to-end แบบใช้ครั้งเดียวเก่า

สิ่งที่การสำรองฐานข้อมูลประกอบด้วย และไม่ประกอบด้วย

ตรวจสอบแล้ว: pg_dumpสร้างสแนปช็อตที่สอดคล้องกันในขณะที่ PostgreSQL ยังคงออนไลน์อยู่ Synapse ไม่จำเป็นต้องหยุดทำงานในขณะที่ทำการสำรองข้อมูล การสำรองข้อมูลเฉพาะฐานข้อมูลจะไม่รวมไฟล์จากที่เก็บสื่อของ Synapse homeserver.yamlไฟล์การกำหนดค่าที่อ้างอิง หรือคีย์ลงนามของเซิร์ฟเวอร์ โปรดเก็บไฟล์เหล่านั้นไว้ในชุดสำรองข้อมูลที่ได้รับการป้องกันแยกต่างหาก Synapse จะระบุเนื้อหาที่อัปโหลดในเครื่อง และเมื่อปิดใช้งานภาพขนาดย่อแบบไดนามิก Synapse จะระบุภาพขนาดย่อในเครื่องเป็นข้อมูลที่ต้องเก็บรักษาไว้ โดยทั่วไปแล้วแคชสื่อระยะไกลและแคชแสดงตัวอย่าง URL สามารถดึงหรือสร้างใหม่ได้

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

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

สร้างและตรวจสอบไฟล์ดัมพ์ในรูปแบบที่กำหนดเอง

คำสั่งด้านล่างนี้สมมติว่าโฮสต์เป็น Linux ที่ติดตั้งเครื่องมือบรรทัดคำสั่ง PostgreSQL แล้ว มีฐานข้อมูลชื่อsynapseและมีสิทธิ์ในการเรียกใช้คำสั่ง PostgreSQL ในฐานะpostgresบัญชีระบบปฏิบัติการ แทนที่ชื่อฐานข้อมูลและเส้นทางด้วยค่าที่ใช้ในระบบของคุณ จัดเก็บข้อมูลที่สำรองไว้ในพื้นที่จัดเก็บที่ปลอดภัยและมีพื้นที่ว่างเพียงพอ เนื่องจากอาจมีข้อความส่วนตัวและข้อมูลบัญชีอยู่ด้วย

  1. สร้างไฟล์สำรองข้อมูล โดยไม่รวมเนื้อหาในตารางที่ Synapse ระบุว่าไม่ควรนำกลับมาใช้ใหม่จากไฟล์สำรองข้อมูลเก่า:

    sudo -u postgres pg_dump -Fc --exclude-table-data=e2e_one_time_keys_json synapse > /secure-backups/synapse.dump

    -Fcเลือกใช้รูปแบบการเก็บถาวรแบบกำหนดเองของ PostgreSQL ซึ่งเหมาะสมpg_restoreและมักมีขนาดเล็กกว่า SQL ทั่วไป การยกเว้นนี้มีผลต่อข้อมูลตาราง แต่ไม่ได้ลบคำจำกัดความของตาราง

  2. ตรวจสอบว่าไฟล์มีอยู่จริงและไม่ว่างเปล่า จากนั้นแสดงรายการสารบัญของไฟล์เก็บถาวร:

    ls -lh /secure-backups/synapse.dump
    sudo -u postgres pg_restore --list /secure-backups/synapse.dump

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

ความเข้าใจผิดที่พบบ่อย:จำเป็นต้องหยุด Synapse ทุกครั้งpg_dumpหน้าเว็บทางการของ Synapse ระบุว่า การ pg_dumpสร้างสแนปช็อตแบบปกติ จะมีความสอดคล้องกันโดยไม่ต้องหยุด Synapse หรือ PostgreSQL การดำเนินการที่ถูกต้อง:ควรเปิดใช้งานบริการไว้สำหรับการสำรองข้อมูลเชิงตรรกะนี้ แต่ควรวางแผนช่วงเวลาสำหรับการบำรุงรักษาเพื่อทำการกู้คืนข้อมูลแบบเต็มรูปแบบ

กู้คืนลงในฐานข้อมูลที่ว่างเปล่า

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

  1. สร้างฐานข้อมูลใหม่โดยใช้การเข้ารหัส UTF-8 และกำหนดเจ้าของฐานข้อมูลตามการตั้งค่า Synapse ของคุณ ตัวอย่างต่อไปนี้ใช้บทบาท (role) ตัวอย่างsynapse_user:

    sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse

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

  2. โหลดไฟล์เก็บถาวรลงในฐานข้อมูลที่ว่างเปล่า:

    sudo -u postgres pg_restore --dbname=synapse /secure-backups/synapse.dump

    ตรวจสอบสถานะการออกจากคำสั่งและผลลัพธ์ของ PostgreSQL ตรวจสอบข้อผิดพลาดก่อนเริ่มใช้งาน Synapse หลีกเลี่ยงตัวเลือกต่างๆ เช่น--cleanการใช้เป็นทางลัดในการกู้คืนทับฐานข้อมูลที่ใช้งานจริงอยู่แล้ว Synapse เตือนว่าตารางที่มีอยู่ก่อนแล้วอาจทำให้เกิดข้อผิดพลาดหรือความไม่สอดคล้องกันเล็กน้อยได้

  3. หากไฟล์สำรองข้อมูลไม่ได้ยกเว้นข้อมูลคีย์ใช้ครั้งเดียว ให้ล้างข้อมูลคีย์นั้นก่อนเริ่มระบบ เชื่อมต่อกับฐานข้อมูลที่กู้คืนแล้วและเรียกใช้คำสั่งต่อไปนี้:

    sudo -u postgres psql --dbname=synapse -c 'TRUNCATE e2e_one_time_keys_json;'

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

ความเข้าใจผิดที่พบบ่อย:สามารถกู้คืนตารางฐานข้อมูลทั้งหมดได้อย่างปลอดภัยวิธีแก้ไข:ควรยกเว้นe2e_one_time_keys_jsonตารางนั้นระหว่างการสำรองข้อมูล หรือตัดข้อมูลในตารางนั้นทิ้งหลังจากกู้คืน และควรทำเช่นนั้นก่อนที่กระบวนการใดๆ ของ Synapse จะเริ่มต้นขึ้น

นำโฮมเซิร์ฟเวอร์กลับมาใช้งานและตรวจสอบดู

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

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

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

ฝากความเห็น

กู้คืน Matrix Synapse อย่างปลอดภัยด้วยการสำรองข้อมูล PostgreSQL

สำรองข้อมูล Synapse ด้วย pg_dump ป้องกันคีย์ลงนามและสื่อบันทึกข้อมูล และกู้คืนลงในฐานข้อมูล PostgreSQL ที่สะอาดโดยไม่ใช้คีย์แบบใช้ครั้งเดียวที่หมดอายุแล้ว

เรียกใช้ Mjölnir เป็นบอทควบคุมห้องสนทนาใน Matrix ด้วย Docker

เรียกใช้ Mjölnir เป็นบอทควบคุมห้องสนทนาใน Matrix ด้วย Docker

ตั้งค่า Mjölnir ด้วยบัญชี Matrix เฉพาะ, ห้องจัดการที่เข้ารหัส, Docker Compose, รายการนโยบาย และการตรวจสอบสิทธิ์

เปิดใช้งาน Native Matrix Sliding Sync เพื่อการโหลดบนมือถือที่เร็วขึ้น

เปิดใช้งาน Native Matrix Sliding Sync เพื่อการโหลดบนมือถือที่เร็วขึ้น

ข้ามขั้นตอนการใช้พร็อกซีที่เลิกใช้งานแล้ว และกำหนดค่า Sliding Sync ที่มีอยู่ใน Synapse ตรวจสอบการค้นหาไคลเอ็นต์ จากนั้นวัดการโหลดรายการห้องและพฤติกรรมการเชื่อมต่อใหม่บนโทรศัพท์ที่ใช้งานร่วมกันได้

ติดตั้ง Element Web บน Nginx ด้วยโฮมเซิร์ฟเวอร์แบบกำหนดเอง

ติดตั้ง Element Web เป็นเว็บไซต์แบบคงที่ ชี้ไปยังโฮมเซิร์ฟเวอร์ Matrix ของคุณ เพิ่ม HTTPS และกำหนดค่า Nginx เพื่อให้บริการอัปเดตโดยไม่มีไฟล์เก่าค้างอยู่

ใช้งาน Matrix Homeserver ขนาดเล็กบน Raspberry Pi 4

ติดตั้ง Conduit บน Raspberry Pi 4 แบบ 64 บิต โดยตั้งค่าให้เก็บข้อมูลถาวร การเชื่อมต่อ HTTPS การลงทะเบียนที่ปลอดภัย และตรวจสอบว่าโฮมเซิร์ฟเวอร์ทำงานได้หรือไม่

ตั้งค่านามแฝงห้องเมทริกซ์แบบกำหนดเองบนโดเมนของคุณเอง

กำหนดที่อยู่เว็บไซต์ที่แชร์ได้ง่ายให้กับห้อง Matrix บนโดเมนของคุณโดยใช้ Element หรือ Matrix API พร้อมการตรวจสอบสิทธิ์ การตั้งชื่อ Synapse และการเชื่อมโยงระบบ

ตั้งค่า coturn เพื่อการโทรด้วยเสียงและวิดีโอผ่าน Matrix ที่เชื่อถือได้

กำหนดค่า coturn และ Synapse ด้วยข้อมูลรับรอง TURN ที่ตรงกัน เปิดพอร์ตรีเลย์ที่จำเป็น และตรวจสอบว่าไคลเอ็นต์ Matrix สามารถรับผู้สมัครรีเลย์ได้

ติดตั้งใช้งาน Matrix Synapse ด้วย Docker Compose และ PostgreSQL

ติดตั้งใช้งาน Matrix Synapse ด้วย Docker Compose และ PostgreSQL

ตั้งค่าโฮมเซิร์ฟเวอร์ Synapse แบบถาวรด้วย Docker Compose, PostgreSQL, การกำหนดค่าส่วนตัว และการตรวจสอบต่างๆ ก่อนที่จะเปิดเผยผ่าน HTTPS

ปรับแต่งธีมและแบรนด์ของ Element Web

กำหนดชื่อแบรนด์ สีที่กำหนดเอง และองค์ประกอบการเข้าสู่ระบบสำหรับการใช้งาน Element Web ของคุณ พร้อมทั้งทำความเข้าใจว่าส่วนใดบ้างที่ยังคงใช้แบรนด์ Element อยู่

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

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

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