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

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

เลือกบริการทำความสะอาดที่ตรงกับเป้าหมายของคุณ

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

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

เตรียมตัวก่อนทำการชำระล้าง

  1. ตรวจสอบว่าอินสแตนซ์ Synapse ใดจัดการสื่อในการใช้งานแบบ Worker การล้างข้อมูลสื่อจะทำงานบน Worker ด้วยคำสั่ง ` enable_media_repo: truenpm run line` ซึ่งอาจเป็นกระบวนการหลัก ตรวจสอบการกำหนดเส้นทางและการกำหนดค่าของคุณก่อนที่จะวินิจฉัยปัญหาที่การล้างข้อมูลดูเหมือนจะไม่ทำงาน
  2. สำรองข้อมูลฐานข้อมูลและพื้นที่จัดเก็บสื่อ ทำการสำรองข้อมูลปัจจุบันที่สามารถกู้คืนได้ก่อนที่จะทำการลบข้อมูลอย่างถาวร บันทึกรหัสห้องและเวลาปิดทำการ และใช้โทเค็นการเข้าถึงของผู้ดูแลระบบเซิร์ฟเวอร์ ห้ามวางโทเค็นลงในประวัติคำสั่งเชลล์ที่ใช้ร่วมกันหรือเผยแพร่ในบันทึกเหตุการณ์
  3. วางแผนกำหนดเวลาตัดออกอย่างรอบคอบ ปลายทางการล้างข้อมูลยอมรับการประทับเวลาในหน่วยมิลลิวินาทีของ Unix ใช้เวลาตัดออกที่ได้จาก UTC และตรวจสอบตัวเลขก่อนส่งคำขอ เวลาตัดออกไม่ใช่การแสดงตัวอย่าง: มันสามารถลบข้อมูลที่เข้าเกณฑ์ได้อย่างถาวร

ในตัวอย่างด้านล่าง ให้แทนที่https://matrix.example.comด้วย URL พื้นฐานที่ลูกค้าเข้าถึงได้สำหรับโฮมเซิร์ฟเวอร์ของคุณ ตั้งค่ารหัสห้องที่ถูกต้อง และส่งออกโทเค็นผู้ดูแลระบบในไฟล์ADMIN_TOKEN. เก็บโทเค็น Bearer ไว้เป็นส่วนตัว

ลบประวัติข้อความเก่าออกจากห้องสนทนาหนึ่งห้อง

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

ตัวอย่างเช่น หากต้องการตั้งค่าจุดตัด 180 วันก่อนเวลาปัจจุบันบนโฮสต์ Linux ให้คำนวณการประทับเวลาเป็นมิลลิวินาที ตรวจสอบ แล้วส่งคำขอสำหรับห้องเดี่ยว:

export SYNAPSE_URL='https://matrix.example.com'
export ROOM_ID='!roomid:example.com'
export ADMIN_TOKEN='replace-with-a-server-admin-token'
PURGE_BEFORE_MS=$(python3 -c 'import time; print(int((time.time() - 180*86400) * 1000))')
printf 'Cutoff (Unix milliseconds): %s\n' "$PURGE_BEFORE_MS"

curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/purge_history/$ROOM_ID" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d "{\"purge_up_to_ts\":$PURGE_BEFORE_MS,\"delete_local_events\":true}"

ละเว้นdelete_local_eventsหรือตั้งค่าเป็นfalseหากคุณต้องการใช้พฤติกรรมเริ่มต้นของ Synapse หาก API ส่งคืนค่า แสดงว่าpurge_idการล้างข้อมูลได้เริ่มต้นขึ้นแล้ว แต่ยังไม่เสร็จสิ้น ตรวจสอบสถานะที่ปลายทางจนกว่าจะรายงานcompleteหรือตรวจสอบerrorหากสถานะเป็นfailed:

curl -sS "$SYNAPSE_URL/_synapse/admin/v1/purge_history_status/$PURGE_ID" \
  -H "Authorization: Bearer $ADMIN_TOKEN"

การลบข้อมูลจำนวนมากอาจใช้เวลาหลายนาทีหรือนานกว่านั้น ในระหว่างการดำเนินการ ผู้ใช้อาจไม่สามารถย้อนกลับไปยังหน้าก่อนหน้าในห้องนั้นจากจุดที่กำลังถูกลบข้อมูลได้ Synapse จะเก็บข้อความอย่างน้อยหนึ่งข้อความไว้ในห้อง ดังนั้น API นี้จะไม่ทำให้ไทม์ไลน์ของห้องนั้นว่างเปล่าทั้งหมด

ลบไฟล์มีเดียเก่าและไฟล์แคชระยะไกล

สำหรับการล้างข้อมูลสื่อในเครื่องเพียงครั้งเดียวที่ใช้ครั้งสุดท้ายก่อนเวลาที่กำหนด ให้ใช้ปลายทางสื่อในเครื่องปัจจุบัน ปลายทางนี้before_tsเป็นไทม์สแตมป์แบบ Unix ในหน่วยมิลลิวินาที และยังสามารถรับsize_gtไฟล์ที่มีขนาดเกินเกณฑ์ที่กำหนดได้ด้วย ค่าเริ่มต้นจะเก็บสื่อที่ยังคงใช้สำหรับรูปโปรไฟล์หรือรูปประจำตัวในห้องไว้ อย่าตั้งค่านี้keep_profiles=falseเว้นแต่คุณต้องการลบไฟล์เหล่านั้นโดยตั้งใจ

curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/media/delete?before_ts=$PURGE_BEFORE_MS" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

ตรวจสอบการตอบกลับtotalและรหัสสื่อที่ถูกลบ ปลายทางนี้จะลบไฟล์ต้นฉบับและภาพขนาดย่อในเครื่อง หลีกเลี่ยงเส้นทางเก่าที่มี/media/<server_name>/delete; เอกสาร Synapse ระบุว่าเส้นทางนั้นล้าสมัยแล้วตั้งแต่เวอร์ชัน 1.78.0 ปลายทางสื่อในเครื่องปัจจุบันไม่ได้ทำงานกับที่เก็บสื่อภายนอกแยกต่างหาก

สื่อระยะไกลที่แคชไว้เป็นหมวดหมู่แยกต่างหาก หากต้องการลบสื่อระยะไกลในแคชที่เข้าถึงครั้งล่าสุดก่อนเวลาตัดยอดเดียวกัน ให้ใช้คำสั่งต่อไปนี้:

curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/purge_media_cache?before_ts=$PURGE_BEFORE_MS" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

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

ตั้งค่าการเก็บรักษาข้อมูลแบบวนซ้ำแทนการลบข้อมูลด้วยตนเองซ้ำๆ

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

retention:
  enabled: true
  default_policy:
    max_lifetime: 1y

ใช้หน่วยระยะเวลาที่ Synapse รองรับ เช่นdวัน และyปี ผู้ดูแลห้องและผู้ดูแลห้องอาจตั้งค่าm.room.retentionเหตุการณ์สถานะของห้องได้ ในขณะที่ผู้ดูแลระบบเซิร์ฟเวอร์สามารถจำกัดอายุการใช้งานสูงสุดที่อนุญาตได้ด้วยallowed_lifetime_minและallowed_lifetime_maxตรวจสอบนโยบายฉบับเต็มของคุณก่อนเปิดใช้งาน: เหตุการณ์ที่เข้าเกณฑ์จะถูกลบออกอย่างถาวรโดยงานล้างข้อมูลเบื้องหลัง Synapse จะซ่อนเหตุการณ์ที่หมดอายุจากไคลเอ็นต์ทันทีที่หมดอายุ แต่การล้างฐานข้อมูลจะทำงานเป็นระยะ ดังนั้นแถวอาจยังคงอยู่จนกว่าจะมีงานทำงาน เหตุการณ์สถานะไม่ครอบคลุมโดยการเก็บรักษาข้อความ

สำหรับสื่อ ให้เพิ่มmedia_retentionช่วงอายุการใช้งาน ตัวอย่างเช่น:

media_retention:
  local_media_lifetime: 90d
  remote_media_lifetime: 14d

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

โปรดอ่านเอกสารอย่างเป็นทางการเกี่ยวกับPurge History API , Media Admin API , คู่มือการกำหนดค่า Synapseและนโยบายการเก็บรักษาข้อความก่อนทำการเปลี่ยนแปลงใดๆ พฤติกรรมของ API ที่อธิบายไว้ในที่นี้สะท้อนถึงเอกสารอย่างเป็นทางการที่ตรวจสอบเมื่อวันที่ 10 ตุลาคม 2026 โปรดยืนยันปลายทางและการกำหนดค่ากับเวอร์ชันที่ติดตั้งของคุณ

ตรวจสอบว่าพื้นที่จัดเก็บได้รับการเรียกคืนแล้ว

  • ตรวจสอบสถานะการล้างประวัติจนกว่าจะแสดงข้อความว่าcomplete";" บันทึกรหัสการล้างประวัติและคำตอบไว้ในบันทึกการบำรุงรักษาของคุณ
  • ตรวจสอบสื่อในเครื่องและแคชระยะไกลเพื่อดูจำนวนไฟล์ที่ถูกลบ จากนั้นตรวจสอบบันทึก Synapse และการใช้งานระบบไฟล์หลังจากทำการล้างข้อมูลแล้ว
  • อย่าเข้าใจผิดว่าจำนวนแถวในฐานข้อมูลที่น้อยลงจะหมายถึงไฟล์ฐานข้อมูลที่มีขนาดเล็กลงเสมอไป เอกสารของ Synapse ระบุว่า PostgreSQL อาจนำพื้นที่ที่ว่างกลับมาใช้ใหม่โดยไม่ต้องส่งคืนให้กับระบบปฏิบัติการ สำหรับ PostgreSQL VACUUM FULLสามารถเรียกคืนพื้นที่ดิสก์ได้ แต่ต้องใช้การล็อกแบบพิเศษ ดังนั้นควรวางแผนการดำเนินการโดยคำนึงถึงเวลาหยุดทำงาน/ผลกระทบ และปฏิบัติตามเอกสาร VACUUM ของ PostgreSQLสำหรับ SQLite เอกสารการเก็บรักษาของ Synapse ระบุVACUUMการดำเนินการที่เกี่ยวข้องไว้
  • ตรวจสอบให้แน่ใจว่าไฟล์ที่คาดหวังหรือเหตุการณ์เก่าๆ ไม่ได้ถูกให้บริการอีกต่อไปแล้ว และตรวจสอบว่าข้อมูลสำรองของคุณยังคงใช้งานได้ก่อนที่จะปิดงานบำรุงรักษา

ฝากความเห็น

เพิ่มขีดจำกัดไฟล์ 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 ที่โฮสต์เอง หรือจำกัดการลงทะเบียนเฉพาะผู้ได้รับเชิญเท่านั้น โดยใช้โทเค็นการลงทะเบียนที่มีจำนวนการใช้งานจำกัด