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

หากการดูแลจัดการ Matrix กระจัดกระจายอยู่ตามบัญชีส่วนตัวและห้องต่างๆ ให้ใช้งาน Mjölnir เป็นบอทเฉพาะ และมอบห้องจัดการส่วนตัวหนึ่งห้องให้กับผู้ดูแลเพื่อใช้ในการออกคำสั่ง การตั้งค่าแบบโฮสต์เองที่ง่ายที่สุดใช้ Docker Compose บัญชี Matrix แยกต่างหาก และห้องจัดการที่เข้ารหัส จากนั้นเพิ่มห้องชุมชนที่ Mjölnir ควรปกป้อง และตรวจสอบสิทธิ์การเข้าถึง

ค้อนมโยลเนียร์ทำอะไรได้บ้าง และมันต้องการอะไรบ้าง

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

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

1. สร้างบัญชีบอทและห้องควบคุมส่วนตัว

ลงทะเบียนบัญชีเฉพาะ เช่น@mjolnir:example.orgบนโฮมเซิร์ฟเวอร์ของคุณ อย่าใช้บัญชีส่วนตัวของผู้ดูแล: การใช้ข้อมูลประจำตัวที่แยกจากกันจะทำให้การหมุนเวียนการเข้าถึงง่ายขึ้นและทำให้การกระทำของบอทแตกต่างกัน สร้างห้องส่วนตัวสำหรับผู้ดูแล เปิดใช้งานการเข้ารหัสแบบ end-to-end และเชิญทั้งผู้ดูแลที่เป็นมนุษย์และบอท จำกัดสมาชิกเฉพาะบุคคลที่คุณไว้วางใจเท่านั้น ทุกคนในห้องจัดการที่กำหนดค่าไว้สามารถออกคำสั่งได้ และ Mjölnir ไม่ได้ให้สิทธิ์การออกคำสั่งที่ละเอียดกว่าภายในห้องนั้น

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

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

2. กำหนดค่า Mjölnir สำหรับโฮมเซิร์ฟเวอร์ของคุณ

บนโฮสต์ Docker ให้สร้างไดเร็กทอรีข้อมูลถาวรและคัดลอกไฟล์การกำหนดค่าตัวอย่างของโปรเจ็กต์ไปยังไดเร็กทอรี./mjolnir/config/production.yamlนั้น ไฟล์ตัวอย่างจะอธิบายตัวเลือกเพิ่มเติม ให้ตั้งค่าเฉพาะค่าที่จำเป็นสำหรับการใช้งานของคุณเท่านั้น อย่างน้อยที่สุด ให้ใช้ URL API ไคลเอ็นต์ของโฮมเซิร์ฟเวอร์ของคุณ โทเค็นบอท การเข้ารหัสแบบเนทีฟ และ ID ห้องหรือนามแฝงของห้องจัดการใน Matrix:

homeserverUrl: "https://matrix.example.org"
accessToken: "YOUR_BOT_ACCESS_TOKEN"
encryption:
  use: true
managementRoom: "!roomid:example.org"

แทนที่ค่าตัวอย่างทั้งหมด รหัสห้องขึ้นต้นด้วย!; ชื่อเรียกแทนขึ้นต้นด้วย#. ห้ามวางmatrix.toลิงก์ลงในmanagementRoom. ​​ถือว่าไฟล์การกำหนดค่าและโทเค็นเป็นความลับ: จำกัดการเข้าถึงไฟล์ เก็บไฟล์ไว้ให้ห่างจากระบบควบคุมเวอร์ชัน และอย่าเผยแพร่ในคำขอการสนับสนุน หากบอทไม่สามารถถอดรหัสห้องจัดการได้ ให้ตรวจสอบการตั้งค่าการเข้ารหัสอีกครั้งและยืนยันว่าบอทเข้าร่วมห้องแล้ว

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

3. เริ่มบริการ Docker Compose

คำแนะนำอย่างเป็นทางการของ Docker ใช้matrixdotorg/mjolnirภาพและเชื่อมต่อไดเร็กทอรีโฮสต์ที่/data. สร้างไฟล์docker-compose.ymlข้างๆmjolnirไดเร็กทอรี:

services:
  mjolnir:
    image: matrixdotorg/mjolnir:latest
    restart: unless-stopped
    volumes:
      - ./mjolnir:/data

