เพิ่มขีดจำกัดไฟล์ Systemd ของ Synapse โดยไม่ต้องคาดเดา
ตรวจสอบว่า Synapse ถึงขีดจำกัดการเปิดไฟล์ต่อกระบวนการแล้วหรือไม่ ตั้งค่า systemd drop-in สำหรับบริการหรือ worker ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์
เพื่อลบข้อมูล Matrix Synapse เก่าอย่างปลอดภัย ให้แยกการลบประวัติห้องและการลบไฟล์มีเดียออกจากกัน ใช้ API สำหรับการจัดการการล้างประวัติสำหรับเหตุการณ์ในห้องเก่า ใช้ API สำหรับการลบไฟล์มีเดียสำหรับไฟล์มีเดียในเครื่อง และใช้ API สำหรับแคชไฟล์มีเดียระยะไกลสำหรับไฟล์ที่ดาวน์โหลดจากโฮมเซิร์ฟเวอร์อื่น สำหรับการล้างข้อมูลที่เกิดขึ้นซ้ำๆ ให้กำหนดค่านโยบายการเก็บรักษาสำหรับข้อความและไฟล์มีเดีย การล้างแถวในฐานข้อมูลไม่ได้ทำให้ขนาดไฟล์ฐานข้อมูลบนดิสก์ลดลงทันทีเสมอไป
| อะไรกำลังกินพื้นที่อยู่? | ใช้ | ขีดจำกัดที่สำคัญ |
|---|---|---|
| ข้อความเก่าและกิจกรรมอื่นๆ ในห้องแชท | API สำหรับผู้ดูแลระบบล้างประวัติ หรือการเก็บรักษาข้อความโดยอัตโนมัติ | การล้างประวัติการสนทนาจะขึ้นอยู่กับแต่ละห้อง สถานะของห้องจะยังคงอยู่ Synapse จะเก็บข้อความอย่างน้อยหนึ่งข้อความไว้ในแต่ละห้อง |
| ไฟล์มีเดียที่จัดเก็บโดยโฮมเซิร์ฟเวอร์ของคุณ | ลบ Local Media API หรือการเก็บรักษาข้อมูลสื่อในเครื่อง | โดยค่าเริ่มต้น ไฟล์มีเดียที่ใช้ในโปรไฟล์และรูปประจำตัวในห้องแชทจะได้รับการป้องกันด้วยข้อมูลวันที่/ขนาดไฟล์ |
| สื่อที่แคชไว้จากโฮมเซิร์ฟเวอร์อื่น | ล้างข้อมูล API สื่อระยะไกล หรือการเก็บรักษาข้อมูลสื่อระยะไกล | หากมีการร้องขออีกครั้ง Synapse จะดึงข้อมูลจากเซิร์ฟเวอร์ต้นทางอีกครั้ง |
การควบคุมเหล่านี้มีผลต่อฐานข้อมูลและที่เก็บสื่อของ Synapse เอง หากคุณใช้ที่เก็บสื่อภายนอก เช่น Matrix Media Repository ปลายทางการลบสื่อในเครื่องของ Synapse จะไม่ลบไฟล์ที่จัดเก็บไว้ที่นั่น โปรดตรวจสอบเอกสารและนโยบายการสำรองข้อมูลของที่เก็บสื่อนั้นก่อนที่จะลบข้อมูล
enable_media_repo: truenpm run line` ซึ่งอาจเป็นกระบวนการหลัก ตรวจสอบการกำหนดเส้นทางและการกำหนดค่าของคุณก่อนที่จะวินิจฉัยปัญหาที่การล้างข้อมูลดูเหมือนจะไม่ทำงานในตัวอย่างด้านล่าง ให้แทนที่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";" บันทึกรหัสการล้างประวัติและคำตอบไว้ในบันทึกการบำรุงรักษาของคุณVACUUM FULLสามารถเรียกคืนพื้นที่ดิสก์ได้ แต่ต้องใช้การล็อกแบบพิเศษ ดังนั้นควรวางแผนการดำเนินการโดยคำนึงถึงเวลาหยุดทำงาน/ผลกระทบ และปฏิบัติตามเอกสาร VACUUM ของ PostgreSQLสำหรับ SQLite เอกสารการเก็บรักษาของ Synapse ระบุVACUUMการดำเนินการที่เกี่ยวข้องไว้ตรวจสอบว่า Synapse ถึงขีดจำกัดการเปิดไฟล์ต่อกระบวนการแล้วหรือไม่ ตั้งค่า systemd drop-in สำหรับบริการหรือ worker ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์
ตรวจสอบว่าข้อผิดพลาดนั้นเกิดขึ้นเฉพาะกับเบราว์เซอร์เดียวหรือเหตุการณ์เดียวหรือไม่ จากนั้นใช้รหัสกู้คืนของ Element หรืออุปกรณ์ที่เชื่อถือได้โดยไม่ต้องเสี่ยงกับประวัติการเข้ารหัสที่เหลืออยู่ของคุณ
ใช้ API สำหรับล้างประวัติและสื่อของ Synapse หรือการตั้งค่าการเก็บรักษาข้อมูลเพื่อลบข้อมูลที่ล้าสมัยอย่างปลอดภัย จากนั้นตรวจสอบความสมบูรณ์และการกู้คืนพื้นที่ดิสก์
ติดตั้งไลบรารีเวอร์ชันปัจจุบัน เชื่อมต่อบัญชี Matrix เฉพาะ และเรียกใช้บอท !echo ขนาดเล็กที่มีการจัดการข้อมูลประจำตัวที่ปลอดภัยยิ่งขึ้นและการทดสอบที่ชัดเจน
ตั้งค่าบริดจ์ Mautrix สามตัว โดยแยกการลงทะเบียน การเข้าสู่ระบบ และการทดสอบออกจากกัน เพื่อหลีกเลี่ยงปัญหาที่อาจเกิดขึ้นจากการเชื่อมต่อเครือข่าย Docker นโยบายบัญชี และการซิงค์ข้อมูล
ค้นหาสิ่งที่กำลังทำให้พื้นที่เก็บข้อมูลของ Synapse เต็ม ตั้งค่าการเก็บรักษาข้อมูลสื่ออย่างปลอดภัย และล้างแคชระยะไกลโดยไม่ต้องลบไฟล์โดยตรงจากดิสก์
ตรวจสอบกิจกรรมของอุปกรณ์ ปิดใช้งานบัญชี Synapse ที่ได้รับการยืนยันว่าไม่ได้ใช้งานผ่านทาง Admin API และเรียนรู้ว่าตัวเลือก "ลบข้อมูล" นั้นลบอะไรออกไปบ้าง
ตรวจสอบว่าหน่วยความจำของ PostgreSQL มาจากงานประมวลผลคำสั่งค้นหา บัฟเฟอร์ที่ใช้ร่วมกัน การเชื่อมต่อ หรือการบำรุงรักษา จากนั้นทำการเปลี่ยนแปลงที่ปลอดภัยต่อการใช้งาน Synapse ตามเป้าหมาย
ตรวจสอบการเข้าร่วมห้อง Matrix ที่ช้าไปยังโฮมเซิร์ฟเวอร์ระยะไกลเครื่องใดเครื่องหนึ่ง การหน่วงเวลาของเฟเดอเรชัน การโหลดฐานข้อมูลภายใน หรือคิวผู้ส่งขาออก ก่อนที่จะเปลี่ยนการตั้งค่า Synapse
หยุดการสร้างบัญชีแบบเปิดบนเซิร์ฟเวอร์ Synapse ที่โฮสต์เอง หรือจำกัดการลงทะเบียนเฉพาะผู้ได้รับเชิญเท่านั้น โดยใช้โทเค็นการลงทะเบียนที่มีจำนวนการใช้งานจำกัด