dendrite admin interface

dendrite-ผู้ดูแลระบบ-อินเทอร์เฟซ

อินเทอร์เฟซบอตสำหรับการดูแลเซิร์ฟเวอร์ Dendrite โดยใช้ API การดูแลระบบและอินเทอร์เฟซฐานข้อมูลบางส่วน

เรายินดีเป็นอย่างยิ่งที่จะมีส่วนร่วม อย่างไรก็ตาม ขอแนะนำให้คุณเข้าร่วมห้องสนทนาก่อนที่จะมีส่วนร่วมเพื่อให้แน่ใจว่าการมีส่วนร่วมของคุณสอดคล้องกับเป้าหมายสุดท้ายของโครงการ

อย่าลังเลที่จะสร้างปัญหาให้กับฟีเจอร์ที่ร้องขอแต่ละรายการ ดังนั้นเมื่อฉันมีเวลา ฉันจึงมีรายการที่ต้องดำเนินการและทำเครื่องหมาย

Space: #admin-interface:pain.agency | ห้องสนทนา: #admin-interface-support:pain.agency

ตั้งค่า

• ตรวจสอบให้แน่ใจว่าคุณได้ติดตั้งโหนดและ npm เวอร์ชันล่าสุดเพียงครึ่งเดียว ขณะนี้ฉันใช้โหนด v18.18.0 (ตรวจสอบด้วย node -v ) และ npm เวอร์ชัน 9.2.0 บน vps ของฉัน หากคุณใช้งานเดเบียนเหมือนกับที่ฉันทำบน vps คุณอาจต้องการรับโหนดเวอร์ชันที่ทันสมัยมากขึ้นจาก snap store หรือการสร้างจากแหล่งที่มา
• ดาวน์โหลดและแตกไฟล์ .zip หรือ .tar.gz รุ่นเสถียรหรือเบต้าล่าสุดจาก https://github.com/jjj333-p/dendrite-admin-interface/releases หรือโคลนจากสาขา main หากคุณต้องการอยู่ในภาวะ ตกเลือด
• เรียกใช้ npm install ซึ่งควรติดตั้งการขึ้นต่อกันที่จำเป็นทั้งหมด
• คัดลอกไฟล์ที่พบใน examples/login.yaml ไปยัง db/login.yaml และกรอกข้อมูลนั้น มีคำแนะนำในการกรอกข้อมูลนั้นภายในความคิดเห็นของไฟล์ตัวอย่าง
• เรียกใช้บอท ( node index.js )
• คำสั่งมีเฉพาะในห้องผู้ดูแลระบบที่กำหนดไว้ในไฟล์ login.yaml เท่านั้น

คำสั่งที่ใช้งานในปัจจุบัน:

• evacuate User MXID | Room ID | Room Alias> ?<--preserve | -p>

  • เมื่อระบุรหัสห้องหรือนามแฝง อินเทอร์เฟซจะเรียกใช้ตำแหน่งข้อมูลห้องอพยพบนรหัสห้องหรือนามแฝงนั้น ทำให้ผู้ใช้ทั้งหมดบนเซิร์ฟเวอร์นี้ออกจากห้องนั้น หาก ไม่ได้ ระบุแฟล็ก --preserve หรือ -p จุดสิ้นสุดการล้างห้องจะถูกรันด้วย โดยจะล้างสถานะห้องออกจากฐานข้อมูล
  • เมื่อมาพร้อมกับ MXID ของผู้ใช้ภายในเครื่อง เช่น @localpart:your.server อินเทอร์เฟซจะเรียกใช้ตำแหน่งข้อมูลผู้ใช้อพยพบนผู้ใช้นั้น ทำให้บัญชีนั้นออกจากห้องทั้งหมดที่มีอยู่

• passwd <mxid/localpart> <log out accounts?> ?<password>

  รีเซ็ตรหัสผ่านของผู้ใช้

  • mxid/localpart - คุณสามารถระบุ localpart ของผู้ใช้ (เช่น jjj333 ) หรือ mxid ทั้งหมด (เช่น @jjj333:pain.agency ) โปรดทราบว่าจะต้องเป็นผู้ใช้ภายในเครื่อง เนื่องจากไม่มีสิ่งใดที่สามารถทำได้สำหรับผู้ใช้ระยะไกล
  • log out accounts?
    • t หรือ true เพื่อออกจากระบบเซสชันที่เข้าสู่ระบบทั้งหมดของบัญชี
    • f หรือ false เพื่อให้เซสชันทั้งหมดเข้าสู่ระบบ
  • ? password - เลือกตั้งรหัสผ่านเพื่อรีเซ็ตได้ หากไม่มีการระบุรหัสผ่าน ระบบจะใช้สตริง base64 แบบสุ่มขนาด 35 ไบต์ซึ่งจะถูกส่งกลับ เนื่องจาก Dendrite รหัสผ่านต้องมีอักขระอย่างน้อย 8 ตัว เนื่องจากปัญหาทางเทคนิค คุณจึงไม่สามารถเว้นวรรคในรหัสผ่านที่ตั้งค่าผ่านอินเทอร์เฟซนี้ได้

• newaccount <mxid/localpart> ?<password>

  สร้างบัญชีผู้ใช้ปกติใหม่

  • mxid/localpart - ชื่อผู้ใช้ที่จะสร้างให้กับผู้ใช้ นี่อาจเป็นเพียงส่วนท้องถิ่นหรือ mxid แบบเต็มก็ได้
  • ? password - รหัสผ่านที่จะตั้งสำหรับบัญชีใหม่ หากไม่มีการระบุ สตริง base64 ขนาด 35 ไบต์จะถูกสร้างขึ้นและส่งคืน

• deactivate <mxid/localpart>

  ปิดการใช้งานผู้ใช้ที่กำหนด

  • mxid/localpart - คุณสามารถระบุ localpart ของผู้ใช้ (เช่น jjj333 ) หรือ mxid ทั้งหมด (เช่น @jjj333:pain.agency ) โปรดทราบว่าจะต้องเป็นผู้ใช้ภายในเครื่อง เนื่องจากไม่มีสิ่งใดที่สามารถทำได้สำหรับผู้ใช้ระยะไกล
  • ตั้งชื่อที่แสดงและ pfp เป็นชื่อที่กำหนดไว้ในล็อกอินบอท yaml เนื่องจาก dendrite จะไม่ลบสิ่งเหล่านี้ออกก่อนปิดใช้งาน ดังนั้นเราจึงจำเป็นต้องฆ่าเชื้อ และเราสามารถเพิ่มความเก๋ไก๋ให้กับมันได้ในระหว่างนี้
  • จะขอคำยืนยันเพื่อป้องกันการวิ่งโดยไม่ได้ตั้งใจ
  • หมายเหตุ : คำสั่งนี้เป็นคำสั่งถาวร โปรดใช้ด้วยความระมัดระวัง!