วิธีตั้งค่าการควบคุมห้องสนทนาแบบเมทริกซ์ด้วยบอท Mjolnir

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

คู่มือนี้อ้างอิงจากเอกสารการตั้งค่าและการดูแลระบบของ Mjolnir ต้นฉบับ และคำแนะนำการดูแลระบบของชุมชน Matrix ที่ตรวจสอบเมื่อวันที่ 6 ตุลาคม 2026 หน้าเพจเผยแพร่ของโครงการระบุว่า v1.12.1 เป็นเวอร์ชันล่าสุด ณ เวลาที่ตรวจสอบ โปรดตรวจสอบหน้าเพจเผยแพร่และตัวอย่างการกำหนดค่าต้นฉบับอีกครั้งเมื่อทำการติดตั้ง เนื่องจากแท็กคอนเทนเนอร์และตัวเลือกที่รองรับอาจมีการเปลี่ยนแปลง

ค้อนมโยลเนียร์เหมาะสมกับชุมชนเดอะแมทริกซ์ของคุณหรือไม่?

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

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

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

• บัญชีโฮมเซิร์ฟเวอร์ Matrix ที่สร้างขึ้นเพื่อบอทโดยเฉพาะ เช่น@mjolnir:example.org.
• ห้องจัดการส่วนตัวที่ผู้ดูแลระบบที่ได้รับอนุญาตสามารถออกคำสั่งและรับข้อความแจ้งสถานะได้
• ไดเร็กทอรีหรือวอลุ่มถาวรสำหรับจัดเก็บการตั้งค่าและสถานะของ Mjolnir
• แผนสำหรับห้องที่เข้ารหัส การกำหนดค่า Mjolnir ปัจจุบันรองรับการเข้ารหัสแบบเนทีฟ การกำหนดค่านี้ยังระบุ Pantalaimon เป็นตัวเลือกแยกต่างหากที่เลิกใช้แล้ว อย่าเปิดใช้งานทั้งสองเส้นทางพร้อมกัน
• ห้องทดสอบที่คุณสามารถยืนยันคำเชิญ สิทธิ์ และพฤติกรรมของรายการต่างๆ ก่อนที่จะปกป้องห้องใช้งานจริงที่มีการใช้งานอย่างแพร่หลาย

วิธีการติดตั้งค้อนมโยลเนียร์ทำอย่างไร?

เอกสารโครงการต้นทางอธิบายการติดตั้ง Docker และการสร้างด้วยตนเอง สำหรับผู้ดูแลระบบส่วนใหญ่ที่ใช้งานคอนเทนเนอร์อยู่แล้ว Docker Compose นั้นสะดวกเพราะสามารถรีสตาร์ทบอทและแสดงบันทึกได้โดยไม่ต้องเปิดเทอร์มินัลแบบโต้ตอบไว้ตลอดเวลา ปฏิบัติตามคำแนะนำการตั้งค่า Docker ของโครงการ และตรึงเวอร์ชันที่ได้รับการตรวจสอบแล้วไว้ในสภาพแวดล้อมการผลิต แทนที่จะพึ่งพาlatestแท็กที่เปลี่ยนแปลงไปเรื่อยๆ อิมเมจอย่างเป็นทางการคือmatrixdotorg/mjolnir.

เตรียมไฟล์การกำหนดค่าก่อนเริ่มคอนเทนเนอร์ คู่มือ Docker ต้นฉบับระบุว่าไฟล์การกำหนดค่าควรอยู่ในไดเร็กทอรีข้อมูลถาวรที่ `/etc/document.js` config/production.yamlควรเก็บไดเร็กทอรีนั้นให้เฉพาะผู้ดูแลระบบและบริการที่ต้องการใช้งานเท่านั้นที่สามารถเข้าถึงได้ ไฟล์ดังกล่าวอาจมีโทเค็นการเข้าถึงหรือข้อมูลประจำตัวการเข้าสู่ระบบอื่นๆ ห้ามนำไฟล์นี้ไปไว้ในที่เก็บข้อมูลสาธารณะ ห้ามโพสต์ในห้องสนทนาขอความช่วยเหลือ หรือรวมไว้ในบันทึกการทำงาน

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

# Illustrative values only; use the exact keys and authentication method
# from the current upstream configuration sample. Never share real secrets.
homeserverUrl: https://matrix.example.org
managementRoom: '!privateRoomId:example.org'
accessToken: '[STORE A SECRET HERE, NOT IN PUBLIC]'

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

