ตั้งค่านามแฝงห้องเมทริกซ์แบบกำหนดเองบนโดเมนของคุณเอง

ในการกำหนดที่อยู่ให้กับห้อง Matrix เช่น#support:example.comให้สร้างนามแฝงห้องในเครื่องโฮมเซิร์ฟเวอร์ โดยกำหนดชื่อเซิร์ฟเวอร์เป็นexample.comจากนั้นเลือกนามแฝงนั้นเป็นที่อยู่หลักของห้องใน Element คุณไม่จำเป็นต้องมีระเบียน DNS แยกต่างหากสำหรับแต่ละนามแฝงห้อง แต่คุณไม่สามารถเปลี่ยนโดเมนนามแฝงของโฮมเซิร์ฟเวอร์ที่มีอยู่ได้เพียงแค่ชี้ DNS ไปที่โดเมนนั้น

ทำความเข้าใจว่าโดเมนแบบกำหนดเองควบคุมอะไรบ้าง

ชื่อเรียกแทนห้อง (Room Alias)คือที่อยู่แบบอ่านได้ซึ่งแปลงเป็นรหัสห้องถาวร (Permanent Room ID) ของห้องในระบบ Matrix ซึ่งโดยปกติจะขึ้นต้นด้วย!`.` หนึ่งห้องสามารถมีชื่อเรียกแทนได้หลายชื่อ เช่น `.` #support:example.comและ#help:example.com`.` ซึ่งทั้งสองชื่อชี้ไปยังห้องเดียวกัน ข้อความหลังเครื่องหมายโคลอน (:) จะระบุเซิร์ฟเวอร์หลักที่รับผิดชอบในการแปลงชื่อเรียกแทนนั้น ไม่จำเป็นต้องเป็นเซิร์ฟเวอร์ที่โฮสต์ผู้เข้าร่วมทุกคน

Matrix กำหนดชื่อแทนในรูปแบบ <alias> #localpart:server-nameสำหรับ Synapse server_nameการตั้งค่านี้จะกำหนดโดเมนที่ใช้สำหรับที่อยู่ห้องที่สร้างขึ้นในเครื่อง และ Synapse ระบุว่าการตั้งค่านี้ไม่สามารถเปลี่ยนแปลงได้หลังจากการตั้งค่าเริ่มต้น หากเซิร์ฟเวอร์ที่มีอยู่ของคุณชื่อ <alias> matrix.example.comElement จะไม่เปลี่ยนชื่อแทนในเครื่องเป็น <alias> #support:example.comเพียงเพราะคุณเป็นเจ้าของ <alias> example.comโปรดดูรายละเอียดตัวระบุของ Matrixและคู่มือการกำหนดค่า Synapse

ตรวจสอบข้อกำหนดเบื้องต้น

  • ตัวอย่าง การใช้งานโฮมเซิร์ฟเวอร์ Matrix:ตัวอย่างนี้สมมติว่า Synapse กำลังให้บริการคำขอ API ของไคลเอ็นต์อยู่แล้ว ในhttps://matrix.example.comขณะที่การกำหนดค่าserver_nameคือexample.comURL ไคลเอ็นต์และชื่อเซิร์ฟเวอร์อาจแตกต่างกันได้
  • ห้องที่มีอยู่แล้ว:หากจำเป็น ให้สร้างห้องก่อน กำหนดชื่อเรียกย่อที่สั้นและจำง่าย เช่นsupportชื่อเรียกย่อนี้ต้องไม่ซ้ำกันบนเซิร์ฟเวอร์ที่สร้างห้องนั้นขึ้นมา
  • สิทธิ์ในการจัดการที่อยู่:เข้าสู่ระบบด้วยบัญชีที่ได้รับอนุญาตให้สร้างนามแฝงในพื้นที่และเปลี่ยนที่อยู่หลักของห้อง นโยบายการสร้างนามแฝงของเซิร์ฟเวอร์และระดับอำนาจของห้องอาจจำกัดการกระทำเหล่านี้
  • วิธีทดสอบ:ควรมีบัญชี Matrix สำรองไว้หนึ่งบัญชี โดยควรอยู่บนโฮมเซิร์ฟเวอร์อีกเครื่องหนึ่ง เพื่อให้คุณสามารถตรวจสอบการค้นหาได้โดยอิสระจากเซสชันผู้ดูแลระบบของคุณ