จากไดเร็กทอรีนั้น ให้เริ่ม Mjölnir ด้วยคำ สั่ง `mjölnir` docker compose up -dไดเร็กทอรีที่เชื่อมต่อจะเก็บรักษาการตั้งค่าและข้อมูลบอทไว้เมื่อคอนเทนเนอร์ถูกสร้างขึ้นใหม่ คู่มืออย่างเป็นทางการใช้latestแท็ก `mjölnir` เป็นตัวอย่าง สำหรับเซิร์ฟเวอร์ที่ใช้งานจริง ให้เลือกแท็กเวอร์ชันที่คุณได้ทดสอบแล้วและบันทึกไว้เพื่อให้การอัปเกรดเป็นไปอย่างรอบคอบ ทำตามคำสั่ง `mjölnir` เพื่อเริ่มการทำงานdocker compose logs -f --tail 100 mjolnirรอข้อความเริ่มต้นของ Mjölnir ในห้องจัดการก่อนดำเนินการต่อ

หน้าจอเทอร์มินัลแสดงให้เห็นว่าบริการ Mjölnir Docker Compose กำลังเริ่มต้นทำงานโดยใช้ไดรฟ์ข้อมูลถาวร
เริ่มบริการจากไดเร็กทอรีที่มีไฟล์ Compose จากนั้นตรวจสอบบันทึกการทำงานเพื่อหาข้อผิดพลาดในการเริ่มต้น

4. สร้างรายการนโยบายและกำหนดสิทธิ์การเข้าถึงห้องต่างๆ

ในห้องจัดการ ให้ถามบอท!mjolnir helpหากบอทไม่ตอบสนอง สร้างรายการแบนโดยใช้รหัสสั้นและชื่อเล่นห้อง จากนั้นตั้งค่าให้เป็นรายการเริ่มต้น:

!mjolnir list create COC code-of-conduct-ban-list
!mjolnir default COC

Mjölnir จะสร้างห้องรายชื่อและเชิญคุณเข้าร่วมห้องรายชื่อนโยบายคือห้อง Matrix ที่มีกฎการควบคุมดูแล ดังนั้นโปรดตรวจสอบการมองเห็นและสมาชิกก่อนที่จะแชร์ เพิ่มห้องชุมชนแต่ละห้องที่คุณต้องการให้ Mjölnir ตรวจสอบ:

!mjolnir rooms add #community:example.org
!mjolnir verify

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

ห้องควบคุมระบบ Matrix ที่เข้ารหัสไว้ แสดงภาพ Mjölnir ออนไลน์ และคำสั่งสร้างรายการนโยบาย COC
เมื่อบอทตอบกลับในห้องจัดการส่วนตัวแล้ว ให้สร้างรายการและทดสอบคำสั่งในห้องนั้น

ตรวจสอบการตั้งค่าและหลีกเลี่ยงข้อผิดพลาดทั่วไป

  • บอทออนไลน์แล้ว: docker compose psแสดงว่าบริการกำลังทำงาน บันทึกแสดงว่าไม่มีข้อผิดพลาดในการตรวจสอบสิทธิ์หรือการเข้ารหัสซ้ำ และบอทจะโพสต์สถานะการเริ่มต้นทำงานในห้องจัดการ
  • คำสั่งต่างๆ ถูกจำกัด:ผู้ดูแลห้องสามารถใช้ คำสั่ง `command` และ `command` !mjolnir statusได้เฉพาะ!mjolnir rulesในห้องที่ตั้งค่าไว้เท่านั้น ห้ามทดสอบคำสั่งในห้องสาธารณะ
  • ห้องต่างๆ ได้รับการปกป้อง: !mjolnir roomsแสดงรายการห้องที่ต้องการ และ!mjolnir verifyรายงานระดับพลังงานที่เพียงพอ
  • ข้อมูลลับจะถูกเก็บเป็นความลับ:โทเค็นจะไม่ถูกจัดเก็บไว้ในที่เก็บข้อมูลสาธารณะ ประวัติการใช้งาน หรือบันทึกใดๆ หากโทเค็นถูกเปิดเผย ให้ยกเลิกหรือเปลี่ยนโทเค็นใหม่โดยการออกจากระบบบอทและอัปเดตการตั้งค่าก่อนที่จะเริ่มต้นใหม่

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

ฝากความเห็น

กู้คืน 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 ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์