กู้คืน Matrix Synapse อย่างปลอดภัยด้วยการสำรองข้อมูล PostgreSQL
สำรองข้อมูล Synapse ด้วย pg_dump ป้องกันคีย์ลงนามและสื่อบันทึกข้อมูล และกู้คืนลงในฐานข้อมูล PostgreSQL ที่สะอาดโดยไม่ใช้คีย์แบบใช้ครั้งเดียวที่หมดอายุแล้ว
หากการดูแลจัดการ Matrix กระจัดกระจายอยู่ตามบัญชีส่วนตัวและห้องต่างๆ ให้ใช้งาน Mjölnir เป็นบอทเฉพาะ และมอบห้องจัดการส่วนตัวหนึ่งห้องให้กับผู้ดูแลเพื่อใช้ในการออกคำสั่ง การตั้งค่าแบบโฮสต์เองที่ง่ายที่สุดใช้ Docker Compose บัญชี Matrix แยกต่างหาก และห้องจัดการที่เข้ารหัส จากนั้นเพิ่มห้องชุมชนที่ Mjölnir ควรปกป้อง และตรวจสอบสิทธิ์การเข้าถึง
Mjölnir คือบอทควบคุมดูแลของ Matrix ที่ใช้รายการนโยบายและดำเนินการควบคุมดูแลเสมือนเป็นบัญชีของตัวเองโฮมเซิร์ฟเวอร์คือเซิร์ฟเวอร์ Matrix ที่โฮสต์บัญชีผู้ใช้และห้องต่างๆห้องจัดการคือห้องส่วนตัวที่ผู้ดูแลระบบที่ได้รับอนุญาตออกคำสั่งบอทห้องที่ได้รับการป้องกันคือห้องที่ Mjölnir ตรวจสอบและสามารถควบคุมดูแลได้
สำหรับคู่มือนี้ คุณต้องมีสิทธิ์เข้าถึงบัญชี Matrix บนโฮมเซิร์ฟเวอร์ มีสิทธิ์ในการสร้างบัญชีบอทและห้องต่างๆ และมีโฮสต์ที่ติดตั้ง Docker Engine และปลั๊กอิน Docker Compose คุณไม่จำเป็นต้องตั้งให้ Mjölnir เป็นผู้ดูแลระบบโฮมเซิร์ฟเวอร์สำหรับการดูแลห้องทั่วไป การดำเนินการบางอย่างทั่วทั้งเซิร์ฟเวอร์ เช่น การปิดใช้งานผู้ใช้หรือการปิดห้อง ต้องใช้โฮมเซิร์ฟเวอร์ Synapse และสิทธิ์ผู้ดูแลระบบเซิร์ฟเวอร์ เว้นสิทธิ์เหล่านั้นไว้เว้นแต่กรณีการใช้งานของคุณจะต้องการ ดูรายละเอียดเพิ่มเติมได้ที่คลังเก็บข้อมูลอย่างเป็นทางการของ Mjölnir
ลงทะเบียนบัญชีเฉพาะ เช่น@mjolnir:example.orgบนโฮมเซิร์ฟเวอร์ของคุณ อย่าใช้บัญชีส่วนตัวของผู้ดูแล: การใช้ข้อมูลประจำตัวที่แยกจากกันจะทำให้การหมุนเวียนการเข้าถึงง่ายขึ้นและทำให้การกระทำของบอทแตกต่างกัน สร้างห้องส่วนตัวสำหรับผู้ดูแล เปิดใช้งานการเข้ารหัสแบบ end-to-end และเชิญทั้งผู้ดูแลที่เป็นมนุษย์และบอท จำกัดสมาชิกเฉพาะบุคคลที่คุณไว้วางใจเท่านั้น ทุกคนในห้องจัดการที่กำหนดค่าไว้สามารถออกคำสั่งได้ และ Mjölnir ไม่ได้ให้สิทธิ์การออกคำสั่งที่ละเอียดกว่าภายในห้องนั้น
ลงชื่อเข้าใช้ในฐานะบอทในโปรไฟล์เบราว์เซอร์แยกต่างหากหรือหน้าต่างส่วนตัวเพื่อรับโทเค็นการเข้าถึง Matrix ผ่าน การตั้งค่า ความช่วยเหลือและเกี่ยวกับ ของ Element คัดลอกโทเค็นลงในการกำหนดค่าของคุณอย่างปลอดภัย ปิดหน้าต่างเบราว์เซอร์นั้นโดยไม่ต้องออกจากระบบ การออกจากระบบจะทำให้โทเค็นใช้งานไม่ได้เอกสารการตั้งค่า อย่างเป็นทางการ แนะนำให้ใช้การเข้ารหัสสำหรับห้องจัดการและระบุให้เปิดใช้งานการเข้ารหัสในการกำหนดค่าของ 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. ถือว่าไฟล์การกำหนดค่าและโทเค็นเป็นความลับ: จำกัดการเข้าถึงไฟล์ เก็บไฟล์ไว้ให้ห่างจากระบบควบคุมเวอร์ชัน และอย่าเผยแพร่ในคำขอการสนับสนุน หากบอทไม่สามารถถอดรหัสห้องจัดการได้ ให้ตรวจสอบการตั้งค่าการเข้ารหัสอีกครั้งและยืนยันว่าบอทเข้าร่วมห้องแล้ว

