เพิ่มขีดจำกัดไฟล์ Systemd ของ Synapse โดยไม่ต้องคาดเดา
ตรวจสอบว่า Synapse ถึงขีดจำกัดการเปิดไฟล์ต่อกระบวนการแล้วหรือไม่ ตั้งค่า systemd drop-in สำหรับบริการหรือ worker ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์
ณ วันที่ 10 ตุลาคม 2026 PyPI แสดงรายการ Simple-Matrix-Bot-Lib เวอร์ชัน 2.13.1 ซึ่งเผยแพร่เมื่อวันที่ 29 มีนาคม 2026 แพ็กเกจนี้ต้องการ Python 3.9 หรือใหม่กว่า แต่ Python 3.9 หมดอายุการใช้งานแล้ว โปรดใช้ Python เวอร์ชันที่ได้รับการดูแลรักษาซึ่งแพ็กเกจนี้รองรับ เอกสารประกอบโครงการที่เผยแพร่บน PyPI ยังคงระบุเวอร์ชันเป็น 2.11.0 และเตือนว่าไม่มีการดูแลรักษาแล้ว ดังนั้นคู่มือนี้จึงใช้ตัวอย่าง PyPI ปัจจุบันสำหรับ API ของบอท และใช้คู่มือฉบับเก่าเฉพาะสำหรับหมายเหตุการกำหนดค่าที่ระบุไว้อย่างชัดเจนเท่านั้นตรวจสอบการเผยแพร่แพ็กเกจและข้อมูลเมตาบน PyPIอ่าน สถานะเอกสาร ประกอบโครงการ
วิธีการตั้งค่าที่รวดเร็วและน่าเชื่อถือที่สุดคือ การมีผู้ใช้ Matrix เฉพาะรายหนึ่ง สภาพแวดล้อมเสมือน Python และบอทตอบกลับขนาดเล็กที่ตอบสนอง!echoในห้องทดสอบ ตัวอย่างนี้ใช้สำหรับห้องที่ไม่ได้เข้ารหัส หากต้องการตั้งค่าห้องที่เข้ารหัสเพิ่มเติมจะต้องใช้การตั้งค่าเพิ่มเติม
สร้างหรือขอบัญชีผู้ใช้ทั่วไปบนโฮมเซิร์ฟเวอร์ที่จะใช้รันบอท ตั้งชื่อผู้ใช้ให้ไม่ซ้ำใคร เช่นecho_bot; ไม่จำเป็นต้องมีสิทธิ์ผู้ดูแลระบบโฮมเซิร์ฟเวอร์ การลงทะเบียนอาจถูกปิดใช้งานหรือจำกัดโดยเซิร์ฟเวอร์นั้น ดังนั้นโปรดปฏิบัติตามนโยบายการสร้างบัญชีของเซิร์ฟเวอร์นั้น เชิญบัญชีดังกล่าวเข้าร่วมเฉพาะห้องทดสอบส่วนตัวที่อนุญาตให้ส่งข้อความได้เท่านั้น
ควรใช้ Python 3.11 หรือเวอร์ชัน Python อื่นที่ได้รับการสนับสนุนในปัจจุบัน แม้ว่าข้อมูลเมตาของแพ็กเกจจะยังอนุญาตให้ใช้ Python 3.9 ได้ แต่ Python.org ได้ระบุว่าเวอร์ชันนั้นจะหมดอายุการใช้งานในวันที่ 31 ตุลาคม 2025 ดังนั้นเวอร์ชันขั้นต่ำของแพ็กเกจจึงไม่ใช่คำแนะนำที่ดีสำหรับการใช้งาน ดูประกาศการสนับสนุน Python 3.9 ของ Python.org
เรียกใช้คำสั่งเหล่านี้จากโฟลเดอร์โปรเจ็กต์ใหม่ สภาพแวดล้อมเสมือนจะแยกแพ็กเกจของบอทนี้ออกจากโปรเจ็กต์ Python อื่นๆ การกำหนดเวอร์ชันที่แน่นอนจะทำให้ตัวอย่างสามารถทำซ้ำได้กับเวอร์ชันล่าสุดที่ได้รับการตรวจสอบแล้วสำหรับบทความนี้ เมื่ออัปเกรด โปรดตรวจสอบเวอร์ชัน PyPI ปัจจุบันและหมายเหตุเกี่ยวกับความเข้ากันได้
python3 --version
python3 -m venv .venv
source .venv/bin/activate
python -m pip install "simplematrixbotlib==2.13.1"
ใน Windows PowerShell ให้เปิดใช้งานสภาพแวดล้อมโดย ใช้คำสั่ง `git config` .venv\Scripts\Activate.ps1แทน คำสั่ง `git config` sourceจากนั้นสร้างไฟล์ชื่อbot.py`.py` หน้าโครงการของ PyPI จะอธิบายชื่อแพ็กเกจและคำสั่งติดตั้ง และตัวอย่างที่เผยแพร่จะใช้ `python`, `python` Creds, Botตัวรับฟังข้อความ และMessageMatch`python` ดูตัวอย่างการใช้งาน PyPI ปัจจุบันได้ที่นี่

