ตั้งค่านามแฝงห้องเมทริกซ์แบบกำหนดเองบนโดเมนของคุณเอง
กำหนดที่อยู่เว็บไซต์ที่แชร์ได้ง่ายให้กับห้อง Matrix บนโดเมนของคุณโดยใช้ Element หรือ Matrix API พร้อมการตรวจสอบสิทธิ์ การตั้งชื่อ Synapse และการเชื่อมโยงระบบ
สำหรับการโทรผ่าน Matrix ที่ล้มเหลวเมื่อผู้เข้าร่วมอยู่บนเครือข่ายที่แตกต่างกัน ให้ติดตั้ง coturn บนโฮสต์ที่มี IP สาธารณะ เปิดใช้งานข้อมูลรับรอง TURN REST แบบจำกัดเวลา และกำหนดค่า Synapse ด้วยรหัสลับร่วมและ TURN URI เดียวกัน จากนั้นอนุญาตให้ตัวรับฟัง TURN และช่วงรีเลย์ UDP ผ่านไฟร์วอลล์ทุกตัว STUN สามารถช่วยให้ไคลเอนต์ค้นหาเส้นทางเครือข่ายได้ แต่ TURN คือรีเลย์ที่ส่งสื่อเมื่อไม่สามารถสร้างเส้นทางโดยตรงได้
การตั้งค่านี้เหมาะสำหรับโฮมเซิร์ฟเวอร์ Synapse ที่ติดตั้งเอง และโฮสต์ TURN แยกต่างหากที่ใช้ Debian หรือ Ubuntu พร้อมที่อยู่ IPv4 สาธารณะแบบคงที่ ตัวอย่างนี้ใช้ตัวรับฟังเริ่มต้นของ coturn บนพอร์ต 3478 และช่วงรีเลย์ UDP เริ่มต้น 49152–65535 แทนที่โดเมน รหัสลับ และเส้นทางในตัวอย่างด้วยของคุณเอง หาก coturn อยู่หลัง NAT โปรดดูหมายเหตุเกี่ยวกับ NAT ด้านล่าง โฮสต์สาธารณะที่เข้าถึงได้โดยตรงนั้นง่ายกว่าและเชื่อถือได้มากกว่า
สร้างระเบียน DNS A ที่turn.example.comชี้ไปยังที่อยู่ IPv4 สาธารณะของโฮสต์ coturn ใช้ชื่อโฮสต์เฉพาะเพื่อให้สามารถจัดการการตั้งค่าเครือข่ายและใบรับรองได้อย่างอิสระจากบริการเว็บ Matrix อย่าเผยแพร่ระเบียน AAAA เว้นแต่ coturn จะมีการเชื่อมต่อ IPv6 ที่ใช้งานได้และกฎไฟร์วอลล์ที่เกี่ยวข้อง ที่อยู่ IPv6 ที่เข้าถึงไม่ได้อาจทำให้ไคลเอ็นต์บางรายเลือกเส้นทางที่ล้มเหลว
เอกสาร TURN ปัจจุบันของ Synapse ระบุว่าบริการ TURN ต้องการปลายทาง IP สาธารณะ NAT จะทำงานได้ก็ต่อเมื่อเกตเวย์มีที่อยู่สาธารณะและส่งต่อพอร์ตที่จำเป็นอย่างถูกต้องเท่านั้น และเอกสารเตือนว่าการตั้งค่า NAT อาจยังไม่น่าเชื่อถือ โปรดดูเอกสารการตั้งค่า Synapse TURNเพิ่มเติม
บน Debian หรือ Ubuntu ให้ติดตั้งแพ็คเกจการแจกจ่าย:
sudo apt update
sudo apt install coturn
เปิดไฟล์/etc/turnserver.confด้วยโปรแกรมแก้ไขข้อความและกำหนดค่าการตั้งค่าที่สำคัญด้านล่าง สร้างรหัสลับแบบสุ่มที่มีความยาวโดยใช้โปรแกรมจัดการรหัสผ่านหรือตัวสร้างรหัสลับที่มีความปลอดภัยทางด้านการเข้ารหัสลับ ใส่รหัสลับนั้นลงใน Synapse ในภายหลัง ห้ามใช้รหัสผ่านผู้ใช้ Matrix ซ้ำ หรือเปิดเผยรหัสลับในที่เก็บข้อมูลสาธารณะ
listening-port=3478
fingerprint
use-auth-secret
static-auth-secret=REPLACE_WITH_A_LONG_RANDOM_SECRET
realm=turn.example.com
server-name=turn.example.com
min-port=49152
max-port=65535
use-auth-secretและstatic-auth-secretเปิดใช้งานกลไกการรับรองความถูกต้อง TURN REST ที่ Synapse ใช้ในการออกข้อมูลรับรองความถูกต้องชั่วคราวrealmควรเป็นชื่อโดเมนสำหรับบริการ TURN ของคุณ ช่วงพอร์ตรีเลย์แยกต่างหากจากตัวรับฟัง: ไคลเอ็นต์ติดต่อพอร์ต 3478 เพื่อขอการจัดสรร จากนั้นสื่อจะใช้พอร์ตรีเลย์ที่จัดสรรไว้ เอกสาร การกำหนดค่าตัวอย่าง coturnอธิบายตัวเลือกตัวรับฟัง รีเลย์ TLS และ IP ภายนอก ค่าเริ่มต้นและเส้นทางของแพ็คเกจการแจกจ่ายอาจแตกต่างกัน
เปิดใช้งานและเริ่มต้นบริการ จากนั้นตรวจสอบสถานะของบริการ:
sudo systemctl enable --now coturn
sudo systemctl status coturn
หากแพ็กเกจของคุณมีแฟล็กการเปิดใช้งานแยกต่างหากใน/etc/default/coturnไฟล์ ให้ปฏิบัติตามคำแนะนำในไฟล์นั้นก่อนเริ่มบริการ ตรวจสอบบันทึกด้วยคำสั่งsudo journalctl -u coturn -eหากบริการไม่เริ่มต้น
อนุญาตการรับส่งข้อมูล UDP และ TCP ขาเข้าบนพอร์ต 3478 รวมถึงพอร์ต UDP ขาเข้า 49152–65535 ในไฟร์วอลล์ของโฮสต์และไฟร์วอลล์ระดับผู้ให้บริการ ตัวอย่างเช่น สำหรับ UFW:
sudo ufw allow 3478/udp
sudo ufw allow 3478/tcp
sudo ufw allow 49152:65535/udp
sudo ufw status
รักษาระยะการส่งต่อให้แคบที่สุดเท่าที่ระบบของคุณสามารถรองรับได้ และทำให้ coturn ตรง min-portกับmax-portระยะของไฟร์วอลล์ หากคุณเปิดใช้งานตัวรับฟัง TLS ให้เปิดพอร์ตที่กำหนดค่าไว้ด้วย และใช้turns:URI และการตั้งค่าใบรับรองที่ตรงกัน การใช้ TLS บนการเชื่อมต่อ TURN เป็นทางเลือกสำหรับตัวอย่างพื้นฐานนี้ คำแนะนำของ Synapse ระบุว่าสื่อเสียงและวิดีโอ WebRTC ยังคงเข้ารหัสแม้ว่า TURN จะใช้ตัวรับฟัง UDP/TCP แบบธรรมดา ในขณะที่ความปลอดภัยของการส่งสัญญาณขึ้นอยู่กับการตั้งค่า HTTPS ของ Matrix ของคุณ
สำหรับโฮสต์ที่อยู่หลัง NAT ให้กำหนดexternal-ip=PUBLIC_IP/PRIVATE_IPค่าการแมปของ coturn และส่งต่อทั้งพอร์ต 3478 และช่วงรีเลย์ทั้งหมดไปยังโฮสต์ coturn โดยไม่ต้องเปลี่ยนหมายเลขพอร์ตรีเลย์ภายนอก ตัวอย่างเช่น พอร์ตรีเลย์สาธารณะ 52000 ต้องเข้าถึงพอร์ตภายใน 52000 ได้ คำแนะนำของ Synapse ระบุว่า NAT อาจยังคงทำให้เกิดปัญหา หากคุณไม่สามารถส่งต่อช่วง UDP ที่กว้างได้ การวาง coturn บน VPS ที่มี IP สาธารณะมักจะเป็นทางเลือกที่ใช้งานได้จริงมากกว่า
เพิ่มการตั้งค่าต่อไปนี้ลงในไฟล์การกำหนดค่า Synapse ที่ใช้งานอยู่ ซึ่งโดยปกติคือhomeserver.yaml. ตรวจสอบให้แน่ใจว่าชื่อโฮสต์ พอร์ต และรหัสลับตรงกับการกำหนดค่า coturn:
turn_uris:
- "turn:turn.example.com:3478?transport=udp"
- "turn:turn.example.com:3478?transport=tcp"
turn_shared_secret: "REPLACE_WITH_A_LONG_RANDOM_SECRET"
turn_user_lifetime: 86400000
turn_allow_guests: false
ค่าอายุการใช้งานมีหน่วยเป็นมิลลิวินาที ตัวอย่างนี้ขอให้ Synapse ออกข้อมูลประจำตัวที่มีอายุใช้งาน 24 ชั่วโมง ตั้งค่าการเข้าถึงสำหรับผู้เยี่ยมชมตามนโยบายการลงทะเบียนของคุณ ไม่จำเป็นต้องตั้งค่านี้เพื่อเปิดใช้งานการโทรสำหรับผู้ใช้ที่ลงทะเบียนแล้ว รักษาturn_shared_secretความเป็นส่วนตัวและให้เหมือนกับของ coturn static-auth-secretอย่าเพิ่มstun:URI แทน TURN: โปรโตคอลทั้งสองมีบทบาทที่เกี่ยวข้องกันแต่แตกต่างกัน
โปรดรีสตาร์ท Synapse หลังจากตรวจสอบความถูกต้องของไวยากรณ์ YAML แล้ว:
sudo systemctl restart matrix-synapse.service
sudo systemctl status matrix-synapse.service
การใช้งานคอนเทนเนอร์จะต้องอัปเดตการกำหนดค่า Synapse ที่ติดตั้งไว้ และรีสตาร์ทคอนเทนเนอร์ Synapse แทน ไคลเอ็นต์อาจต้องโหลดใหม่หรือรีเฟรชการกำหนดค่าเซิร์ฟเวอร์ Synapse ระบุว่าไคลเอ็นต์อาจใช้เวลาประมาณหนึ่งชั่วโมงในการรีเฟรชการตั้งค่า TURN
ทดสอบจากเบราว์เซอร์หรืออุปกรณ์บนเครือข่ายที่แตกต่างจากเซิร์ฟเวอร์ TURN เช่น โทรศัพท์ที่ใช้ข้อมูลมือถือ ในไคลเอ็นต์ Matrix ที่ทำงานบนเบราว์เซอร์ ให้ตรวจสอบคำขอ homeserver ที่ได้รับการตรวจสอบสิทธิ์แล้ว/_matrix/client/v3/voip/turnServer(ไคลเอ็นต์รุ่นเก่าอาจใช้/r0/เส้นทางเดิม) การตอบสนองควรมี TURN URI และช่องชื่อผู้ใช้/รหัสผ่านชั่วคราว ข้อกำหนดของ Matrix กำหนดการตอบสนองข้อมูลประจำตัวของเอนด์พอยต์นี้
ใช้ข้อมูลประจำตัวเหล่านั้นในการทดสอบ WebRTC Trickle ICE อย่างเป็นทางการ ป้อนเซิร์ฟเวอร์ เช่นturn:turn.example.com:3478?transport=udpและเลือกการทดสอบรีเลย์หากหน้าเว็บมีตัวเลือกการกรองประเภทผู้สมัคร ผลลัพธ์ที่สำเร็จจะรวมถึงผู้สมัครที่มีประเภทเป็นrelayสุดท้าย โทรผ่าน Matrix ระหว่างอุปกรณ์บนเครือข่ายที่แยกจากกัน การโทรที่ดังขึ้นแต่ยังคงแสดงสถานะ “กำลังเชื่อมต่อ” มักบ่งชี้ถึงพอร์ตรีเลย์ที่ถูกบล็อก การแมป NAT ที่ไม่ถูกต้อง หรือข้อมูลประจำตัวที่ไม่ตรงกัน ตรวจสอบบันทึก coturn และบันทึกการแก้ไขปัญหา TURN ของ Synapse ก่อนที่จะเปลี่ยนการตั้งค่าการโทรที่ไม่เกี่ยวข้อง
สำหรับการวินิจฉัยเบราว์เซอร์ Synapse แนะนำให้chrome://webrtc-internals/ใช้ Chrome และabout:webrtcFirefox หากไม่พบรีเลย์แคนดิเดต ให้ตรวจสอบก่อนว่ารหัสลับตรงกันทุกประการ จากนั้นตรวจสอบพอร์ต UDP 3478 และช่วงรีเลย์ทั้งหมดในไฟร์วอลล์ของทั้งโฮสต์และผู้ให้บริการ โครงการ coturn ได้บันทึกตัวเลือกพอร์ตและ IP ภายนอกไว้ในเอกสารอ้างอิง turnserverของ โครงการ
กำหนดที่อยู่เว็บไซต์ที่แชร์ได้ง่ายให้กับห้อง 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 เต็ม ตั้งค่าการเก็บรักษาข้อมูลสื่ออย่างปลอดภัย และล้างแคชระยะไกลโดยไม่ต้องลบไฟล์โดยตรงจากดิสก์