คำแนะนำอย่างเป็นทางการของ 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 ในห้องจัดการก่อนดำเนินการต่อ

ในห้องจัดการ ให้ถามบอท!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อย่างไม่ระมัดระวัง: มันจะขยายการป้องกันไปยังห้องที่บอทเข้าร่วมและทำให้การเลือกห้องทีละห้องมีประโยชน์น้อยลง

docker compose psแสดงว่าบริการกำลังทำงาน บันทึกแสดงว่าไม่มีข้อผิดพลาดในการตรวจสอบสิทธิ์หรือการเข้ารหัสซ้ำ และบอทจะโพสต์สถานะการเริ่มต้นทำงานในห้องจัดการ!mjolnir statusได้เฉพาะ!mjolnir rulesในห้องที่ตั้งค่าไว้เท่านั้น ห้ามทดสอบคำสั่งในห้องสาธารณะ!mjolnir roomsแสดงรายการห้องที่ต้องการ และ!mjolnir verifyรายงานระดับพลังงานที่เพียงพอหากบอทเงียบ ให้ตรวจสอบก่อนว่ารหัสห้องจัดการหรือชื่อเรียกแทนนั้นถูกต้อง และบอทเป็นสมาชิกที่เข้าร่วมแล้ว สำหรับห้องที่เข้ารหัส ให้ตรวจสอบว่าเปิดใช้งานการเข้ารหัสแล้ว และบอทสามารถถอดรหัสข้อความได้ หากการดูแลจัดการล้มเหลวในห้องเดียว ให้ตรวจสอบว่าห้องนั้นได้รับการป้องกัน และระดับพลังงานของห้องนั้นอนุญาตให้ดำเนินการตามที่ร้องขอได้ สำหรับไวยากรณ์คำสั่งและตัวเลือกการกำหนดค่า โปรดดูคู่มือการดูแลจัดการ Mjölnirฉบับ ปัจจุบัน คู่มือการตั้งค่า Dockerและตัวอย่างการกำหนดค่า
สำรองข้อมูล Synapse ด้วย pg_dump ป้องกันคีย์ลงนามและสื่อบันทึกข้อมูล และกู้คืนลงในฐานข้อมูล PostgreSQL ที่สะอาดโดยไม่ใช้คีย์แบบใช้ครั้งเดียวที่หมดอายุแล้ว
ตั้งค่า Mjölnir ด้วยบัญชี Matrix เฉพาะ, ห้องจัดการที่เข้ารหัส, Docker Compose, รายการนโยบาย และการตรวจสอบสิทธิ์
ข้ามขั้นตอนการใช้พร็อกซีที่เลิกใช้งานแล้ว และกำหนดค่า Sliding Sync ที่มีอยู่ใน Synapse ตรวจสอบการค้นหาไคลเอ็นต์ จากนั้นวัดการโหลดรายการห้องและพฤติกรรมการเชื่อมต่อใหม่บนโทรศัพท์ที่ใช้งานร่วมกันได้
ติดตั้ง Element Web เป็นเว็บไซต์แบบคงที่ ชี้ไปยังโฮมเซิร์ฟเวอร์ Matrix ของคุณ เพิ่ม HTTPS และกำหนดค่า Nginx เพื่อให้บริการอัปเดตโดยไม่มีไฟล์เก่าค้างอยู่
ติดตั้ง Conduit บน Raspberry Pi 4 แบบ 64 บิต โดยตั้งค่าให้เก็บข้อมูลถาวร การเชื่อมต่อ HTTPS การลงทะเบียนที่ปลอดภัย และตรวจสอบว่าโฮมเซิร์ฟเวอร์ทำงานได้หรือไม่
กำหนดที่อยู่เว็บไซต์ที่แชร์ได้ง่ายให้กับห้อง Matrix บนโดเมนของคุณโดยใช้ Element หรือ Matrix API พร้อมการตรวจสอบสิทธิ์ การตั้งชื่อ Synapse และการเชื่อมโยงระบบ
กำหนดค่า coturn และ Synapse ด้วยข้อมูลรับรอง TURN ที่ตรงกัน เปิดพอร์ตรีเลย์ที่จำเป็น และตรวจสอบว่าไคลเอ็นต์ Matrix สามารถรับผู้สมัครรีเลย์ได้
ตั้งค่าโฮมเซิร์ฟเวอร์ Synapse แบบถาวรด้วย Docker Compose, PostgreSQL, การกำหนดค่าส่วนตัว และการตรวจสอบต่างๆ ก่อนที่จะเปิดเผยผ่าน HTTPS
กำหนดชื่อแบรนด์ สีที่กำหนดเอง และองค์ประกอบการเข้าสู่ระบบสำหรับการใช้งาน Element Web ของคุณ พร้อมทั้งทำความเข้าใจว่าส่วนใดบ้างที่ยังคงใช้แบรนด์ Element อยู่
ตรวจสอบว่า Synapse ถึงขีดจำกัดการเปิดไฟล์ต่อกระบวนการแล้วหรือไม่ ตั้งค่า systemd drop-in สำหรับบริการหรือ worker ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์