บันทึกข้อความต่อไปนี้เป็นbot.py. ระบบจะขอรหัสผ่านบอทเมื่อเริ่มต้นทำงาน ดังนั้นรหัสผ่านจึงไม่ได้ถูกเขียนลงในไฟล์ต้นฉบับ สำหรับการใช้งานบริการแบบอัตโนมัติ ให้ดึงข้อมูลลับจากตัวจัดการข้อมูลลับของระบบปฏิบัติการหรือตัวแปรสภาพแวดล้อมที่ได้รับการป้องกันแทนที่จะเขียนลงในโค้ดโดยตรง ควรเก็บรักษาข้อมูลเซสชันหรือโทเค็นการเข้าถึงที่สร้างโดยไลบรารีไว้เป็นข้อมูลประจำตัว: เก็บไว้เป็นส่วนตัวและอย่าให้รวมอยู่ในระบบควบคุมเวอร์ชัน
import getpass
import simplematrixbotlib as botlib
creds = botlib.Creds(
homeserver="https://matrix.example.org",
username="echo_bot",
password=getpass.getpass("Bot password: "),
)
bot = botlib.Bot(creds)
PREFIX = "!"
@bot.listener.on_message_event
async def echo(room, message):
match = botlib.MessageMatch(room, message, bot, PREFIX)
if (match.is_not_from_this_bot()
and match.prefix()
and match.command("echo")):
text = " ".join(match.args())
reply = text or "Usage: !echo <text>"
await bot.api.send_text_message(room.room_id, reply)
bot.run()
แทนที่ URL ของโฮมเซิร์ฟเวอร์ตัวอย่างด้วย URL หลักของเซิร์ฟเวอร์ของคุณ และใช้ชื่อผู้ใช้และรหัสผ่านบัญชีของบอท ตัวรับฟังจะรับข้อความในห้อง ตรวจสอบMessageMatchให้แน่ใจว่าได้ละเว้นข้อความของตัวเองและจัดการเฉพาะ!echoคำสั่งเท่านั้น การเรียก API จะส่งคำที่เหลือกลับไปยังห้องเดิม ชื่อและการเรียกใช้เมธอดเหล่านี้เป็นไปตามตัวอย่างที่เผยแพร่บน PyPI ของไลบรารี เปรียบเทียบกับคู่มือเริ่มต้นใช้ งานฉบับย่อของ Simple-Matrix-Bot-Lib


จากสภาพแวดล้อมเสมือนที่เปิดใช้งานแล้ว ให้เรียกใช้คำสั่ง:
python bot.py
ป้อนรหัสผ่านบัญชีบอทเมื่อได้รับแจ้ง ในห้องทดสอบ ให้ส่งข้อความ!echo helloบอทพื้นฐานที่ใช้งานได้จะตอบกลับhelloหากบอทเงียบ ให้ตรวจสอบว่าบัญชีบอทได้เข้าร่วมห้องนั้นแล้ว ผู้ใช้มีสิทธิ์ส่งข้อความในห้องนั้น URL ของโฮมเซิร์ฟเวอร์ถูกต้อง และข้อความเริ่มต้นด้วยคำนำหน้าที่ถูกต้อง!ปล่อยให้กระบวนการทำงานต่อไป การปิดเทอร์มินัลจะหยุดการทำงานของการใช้งานแบบง่ายๆ นี้