สร้างชื่อแทน (Alias) ใน Element Web

เส้นทางต่อไปนี้ตรงกับคำศัพท์การตั้งค่าห้องในเอกสารการตั้งค่าห้องของ Elementที่ตรวจสอบเมื่อเดือนตุลาคม 2026 ตำแหน่งของเมนูอาจแตกต่างกันไปในแต่ละเวอร์ชันของ Element และไคลเอนต์ Matrix อื่นๆ

1. เปิดการตั้งค่าห้อง

ใน Element Web หรือ Element Desktop ให้เปิดห้องปลายทาง เลือกการตั้งค่าห้องจากแผงข้อมูลห้อง หรือใช้เมนูจุดสามจุดของห้องแล้วเลือกการตั้งค่าหากคุณต้องการรหัสห้องภายในสำหรับการแก้ไขปัญหาในภายหลัง ให้ดูใน ส่วน ขั้นสูงและคัดลอกโดยไม่ต้องแก้ไขอักขระใดๆ

2. เพิ่มที่อยู่ท้องถิ่น

ใน หน้าการตั้งค่า ทั่วไปให้ค้นหาที่อยู่ห้องจากนั้นที่อยู่ภายในป้อนชื่อเรียกแทนส่วน localpart เช่นsupportใน ช่อง ที่อยู่ห้องแล้วเลือกเพิ่มหรือปุ่มบันทึกที่เทียบเท่ากัน ตรวจสอบให้แน่ใจว่าที่อยู่แบบเต็มที่ได้คือ#support:example.comหากลงท้ายด้วย ให้:matrix.example.comหยุด: นั่นเป็นปัญหาเกี่ยวกับชื่อโฮมเซิร์ฟเวอร์ ไม่ใช่ข้อผิดพลาดในการพิมพ์ที่การตั้งค่าห้องสามารถแก้ไขได้

3. เลือกที่อยู่หลัก

ภายใต้หัวข้อ Room Addressesให้ค้นหาPublished Addressesและตั้งค่าMain Addressเป็น#support:example.comเอกสารของ Element ระบุว่าโดยปกติแล้วที่อยู่ภายในเครื่องที่สร้างขึ้นครั้งแรกจะถูกเลือกเป็นที่อยู่หลักโดยอัตโนมัติ การเลือกที่อยู่ดังกล่าวอย่างชัดเจนจะมีประโยชน์เมื่อห้องนั้นมีชื่อเรียกแทนหลายชื่ออยู่แล้ว

ที่อยู่หลักคือ ชื่อเรียกแทนแบบมาตรฐานของห้อง: ที่อยู่ที่ต้องการซึ่งประกาศไว้ในสถานะของห้อง การสร้างชื่อเรียกแทนและการเลือกชื่อเรียกแทนแบบมาตรฐานเป็นกระบวนการที่เกี่ยวข้องกันแต่แตกต่างกัน Matrix ยังรองรับชื่อเรียกแทนทางเลือกอื่นๆ ที่ประกาศไว้ด้วย ชื่อเรียกแทนแบบมาตรฐานควรระบุไปยังห้องนั้นได้ก่อนที่จะประกาศ

4. ตัดสินใจว่าห้องนั้นควรอยู่ในรายชื่อสถานที่หรือไม่

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

หากไคลเอ็นต์ไม่สามารถเพิ่มที่อยู่ได้ ให้ใช้ Matrix API

ผู้ดูแลระบบและเครื่องมืออัตโนมัติสามารถใช้ API ไคลเอ็นต์-เซิร์ฟเวอร์มาตรฐาน ของ Matrix ได้ ตัวอย่างด้านล่างสร้างนามแฝงเดียวกัน อย่าเรียกใช้หากสร้าง Element ไว้แล้ว#support:example.comแทนที่ด้วยรหัสห้องจริงและโทเค็นการเข้าถึงที่ถูกต้องสำหรับผู้ใช้ที่ได้รับอนุญาตตามนโยบายนามแฝงของโฮมเซิร์ฟเวอร์ ให้ถือว่าโทเค็นเป็นรหัสผ่าน

