ตั้งค่านามแฝงห้องเมทริกซ์แบบกำหนดเองบนโดเมนของคุณเอง
กำหนดที่อยู่เว็บไซต์ที่แชร์ได้ง่ายให้กับห้อง Matrix บนโดเมนของคุณโดยใช้ Element หรือ Matrix API พร้อมการตรวจสอบสิทธิ์ การตั้งชื่อ Synapse และการเชื่อมโยงระบบ
สำหรับการติดตั้ง Element Web บนเซิร์ฟเวอร์ของคุณเอง ให้ตั้งชื่อแอปและธีมเริ่มต้นในไฟล์ `<app.web>` config.jsonจากนั้นใช้brandingตัวเลือกที่ระบุไว้สำหรับโลโก้การเข้าสู่ระบบ พื้นหลัง ลิงก์โลโก้ และลิงก์ส่วนท้าย สำหรับสีที่กำหนดเอง ให้กำหนดธีมภายใต้ `<app.web>` setting_defaults.custom_themesและชี้default_themeไปยังcustom-ชื่อของธีมนั้น การตั้งค่าเหล่านี้ช่วยปรับแต่ง Element แต่ไม่ได้ทำให้ Element กลายเป็นผลิตภัณฑ์ไวท์เลเบลอย่างสมบูรณ์
การตั้งค่าของ Element จะแยกส่วนต่างๆ ออกจากกัน เช่น เอกลักษณ์ของผลิตภัณฑ์ ธีมสี และเนื้อหาของหน้าเว็บ เลือกการเปลี่ยนแปลงที่เล็กที่สุดที่ช่วยให้บรรลุเป้าหมายของคุณ:
| เป้าหมาย | การกำหนดค่า | สิ่งที่มันเปลี่ยนแปลง |
|---|---|---|
| แสดงชื่อบริการของคุณ | brand | ชื่อแอปในรูปแบบและตำแหน่งต่างๆ |
| ตั้งค่าธีมเริ่มต้นแบบสว่าง มืด หรือแบบกำหนดเอง | default_theme | ธีมสีเริ่มต้นสำหรับการใช้งาน |
| เปลี่ยนรูปแบบการเข้าสู่ระบบและหน้าจอต้อนรับ | branding | โลโก้หน้ายืนยันตัวตน, พื้นหลัง, ลิงก์โลโก้ และลิงก์ส่วนท้าย |
| ตั้งค่าสีและแบบอักษรเองได้ | setting_defaults.custom_themes | ตัวเลือกธีม เช่น โทเค็นสีและตระกูลฟอนต์ |
ตรวจสอบแล้ว:เอกสารของ Element ระบุว่ารองรับการปรับแต่งบางส่วน แต่ไม่รองรับการเปลี่ยนแบรนด์หรือการติดฉลากส่วนตัวทั้งหมดผลกระทบในทางปฏิบัติ:การเปลี่ยนแปลงbrandจะไม่แทนที่โลโก้ ไอคอน รูปภาพ หรือข้อมูลอ้างอิงผลิตภัณฑ์ทั้งหมด หากคุณต้องการเปลี่ยนภาพและข้อความทั้งหมด คุณจะต้องดูแลรักษาเวอร์ชันที่ปรับแต่งเองและตรวจสอบอีกครั้งหลังจากการอัปเกรด เริ่มต้นด้วยการระบุองค์ประกอบ UI ที่ผู้ใช้ของคุณต้องการเห็นอย่างแม่นยำก่อนที่จะเลือกวิธีการปรับแต่งเพียงอย่างเดียว
Element Web จะอ่านconfig.jsonไฟล์นี้เมื่อเริ่มต้นระบบ สำรองไฟล์ปัจจุบันไว้ก่อน แล้วแก้ไขไฟล์ในตำแหน่งเดิม เพื่อให้คุณเก็บการตั้งค่าที่จำเป็น เช่น โฮมเซิร์ฟเวอร์เริ่มต้น สำหรับไฟล์ tarball เวอร์ชันเผยแพร่ ไฟล์จะอยู่ในไดเร็กทอรีเว็บที่ติดตั้งไว้ สำหรับแพ็คเกจ Debian จะใช้/etc/element-web/config.json. หากใช้ Docker ให้เมานต์การกำหนดค่าของคุณที่/app/config.json. ตำแหน่งที่ถูกต้องขึ้นอยู่กับวิธีการติดตั้ง Element ดังนั้นตรวจสอบวิธีการติดตั้งของคุณก่อนแก้ไข
เพิ่มคีย์ต่อไปนี้ลงในออบเจ็กต์ JSON ที่มีอยู่ โดยผสานรวมกับการตั้งค่าที่มีอยู่แล้ว อย่าคัดลอกและวางแทนที่การกำหนดค่าทั้งหมด:
{
"brand": "Northstar Chat",
"default_theme": "dark",
"permalink_prefix": "https://chat.example.org",
"branding": {
"logo_link_url": "https://example.org",
"auth_header_logo_url": "https://chat.example.org/assets/logo.svg",
"welcome_background_url": "https://chat.example.org/assets/welcome.jpg",
"auth_footer_links": [
{ "text": "Help", "url": "https://example.org/help" },
{ "text": "Privacy", "url": "https://example.org/privacy" }
]
}
}
แทนที่ชื่อตัวอย่าง ชื่อโฮสต์ และไฟล์ต่างๆ ด้วยของคุณเอง การเปลี่ยนแปลงนี้ brandจะเปลี่ยนชื่อแอปในหลายๆ ที่ และpermalink_prefixทำให้ลิงก์ถาวรที่ใช้ร่วมกันชี้ไปยังการใช้งาน Element ของคุณแทนที่จะเป็นmatrix.to. รายการโลโก้และพื้นหลังเป็น URL ที่โหลดโดยเบราว์เซอร์ ให้บริการผ่าน HTTPS จากตำแหน่งที่ผู้ใช้ของคุณสามารถเข้าถึงได้ และตรวจสอบให้แน่ใจว่าการควบคุมการเข้าถึง นโยบายความปลอดภัยของเนื้อหา และการแคชไม่ได้บล็อก URL เหล่านั้น เอกสารไม่ได้ระบุขนาดภาพมาตรฐานสำหรับโลโก้การตรวจสอบสิทธิ์ ดังนั้นให้ดูตัวอย่างไฟล์จริงของคุณแทนที่จะสมมติขนาดคงที่
ขึ้นอยู่กับการใช้งาน:ไฟล์การกำหนดค่าจะมีผลต่ออินสแตนซ์ Element Web ที่ให้บริการไฟล์นั้น มันจะไม่เปลี่ยนแปลงapp.element.ioบริการอย่างเป็นทางการหรือเปลี่ยนแปลงแอปมือถือหรือเดสก์ท็อปของ Element โดยอัตโนมัติ โปรดแก้ไขบนโฮสต์หรือคอนเทนเนอร์ที่ให้บริการอินสแตนซ์ของคุณเอง
สำหรับธีมสีและแบบอักษรที่เรียบง่าย Element จะบันทึกคำจำกัดความธีมแบบกำหนดเองไว้ในเอกสาร <meta> setting_defaults.custom_themesชื่อภายในของธีมจะขึ้นต้นด้วย <meta> custom-; ให้ใช้ชื่อเต็มนั้นในdefault_theme<meta> ตัวอย่างนี้แสดงธีมแบบกำหนดเองขนาดกะทัดรัด เป็นเพียงจุดเริ่มต้น ไม่ใช่ชุดสีและแบบอักษรที่สมบูรณ์:
{
"default_theme": "custom-Northstar",
"setting_defaults": {
"custom_themes": [
{
"name": "Northstar",
"is_dark": false,
"fonts": {
"general": "Inter, sans-serif",
"monospace": "'Courier New'"
},
"colors": {
"accent-color": "#3157A4",
"primary-color": "#3157A4",
"warning-color": "#B5473C",
"sidebar-color": "#202A3B",
"roomlist-background-color": "#F3F5F8",
"roomlist-text-color": "#202938",
"timeline-background-color": "#FFFFFF",
"timeline-text-color": "#202938"
}
}
]
}
}
รวมคีย์เหล่านี้เข้ากับ JSON ที่มีอยู่แล้วของคุณ แทนที่จะสร้างsetting_defaultsอ็อบเจ็กต์ที่สอง รักษาความแตกต่างระหว่างข้อความ พื้นหลัง และส่วนควบคุมให้สามารถอ่านได้ชัดเจนทั้งในสถานะปกติและสถานะไฮไลต์ เอกสารอ้างอิงธีมของ Element ประกอบด้วยสีเพิ่มเติมที่เป็นตัวเลือก ชุดสีชื่อผู้ใช้และรูปประจำตัว แบบอักษรที่กำหนดเอง และโทเค็นการออกแบบ Compound เพิ่มเฉพาะค่าที่คุณได้ตรวจสอบแล้วในเอกสารอ้างอิงปัจจุบันเท่านั้น จานสีที่ไม่สมบูรณ์อาจทำให้บางส่วนของอินเทอร์เฟซใช้ค่าเริ่มต้น
ความเข้าใจผิดที่พบบ่อย:การตั้งค่าdefault_themeจะเลือกค่าเริ่มต้นของการใช้งาน ไม่ใช่ว่าเอกสารอธิบายว่าเป็นนโยบายที่ล็อกการตั้งค่าลักษณะที่ปรากฏของผู้ใช้ทุกคน หากคุณต้องการธีมที่บังคับใช้อย่างเคร่งครัด โปรดตรวจสอบพฤติกรรมนั้นกับ Element Web เวอร์ชันที่คุณใช้งานจริง แทนที่จะคิดว่าค่าเริ่มต้นคือการล็อก
สำหรับการทดสอบธีมขณะรันไทม์ บันทึกเกี่ยวกับธีมของ Element อธิบายถึงการโหลด URL ของธีมในรูปแบบ JSON จาก/devtoolsส่วน “ธีมที่กำหนดเอง” ให้ถือว่านี่เป็นขั้นตอนการทดสอบหรือการทำงานฝั่งผู้ใช้ ไม่ใช่การทดแทนการปรับใช้การกำหนดค่าที่ต้องการกับไคลเอนต์ทั้งหมด เพื่อการปรับใช้ที่ยั่งยืน ควรเก็บการกำหนดค่าและไฟล์ต่างๆ ไว้ภายใต้ระบบควบคุมเวอร์ชัน และตรวจสอบซ้ำอีกครั้งเมื่ออัปเกรด Element Web
พฤติกรรมที่อธิบายไว้ในที่นี้เป็นไปตามเอกสารการกำหนดค่าและธีมอย่างเป็นทางการของ Element Web ที่ตรวจสอบเมื่อวันที่ 10 ตุลาคม 2026 โปรดตรวจสอบเอกสารอ้างอิงสำหรับเวอร์ชันที่คุณติดตั้งก่อนที่จะนำการตั้งค่าไปใช้: เอกสารอ้างอิงการกำหนดค่า Element Web , เอกสารธีม Element Webและเอกสารการติดตั้ง Element Web
กำหนดที่อยู่เว็บไซต์ที่แชร์ได้ง่ายให้กับห้อง 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 เต็ม ตั้งค่าการเก็บรักษาข้อมูลสื่ออย่างปลอดภัย และล้างแคชระยะไกลโดยไม่ต้องลบไฟล์โดยตรงจากดิสก์