ตัวอย่างนี้ไม่ได้ประมวลผลข้อความห้องประชุมที่เข้ารหัสแบบ end-to-end (E2EE) ไลบรารีโฆษณาว่ารองรับ E2EE แต่คู่มือที่เผยแพร่ในปัจจุบันมีหมายเลขเวอร์ชัน 2.11.0 และอาจล้าสมัย คู่มือดังกล่าวอธิบายถึงmatrix-nio[e2e]ส่วนประกอบเพิ่มเติมและConfig.encryption_enabledการตั้งค่าบางอย่าง โปรดตรวจสอบขั้นตอนการติดตั้งและการตรวจสอบที่ถูกต้องสำหรับเวอร์ชันที่คุณติดตั้งก่อนเปิดใช้งานการเข้ารหัส เอกสารเก่าๆ ยังมีการjoin_on_inviteตั้งค่าอีกด้วย เชิญบอทเฉพาะในห้องที่ควรเข้าถึงได้ และตรวจสอบการตั้งค่าดังกล่าวหากการใช้งานของคุณต้องควบคุมการเข้าร่วมห้องอัตโนมัติ โปรดตรวจสอบคู่มือ E2EE และการกำหนดค่าของไลบรารี
การตั้งค่าจะเสร็จสมบูรณ์เมื่อบอทยังคงล็อกอินอยู่ เป็นสมาชิกของห้องทดสอบ และตอบกลับ!echo helloด้วยข้อความhello. สำหรับการใช้งานจริง ให้รันบอทภายใต้ตัวจัดการกระบวนการ และปกป้องรหัสผ่านและข้อมูลเซสชันของบอท
ตรวจสอบว่า Synapse ถึงขีดจำกัดการเปิดไฟล์ต่อกระบวนการแล้วหรือไม่ ตั้งค่า systemd drop-in สำหรับบริการหรือ worker ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์
ตรวจสอบว่าข้อผิดพลาดนั้นเกิดขึ้นเฉพาะกับเบราว์เซอร์เดียวหรือเหตุการณ์เดียวหรือไม่ จากนั้นใช้รหัสกู้คืนของ Element หรืออุปกรณ์ที่เชื่อถือได้โดยไม่ต้องเสี่ยงกับประวัติการเข้ารหัสที่เหลืออยู่ของคุณ
ใช้ API สำหรับล้างประวัติและสื่อของ Synapse หรือการตั้งค่าการเก็บรักษาข้อมูลเพื่อลบข้อมูลที่ล้าสมัยอย่างปลอดภัย จากนั้นตรวจสอบความสมบูรณ์และการกู้คืนพื้นที่ดิสก์
ติดตั้งไลบรารีเวอร์ชันปัจจุบัน เชื่อมต่อบัญชี Matrix เฉพาะ และเรียกใช้บอท !echo ขนาดเล็กที่มีการจัดการข้อมูลประจำตัวที่ปลอดภัยยิ่งขึ้นและการทดสอบที่ชัดเจน
ตั้งค่าบริดจ์ Mautrix สามตัว โดยแยกการลงทะเบียน การเข้าสู่ระบบ และการทดสอบออกจากกัน เพื่อหลีกเลี่ยงปัญหาที่อาจเกิดขึ้นจากการเชื่อมต่อเครือข่าย Docker นโยบายบัญชี และการซิงค์ข้อมูล
ค้นหาสิ่งที่กำลังทำให้พื้นที่เก็บข้อมูลของ Synapse เต็ม ตั้งค่าการเก็บรักษาข้อมูลสื่ออย่างปลอดภัย และล้างแคชระยะไกลโดยไม่ต้องลบไฟล์โดยตรงจากดิสก์
ตรวจสอบกิจกรรมของอุปกรณ์ ปิดใช้งานบัญชี Synapse ที่ได้รับการยืนยันว่าไม่ได้ใช้งานผ่านทาง Admin API และเรียนรู้ว่าตัวเลือก "ลบข้อมูล" นั้นลบอะไรออกไปบ้าง
ตรวจสอบว่าหน่วยความจำของ PostgreSQL มาจากงานประมวลผลคำสั่งค้นหา บัฟเฟอร์ที่ใช้ร่วมกัน การเชื่อมต่อ หรือการบำรุงรักษา จากนั้นทำการเปลี่ยนแปลงที่ปลอดภัยต่อการใช้งาน Synapse ตามเป้าหมาย
ตรวจสอบการเข้าร่วมห้อง Matrix ที่ช้าไปยังโฮมเซิร์ฟเวอร์ระยะไกลเครื่องใดเครื่องหนึ่ง การหน่วงเวลาของเฟเดอเรชัน การโหลดฐานข้อมูลภายใน หรือคิวผู้ส่งขาออก ก่อนที่จะเปลี่ยนการตั้งค่า Synapse
หยุดการสร้างบัญชีแบบเปิดบนเซิร์ฟเวอร์ Synapse ที่โฮสต์เอง หรือจำกัดการลงทะเบียนเฉพาะผู้ได้รับเชิญเท่านั้น โดยใช้โทเค็นการลงทะเบียนที่มีจำนวนการใช้งานจำกัด