사용자 지정 Matrix Room 별칭을 도메인에 설정하세요
Element 또는 Matrix API를 사용하여 권한, Synapse 명명 및 연동을 확인하고 Matrix 회의실에 도메인에서 쉽게 공유할 수 있는 주소를 부여하세요.
Element Web을 자체 호스팅 방식으로 배포하려면, `<app>` 파일에서 앱 이름과 기본 테마를 설정한 config.json다음, branding로그인 로고, 배경, 로고 링크 및 바닥글 링크에 대해 문서에 설명된 옵션을 사용하십시오. 사용자 지정 색상을 사용하려면 `<theme>` 파일에서 테마를 정의하고 해당 이름을 setting_defaults.custom_themes지정하십시오 . 이러한 설정은 Element를 개인화하는 데 도움이 되지만, 완전한 화이트 라벨 제품으로 만들어주지는 않습니다.default_themecustom-
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를 통해 제공하고, 접근 제어, 콘텐츠 보안 정책 및 캐싱에서 차단되지 않는지 확인하세요. 문서에는 인증 로고에 대한 단일 이미지 크기가 지정되어 있지 않으므로 고정된 크기를 가정하지 말고 실제 자산을 미리 보세요.
배포 환경에 따라 다릅니다. 설정 파일은 해당 인스턴스를 제공하는 Element 웹 인스턴스에 영향을 미칩니다. 공식 서비스나 Element의 모바일 또는 데스크톱 앱은 자동으로 변경되지 않습니다 app.element.io. 인스턴스를 제공하는 호스트 또는 컨테이너에서 설정을 수정하십시오.
간단한 색상 및 글꼴 테마의 경우 Element는 사용자 정의 테마 정의를 문서에 포함합니다 setting_defaults.custom_themes. 테마의 내부 이름은 접두사로 시작하며 custom-, 해당 전체 이름을 사용합니다 default_theme. 이 예는 간결한 사용자 정의 테마를 보여줍니다. 이는 시작점일 뿐이며, 전체 팔레트는 아닙니다.
{
"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의 테마 참조에는 추가적인 선택적 색상, 사용자 이름 및 아바타 색상 배열, 사용자 지정 글꼴, 복합 디자인 토큰이 포함되어 있습니다. 현재 참조에서 검토한 값만 추가하세요. 팔레트가 불완전하면 인터페이스의 일부가 기본값을 사용할 수 있습니다.
흔히 오해하는 부분: 설정은 default_theme배포의 기본값을 선택하는 것이며, 문서에는 모든 사용자의 외관 설정을 잠그는 정책으로 설명되어 있지 않습니다. 엄격하게 테마를 적용해야 하는 경우, 기본값이 잠금이라고 가정하지 말고 사용 중인 Element Web 릴리스 버전에 따라 해당 동작을 확인하십시오.
런타임 테마 테스트를 위해 Element의 테마 관련 설명에는 "사용자 지정 테마"에서 JSON 테마 URL을 로드하는 방법이 나와 있습니다 /devtools. 하지만 이는 테스트 또는 사용자 측 워크플로로 간주해야 하며, 모든 클라이언트에 의도된 구성을 배포하는 것을 대체해서는 안 됩니다. 유지 관리가 용이한 배포를 위해서는 구성 및 자산을 버전 관리 시스템에 보관하고 Element Web을 업그레이드할 때마다 이 검사를 반복하십시오.
여기에 설명된 동작은 2026년 10월 10일에 확인된 Element Web 공식 구성 및 테마 설명서를 따릅니다. 설정을 사용하기 전에 설치된 버전에 대한 참조 자료( Element Web 구성 참조 , Element Web 테마 설명서 및 Element Web 설치 설명서)를 검토하십시오 .
Element 또는 Matrix API를 사용하여 권한, Synapse 명명 및 연동을 확인하고 Matrix 회의실에 도메인에서 쉽게 공유할 수 있는 주소를 부여하세요.
coturn과 Synapse를 일치하는 TURN 자격 증명으로 구성하고, 필요한 릴레이 포트를 열고, Matrix 클라이언트가 릴레이 후보를 가져올 수 있는지 확인합니다.
Docker Compose, PostgreSQL, 비공개 설정 파일, 그리고 HTTPS를 통해 노출하기 전에 필요한 검사 기능을 사용하여 Synapse 홈 서버를 영구적으로 설정합니다.
Element 웹 배포에 브랜드 이름, 사용자 지정 색상 및 로그인 자산을 설정하는 동시에 Element 브랜드로 유지되는 부분을 파악하세요.
Synapse가 프로세스별 파일 열기 제한에 도달했는지 진단하고, 해당 서비스 또는 워커에 대한 systemd 드롭인을 설정하고, 실제 제한을 확인합니다.
오류가 특정 브라우저 또는 특정 이벤트에만 국한되는지 확인한 다음, Element의 복구 키 또는 신뢰할 수 있는 장치를 사용하여 암호화된 나머지 기록을 손상시키지 않고 복구할 수 있습니다.
Synapse의 기록 및 미디어 삭제 API 또는 보존 설정을 사용하여 오래된 데이터를 안전하게 제거한 다음 완료 여부와 디스크 공간 복구를 확인하십시오.
최신 라이브러리를 설치하고, 전용 Matrix 계정을 연결한 다음, 더욱 안전한 자격 증명 처리와 명확한 테스트를 포함하는 간단한 !echo 봇을 실행하세요.
등록, 로그인 및 테스트가 각각 다른 세 개의 Mautrix 브리지를 설정하여 Docker 네트워킹, 계정 정책 및 동기화 관련 예상치 못한 문제를 방지하세요.
Synapse 저장소를 채우는 항목을 찾고, 안전한 미디어 보존 설정을 지정하고, 디스크에서 파일을 직접 삭제하지 않고 원격 캐시를 정리하세요.