คุณควรรักษาความปลอดภัยห้องประชุมอย่างไร?

สร้างห้องสำหรับผู้ดูแลที่น่าเชื่อถือ เชิญบัญชีบอท และตั้งค่าห้องให้เป็นส่วนตัวสำหรับทีมผู้ดูแล รหัสห้องหรือชื่อเรียกแทนจะอยู่ในไฟล์managementRoom.com/bot-include <room-include> การกำหนดค่าปัจจุบันระบุว่าห้องนี้เป็นแหล่งที่มาของคำสั่งและเตือนว่าใครก็ตามที่สามารถส่งคำสั่งไปยังห้องนี้ได้สามารถควบคุม Mjolnir ได้ แต่ไม่ได้มีการควบคุมการเข้าถึงแบบละเอียดสำหรับแต่ละคำสั่ง ดังนั้นการตรวจสอบสมาชิกจึงมีความสำคัญ ควรลบผู้ดูแลคนเก่าออกโดยเร็ว และอย่าใช้ห้องควบคุมของบอทเป็นห้องแชททั่วไปของชุมชน

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

มโยลเนียร์ควรได้รับสิทธิ์อนุญาตอะไรบ้าง?

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

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

ใน Element คุณสามารถเชิญบอทจากแผงสมาชิกของห้องหรือป้อนคำสั่งเชิญ เช่น/invite @mjolnir:example.orgหลังจากที่บอทเข้าร่วมแล้ว ให้ปรับบทบาทของบอทในรายชื่อสมาชิกของห้อง ทำซ้ำขั้นตอนนี้สำหรับทุกห้องที่ต้องการปกป้อง Mjolnir ไม่สามารถปกป้องห้องที่ตนเองไม่ได้เข้าร่วมได้ ซึ่งเป็นไปตามแบบจำลองการอนุญาตแบบกระจายศูนย์และแบบห้องต่อห้องของ Matrix

คุณจะสร้างรายชื่อผู้ถูกแบนและเพิ่มห้องที่ได้รับการป้องกันได้อย่างไร?

เมื่อบอทเริ่มต้นทำงานและโพสต์สถานะในห้องจัดการแล้ว ให้สร้างรายการนโยบายในห้องนั้น คู่มือเริ่มต้นใช้งานฉบับย่อของ Mjolnir ใช้ตัวอย่างนี้:

!mjolnir list create COC code-of-conduct-ban-list
!mjolnir default COC
!mjolnir rooms add #community:example.org
!mjolnir verify
!mjolnir status

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

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

คุณควรทดสอบอะไรบ้างก่อนนำไปใช้ในเหตุการณ์จริง?

• ยืนยันการโพสต์ข้อความเริ่มต้นและสถานะการทำงานของบอทในห้องจัดการที่กำหนดค่าไว้
• เรียกใช้โปรแกรม!mjolnir verifyหลังจากเชิญเข้าสู่ห้องทดสอบและมอบบทบาทที่เลือกไว้ให้แล้ว
• เรียกใช้โปรแกรม!mjolnir roomsและตรวจสอบว่าห้องที่ต้องการปรากฏขึ้น โดยไม่มีห้องที่ไม่เกี่ยวข้องรวมอยู่ด้วย
• ตรวจสอบ!mjolnir protectionsและเปิดใช้งานเฉพาะการป้องกันที่คุณเข้าใจเท่านั้น การป้องกันอัตโนมัติอาจส่งผลกระทบต่อผู้ใช้ที่ถูกต้องตามกฎหมายได้
• ใช้บัญชีทดสอบและห้องชั่วคราวเพื่อตรวจสอบความถูกต้องของขั้นตอนการแบน การปลดแบน และการปกปิดข้อมูลของทีม ก่อนนำไปใช้กับสมาชิกจริง
• ตรวจสอบบันทึกคอนเทนเนอร์และข้อความในห้องจัดการของ Mjolnir หากบอททำงานผิดพลาดหรือรายงานว่าไม่มีสิทธิ์อนุญาต

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

ข้อผิดพลาดในการตั้งค่าที่พบบ่อยมีอะไรบ้าง?

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

คุณสามารถตรวจสอบรายละเอียดปัจจุบันได้ที่ไหน?

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