ตั้งค่านามแฝงห้องเมทริกซ์แบบกำหนดเองบนโดเมนของคุณเอง
กำหนดที่อยู่เว็บไซต์ที่แชร์ได้ง่ายให้กับห้อง Matrix บนโดเมนของคุณโดยใช้ Element หรือ Matrix API พร้อมการตรวจสอบสิทธิ์ การตั้งชื่อ Synapse และการเชื่อมโยงระบบ
ในการกำหนดที่อยู่ให้กับห้อง 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
https://matrix.example.comขณะที่การกำหนดค่าserver_nameคือexample.comURL ไคลเอ็นต์และชื่อเซิร์ฟเวอร์อาจแตกต่างกันได้supportชื่อเรียกย่อนี้ต้องไม่ซ้ำกันบนเซิร์ฟเวอร์ที่สร้างห้องนั้นขึ้นมาเส้นทางต่อไปนี้ตรงกับคำศัพท์การตั้งค่าห้องในเอกสารการตั้งค่าห้องของ Elementที่ตรวจสอบเมื่อเดือนตุลาคม 2026 ตำแหน่งของเมนูอาจแตกต่างกันไปในแต่ละเวอร์ชันของ Element และไคลเอนต์ Matrix อื่นๆ
ใน Element Web หรือ Element Desktop ให้เปิดห้องปลายทาง เลือกการตั้งค่าห้องจากแผงข้อมูลห้อง หรือใช้เมนูจุดสามจุดของห้องแล้วเลือกการตั้งค่าหากคุณต้องการรหัสห้องภายในสำหรับการแก้ไขปัญหาในภายหลัง ให้ดูใน ส่วน ขั้นสูงและคัดลอกโดยไม่ต้องแก้ไขอักขระใดๆ
ใน หน้าการตั้งค่า ทั่วไปให้ค้นหาที่อยู่ห้องจากนั้นที่อยู่ภายในป้อนชื่อเรียกแทนส่วน localpart เช่นsupportใน ช่อง ที่อยู่ห้องแล้วเลือกเพิ่มหรือปุ่มบันทึกที่เทียบเท่ากัน ตรวจสอบให้แน่ใจว่าที่อยู่แบบเต็มที่ได้คือ#support:example.comหากลงท้ายด้วย ให้:matrix.example.comหยุด: นั่นเป็นปัญหาเกี่ยวกับชื่อโฮมเซิร์ฟเวอร์ ไม่ใช่ข้อผิดพลาดในการพิมพ์ที่การตั้งค่าห้องสามารถแก้ไขได้
ภายใต้หัวข้อ Room Addressesให้ค้นหาPublished Addressesและตั้งค่าMain Addressเป็น#support:example.comเอกสารของ Element ระบุว่าโดยปกติแล้วที่อยู่ภายในเครื่องที่สร้างขึ้นครั้งแรกจะถูกเลือกเป็นที่อยู่หลักโดยอัตโนมัติ การเลือกที่อยู่ดังกล่าวอย่างชัดเจนจะมีประโยชน์เมื่อห้องนั้นมีชื่อเรียกแทนหลายชื่ออยู่แล้ว
ที่อยู่หลักคือ ชื่อเรียกแทนแบบมาตรฐานของห้อง: ที่อยู่ที่ต้องการซึ่งประกาศไว้ในสถานะของห้อง การสร้างชื่อเรียกแทนและการเลือกชื่อเรียกแทนแบบมาตรฐานเป็นกระบวนการที่เกี่ยวข้องกันแต่แตกต่างกัน Matrix ยังรองรับชื่อเรียกแทนทางเลือกอื่นๆ ที่ประกาศไว้ด้วย ชื่อเรียกแทนแบบมาตรฐานควรระบุไปยังห้องนั้นได้ก่อนที่จะประกาศ
เปิดใช้งาน "เผยแพร่ห้องนี้ไปยังไดเร็กทอรีห้องสาธารณะ"เฉพาะเมื่อคุณต้องการให้ค้นพบห้องในไดเร็กทอรีเท่านั้น การตั้งที่อยู่ไม่ได้ทำให้ห้องเป็นสาธารณะโดยอัตโนมัติ และการเผยแพร่ห้องนั้นแยกต่างหากจากกฎการเข้าร่วม ห้องส่วนตัวหรือห้องที่ต้องได้รับเชิญเท่านั้นสามารถตั้งชื่อเล่นที่จำได้ง่ายโดยไม่ต้องให้สิทธิ์ทุกคนเข้าร่วม สำหรับห้องชุมชนสาธารณะ โปรดตรวจสอบทั้งการตั้งค่าไดเร็กทอรีและกฎการเข้าร่วมของห้องก่อนที่จะแชร์ที่อยู่ให้คนอื่นอย่างกว้างขวาง
ผู้ดูแลระบบและเครื่องมืออัตโนมัติสามารถใช้ 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 ที่มีอยู่ขึ้นอยู่กับค่าดังกล่าว สำหรับการติดตั้งใหม่ ให้วางแผนชื่อเซิร์ฟเวอร์ที่ต้องการก่อนที่จะสร้างผู้ใช้และห้อง หากคุณใช้งานภายใต้ชื่ออื่นอยู่แล้ว การใช้โดเมนชื่อเล่นจริงอาจเป็นทางเลือกที่ปลอดภัยกว่า เว้นแต่คุณจะสามารถจัดหาโฮมเซิร์ฟเวอร์ที่มีชื่อเหมาะสมเพื่อเป็นเจ้าของชื่อเล่นใหม่ได้
โดยทั่วไป HTTP 403บ่งชี้ว่าไม่ได้รับอนุญาตหรือมีนโยบายเซิร์ฟเวอร์ที่เกี่ยวข้อง ตรวจสอบสิทธิ์การใช้งานห้องของผู้ใช้และalias_creation_rulesกฎของ Synapse กฎจะถูกประเมินตามลำดับ และรายการที่ว่างเปล่าอย่างชัดเจนจะป้องกันการสร้างนามแฝงทั้งหมด HTTP 409หมายความว่านามแฝงนั้นมีอยู่แล้ว เลือก localpart อื่นหรือตรวจสอบการแมปที่มีอยู่แทนที่จะเขียนทับโดยไม่ตรวจสอบ คู่มือการกำหนดค่า Synapse จะอธิบายตัวเลือกนโยบายนามแฝง
ตรวจสอบก่อนว่านามแฝงนั้นสามารถค้นหาได้ในเครื่องหรือไม่ หากการค้นหาในเครื่องสำเร็จ แต่การค้นหาจากภายนอกล้มเหลว ให้ตรวจสอบการเชื่อมโยงเครือข่ายสำหรับโดเมนนามแฝงรวมถึงใบรับรอง HTTPS /.well-known/matrix/serverการมอบหมายสิทธิ์ที่เกี่ยวข้อง และตัวรับฟังการเชื่อมโยงเครือข่ายที่เปิดเผย ชื่อโฮสต์ที่ใช้สำหรับการรับส่งข้อมูลของไคลเอ็นต์ไม่ได้สร้างการเชื่อมโยงเครือข่ายสำหรับชื่อเซิร์ฟเวอร์ Matrix ที่แตกต่างกันโดยอัตโนมัติAPI ของ Matrix Server-Serverอธิบายถึงการค้นหาเซิร์ฟเวอร์และการมอบหมายสิทธิ์ นอกจากนี้ ให้ยืนยันว่าผู้ใช้ระยะไกลได้รับอนุญาตให้เข้าร่วมหรือไม่ ห้องที่เชิญเท่านั้นอาจค้นหาได้สำเร็จแม้ว่าจะปฏิเสธการเข้าร่วมก็ตาม
#support:example.comปรากฏอยู่ภายใต้"ที่อยู่ภายใน"และ " ที่อยู่หลัก ที่ต้องการ " ใน Element หรือไม่room_idกับ ID ที่แสดงในการตั้งค่าห้องขั้นสูง ของ Elementhttps://matrix.to/#/%23support%3Aexample.comลิงก์ควรจะนำคุณไปยังห้องที่ต้องการ แต่การที่บัญชีนั้นจะสามารถเข้าร่วมได้หรือไม่นั้นขึ้นอยู่กับกฎการเข้าถึงของห้องนั้นด้วยรูปแบบการอ้างอิง room-alias และ matrix.toของ Matrix กำหนดรูปแบบการเข้ารหัสลิงก์การแชร์ หากการตรวจสอบทั้งสามผ่านทั้งหมด ที่อยู่ใหม่จะพร้อมสำหรับการแชร์ ในขณะที่รหัสห้องเดิมยังคงไม่เปลี่ยนแปลง
กำหนดที่อยู่เว็บไซต์ที่แชร์ได้ง่ายให้กับห้อง Matrix บนโดเมนของคุณโดยใช้ Element หรือ Matrix API พร้อมการตรวจสอบสิทธิ์ การตั้งชื่อ Synapse และการเชื่อมโยงระบบ
กำหนดค่า coturn และ Synapse ด้วยข้อมูลรับรอง TURN ที่ตรงกัน เปิดพอร์ตรีเลย์ที่จำเป็น และตรวจสอบว่าไคลเอ็นต์ Matrix สามารถรับผู้สมัครรีเลย์ได้
ตั้งค่าโฮมเซิร์ฟเวอร์ Synapse แบบถาวรด้วย Docker Compose, PostgreSQL, การกำหนดค่าส่วนตัว และการตรวจสอบต่างๆ ก่อนที่จะเปิดเผยผ่าน HTTPS
กำหนดชื่อแบรนด์ สีที่กำหนดเอง และองค์ประกอบการเข้าสู่ระบบสำหรับการใช้งาน Element Web ของคุณ พร้อมทั้งทำความเข้าใจว่าส่วนใดบ้างที่ยังคงใช้แบรนด์ Element อยู่
ตรวจสอบว่า Synapse ถึงขีดจำกัดการเปิดไฟล์ต่อกระบวนการแล้วหรือไม่ ตั้งค่า systemd drop-in สำหรับบริการหรือ worker ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์
ตรวจสอบว่าข้อผิดพลาดนั้นเกิดขึ้นเฉพาะกับเบราว์เซอร์เดียวหรือเหตุการณ์เดียวหรือไม่ จากนั้นใช้รหัสกู้คืนของ Element หรืออุปกรณ์ที่เชื่อถือได้โดยไม่ต้องเสี่ยงกับประวัติการเข้ารหัสที่เหลืออยู่ของคุณ
ใช้ API สำหรับล้างประวัติและสื่อของ Synapse หรือการตั้งค่าการเก็บรักษาข้อมูลเพื่อลบข้อมูลที่ล้าสมัยอย่างปลอดภัย จากนั้นตรวจสอบความสมบูรณ์และการกู้คืนพื้นที่ดิสก์
ติดตั้งไลบรารีเวอร์ชันปัจจุบัน เชื่อมต่อบัญชี Matrix เฉพาะ และเรียกใช้บอท !echo ขนาดเล็กที่มีการจัดการข้อมูลประจำตัวที่ปลอดภัยยิ่งขึ้นและการทดสอบที่ชัดเจน
ตั้งค่าบริดจ์ Mautrix สามตัว โดยแยกการลงทะเบียน การเข้าสู่ระบบ และการทดสอบออกจากกัน เพื่อหลีกเลี่ยงปัญหาที่อาจเกิดขึ้นจากการเชื่อมต่อเครือข่าย Docker นโยบายบัญชี และการซิงค์ข้อมูล
ค้นหาสิ่งที่กำลังทำให้พื้นที่เก็บข้อมูลของ Synapse เต็ม ตั้งค่าการเก็บรักษาข้อมูลสื่ออย่างปลอดภัย และล้างแคชระยะไกลโดยไม่ต้องลบไฟล์โดยตรงจากดิสก์