curl --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --data '{"room_id":"!yourRoomId:example.com"}' \
  'https://matrix.example.com/_matrix/client/v3/directory/room/%23support%3Aexample.com'

การร้องขอที่สำเร็จจะส่งคืน HTTP 200พร้อมออบเจ็กต์ JSON ว่างเปล่า ส่วน <name> %23และ%3A<room> คือการเข้ารหัส URL สำหรับ <name> #และ:<room> การร้องขอ PUT จะสร้างการแมปชื่อแทนไปยังห้อง ซึ่งไม่ได้เปลี่ยนแปลงชื่อแทนหลักของห้องเสมอไป หลังจากสร้างห้องผ่าน API แล้ว ให้กลับไปที่ ส่วนควบคุม ที่อยู่หลัก ของ Element หากคุณต้องการให้ชื่อแทนนั้นถูกประกาศเป็นชื่อแทนหลัก อย่าคัดลอกโทเค็น Bearer จริงลงในคำสั่ง Shell ที่ใช้ร่วมกัน ภาพหน้าจอ หรือตั๋วสนับสนุน

ตรวจสอบว่าการแมปนั้นสำเร็จแล้ว

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

curl --fail-with-body --silent --show-error \
  'https://matrix.example.com/_matrix/client/v3/directory/room/%23support%3Aexample.com'

คำตอบควรประกอบด้วยroom_idห้องปลายทางที่ตรงกันและserversอาร์เรย์ การทดสอบนี้ตรวจสอบการแก้ไขนามแฝง ไม่ใช่ตรวจสอบว่าเซิร์ฟเวอร์ระยะไกลทุกเครื่องสามารถเชื่อมต่อกับเซิร์ฟเวอร์ของคุณได้หรือไม่

แก้ไขปัญหาความล้มเหลวทั่วไป

ชื่อแทนมีโดเมนที่ไม่ถูกต้อง

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

การสร้างล้มเหลวด้วยข้อผิดพลาด 403 หรือ 409

โดยทั่วไป HTTP 403บ่งชี้ว่าไม่ได้รับอนุญาตหรือมีนโยบายเซิร์ฟเวอร์ที่เกี่ยวข้อง ตรวจสอบสิทธิ์การใช้งานห้องของผู้ใช้และalias_creation_rulesกฎของ Synapse กฎจะถูกประเมินตามลำดับ และรายการที่ว่างเปล่าอย่างชัดเจนจะป้องกันการสร้างนามแฝงทั้งหมด HTTP 409หมายความว่านามแฝงนั้นมีอยู่แล้ว เลือก localpart อื่นหรือตรวจสอบการแมปที่มีอยู่แทนที่จะเขียนทับโดยไม่ตรวจสอบ คู่มือการกำหนดค่า Synapse จะอธิบายตัวเลือกนโยบายนามแฝง

ผู้เล่นในเซิร์ฟเวอร์อื่นไม่สามารถหาห้องได้

ตรวจสอบก่อนว่านามแฝงนั้นสามารถค้นหาได้ในเครื่องหรือไม่ หากการค้นหาในเครื่องสำเร็จ แต่การค้นหาจากภายนอกล้มเหลว ให้ตรวจสอบการเชื่อมโยงเครือข่ายสำหรับโดเมนนามแฝงรวมถึงใบรับรอง HTTPS /.well-known/matrix/serverการมอบหมายสิทธิ์ที่เกี่ยวข้อง และตัวรับฟังการเชื่อมโยงเครือข่ายที่เปิดเผย ชื่อโฮสต์ที่ใช้สำหรับการรับส่งข้อมูลของไคลเอ็นต์ไม่ได้สร้างการเชื่อมโยงเครือข่ายสำหรับชื่อเซิร์ฟเวอร์ Matrix ที่แตกต่างกันโดยอัตโนมัติAPI ของ Matrix Server-Serverอธิบายถึงการค้นหาเซิร์ฟเวอร์และการมอบหมายสิทธิ์ นอกจากนี้ ให้ยืนยันว่าผู้ใช้ระยะไกลได้รับอนุญาตให้เข้าร่วมหรือไม่ ห้องที่เชิญเท่านั้นอาจค้นหาได้สำเร็จแม้ว่าจะปฏิเสธการเข้าร่วมก็ตาม

ตรวจสอบที่อยู่ห้องที่กำหนดเอง

  1. ตรวจสอบว่า#support:example.comปรากฏอยู่ภายใต้"ที่อยู่ภายใน"และ " ที่อยู่หลัก ที่ต้องการ " ใน Element หรือไม่
  2. เรียกใช้คำขอ GET สำหรับไดเร็กทอรีที่ไม่ได้รับการตรวจสอบสิทธิ์ตามขั้นตอนด้านบน และเปรียบเทียบroom_idกับ ID ที่แสดงในการตั้งค่าห้องขั้นสูง ของ Element
  3. ลองเปิดจากบัญชีอื่นดูhttps://matrix.to/#/%23support%3Aexample.comลิงก์ควรจะนำคุณไปยังห้องที่ต้องการ แต่การที่บัญชีนั้นจะสามารถเข้าร่วมได้หรือไม่นั้นขึ้นอยู่กับกฎการเข้าถึงของห้องนั้นด้วย

รูปแบบการอ้างอิง room-alias และ matrix.toของ Matrix กำหนดรูปแบบการเข้ารหัสลิงก์การแชร์ หากการตรวจสอบทั้งสามผ่านทั้งหมด ที่อยู่ใหม่จะพร้อมสำหรับการแชร์ ในขณะที่รหัสห้องเดิมยังคงไม่เปลี่ยนแปลง

ฝากความเห็น

ตั้งค่านามแฝงห้องเมทริกซ์แบบกำหนดเองบนโดเมนของคุณเอง

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

หากพบข้อความ “ถอดรหัสไม่สำเร็จ” ให้กู้คืนรหัสห้องที่หายไป

หากพบข้อความ “ถอดรหัสไม่สำเร็จ” ให้กู้คืนรหัสห้องที่หายไป

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

ล้างข้อความและไฟล์มีเดียเก่าๆ ของ Synapse โดยไม่สูญเสียข้อมูล

ใช้ API สำหรับล้างประวัติและสื่อของ Synapse หรือการตั้งค่าการเก็บรักษาข้อมูลเพื่อลบข้อมูลที่ล้าสมัยอย่างปลอดภัย จากนั้นตรวจสอบความสมบูรณ์และการกู้คืนพื้นที่ดิสก์

สร้างบอท Matrix Echo ในภาษา Python โดยใช้ Simple-Matrix-Bot-Lib

สร้างบอท Matrix Echo ในภาษา Python โดยใช้ Simple-Matrix-Bot-Lib

ติดตั้งไลบรารีเวอร์ชันปัจจุบัน เชื่อมต่อบัญชี Matrix เฉพาะ และเรียกใช้บอท !echo ขนาดเล็กที่มีการจัดการข้อมูลประจำตัวที่ปลอดภัยยิ่งขึ้นและการทดสอบที่ชัดเจน

เชื่อมต่อ Matrix กับ WhatsApp, Telegram และ Discord ด้วยบริดจ์แยกต่างหาก

เชื่อมต่อ Matrix กับ WhatsApp, Telegram และ Discord ด้วยบริดจ์แยกต่างหาก

ตั้งค่าบริดจ์ Mautrix สามตัว โดยแยกการลงทะเบียน การเข้าสู่ระบบ และการทดสอบออกจากกัน เพื่อหลีกเลี่ยงปัญหาที่อาจเกิดขึ้นจากการเชื่อมต่อเครือข่าย Docker นโยบายบัญชี และการซิงค์ข้อมูล

เรียกคืนพื้นที่ดิสก์ Synapse Media โดยไม่ทำให้ไฟล์ที่แชร์เสียหาย

ค้นหาสิ่งที่กำลังทำให้พื้นที่เก็บข้อมูลของ Synapse เต็ม ตั้งค่าการเก็บรักษาข้อมูลสื่ออย่างปลอดภัย และล้างแคชระยะไกลโดยไม่ต้องลบไฟล์โดยตรงจากดิสก์