PostgreSQL 덤프를 사용하여 Matrix Synapse를 안전하게 복원하세요
pg_dump를 사용하여 Synapse를 백업하고, 서명 키와 미디어를 보호하고, 오래된 일회용 키를 재사용하지 않고 깨끗한 PostgreSQL 데이터베이스에 복원하세요.
Nginx에서 사용자 지정 Element Web 클라이언트를 호스팅하려면 공식 Element Web 사전 빌드 버전을 다운로드하고, 정적 파일을 웹 서버에 배치하고, config.jsonMatrix 홈서버와 연결하여 구성한 다음, HTTPS를 통해 사이트를 제공하십시오. Nginx는 Element 자체를 실행하지 않습니다. 브라우저 앱 파일을 제공하는 역할을 하며, 앱은 Matrix 홈서버에 별도로 연결됩니다. 클라이언트와 홈서버에 각각 다른 호스트 이름(예: `element.web.com` 및 `element.homeserver.com`)을 사용 chat.example.com하십시오 matrix.example.com.
이 가이드는 Debian 또는 Ubuntu 운영 체제, 공용 DNS 이름을 가진 Nginx 서버, 그리고 HTTPS를 통해 접속 가능한 기존 Matrix 홈 서버를 기준으로 작성되었습니다. 개발 빌드가 아닌 공식 릴리스 아카이브를 사용합니다. Element의 최신 프로젝트 문서에서는 배포된 웹 앱을 정적 콘텐츠로 설명하며, 캐싱을 방지하기 위해 주요 구성 및 진입점 URL이 필요하다고 명시하고 있습니다. 릴리스를 선택하거나 옵션을 변경할 때는 릴리스 노트와 최신 구성 문서를 참조하십시오.
Nginx 서버의 공용 IPv4 주소를 가리키는 A 레코드를 생성합니다 chat.example.com. 서버에 IPv6로 접속 가능한 경우에만 AAAA 레코드를 추가합니다. 호스트 방화벽과 클라우드 방화벽에서 TCP 포트 80과 443의 인바운드 연결을 허용합니다. 이러한 포트가 다른 웹 서버에서 이미 사용 중인지 확인합니다.
Nginx를 설치하고 웹 애플리케이션용 디렉토리를 생성하세요.
sudo apt update
sudo apt install nginx
sudo mkdir -p /var/www/element
다른 컴퓨터에서 Element Web 공식 릴리스 페이지를 열고 게시된 안정 버전을 선택합니다. 해당 버전의 웹 아카이브를 다운로드한 다음 서버로 전송합니다. develop미리 보기 소프트웨어를 실행할 목적이 아니라면 공개 서비스의 경우 브랜치나 나이틀리 빌드를 사용하지 마십시오.
먼저 릴리스 아카이브를 임시 디렉터리에 압축 해제합니다. 아카이브의 최상위 디렉터리 구조를 확인한 후 웹 파일을 해당 디렉터리에 복사합니다 . 이때 릴리스의 디렉터리 구조를 그대로 유지해야 합니다. 패키지 구조는 변경될 수 있으므로 , 번들 파일 , 설정 파일 및 구성 파일이 Nginx의 문서 루트가 가리킬 위치에 있는지 /var/www/element확인하십시오 .index.htmli18n
sudo mkdir -p /tmp/element-release
tar -xzf /tmp/element-web-REPLACE_WITH_RELEASE.tar.gz -C /tmp/element-release
find /tmp/element-release -maxdepth 2 -name index.html
릴리스 콘텐츠를 복사할 때 해당 디렉토리를 index.html소스로 사용하십시오 /var/www/element. 아카이브에 버전이 지정된 최상위 디렉토리가 하나만 있는 경우, 추가적인 중첩 레벨을 생성하는 대신 해당 디렉토리의 내용을 복사하십시오. 새 파일이 완전히 준비될 때까지 운영 중인 배포 환경을 덮어쓰지 마십시오. 불완전한 복사본으로 인해 사용자가 JavaScript 번들을 사용할 수 없게 될 수 있습니다.
config.sample.json아카이브 에 릴리스 파일이 config.json포함되어 있다면 해당 파일을 복사한 다음 새 파일을 편집하세요. Element는 시작하려면 기본 홈서버 연결 설정이 필요합니다. 지원되는 권장 형식은 default_server_config클라이언트 API의 기본 URL을 사용하는 입니다. 아래 예시는 설명용이며, 실제 Matrix 홈서버에서 제공하는 URL로 바꿔야 합니다.
{
"default_server_config": {
"m.homeserver": {
"base_url": "https://matrix.example.com"
}
},
"brand": "Example Chat"
}
Element의 구성 문서에는default_server_name Matrix 검색에 의존하는 옵션도 포함되어 있습니다 .well-known. default_server_config홈서버 URL을 직접 지정하려면 이 옵션을 사용하십시오. 이 공개 JSON 파일에 암호, 액세스 토큰, 서명 키 또는 기타 비밀 정보를 넣지 마십시오. 이 brand옵션은 일부 앱 레이블을 변경하는 것으로, 완전한 화이트 라벨 리브랜딩은 아닙니다.
다음 과 같은 Nginx 서버 블록을 생성합니다 /etc/nginx/sites-available/element. 필요한 경우 도메인을 변경하십시오. 이 간단한 구성은 Element를 정적 파일로 제공하고 누락된 경로를 로 전송하며 index.html모든 응답에 재검증 표시를 합니다. 이러한 보수적인 캐시 정책은 릴리스 후 사용자가 오래된 앱 셸이나 오래된 구성을 받는 것을 방지합니다. 배포 프로세스에서 Element에 필요한 캐시 금지 경로를 유지하는 경우 나중에 자산 캐싱을 조정할 수 있습니다.
server {
listen 80;
listen [::]:80;
server_name chat.example.com;
root /var/www/element;
index index.html;
location / {
try_files $uri $uri/ =404;
add_header Cache-Control "no-cache" always;
add_header X-Frame-Options SAMEORIGIN always;
add_header X-Content-Type-Options nosniff always;
add_header Content-Security-Policy "frame-ancestors 'self'" always;
}
}
/config.*.jsonElement의 웹 호스팅 안내에는 <head> , /i18n<body>, /version<body> 등의 헤더를 캐싱하지 말라고 권고하며 /index.html, 페이지 로드 시 브라우저 재검증을 권장합니다. 이 예시는 no-cache모든 것에 적용 가능한 간단한 시작점입니다. 또한 Element에서 권장하는 프레임 정책 및 MIME 스니핑 방지 기능을 포함한 보안 헤더도 포함되어 있습니다. 이미 다른 곳에서 콘텐츠 보안 정책(CSP)을 정의한 경우, frame-ancestors 'self'충돌하는 정책을 전송하는 대신 해당 정책에 병합하십시오.
사이트를 활성화하고 Nginx의 유효성을 검사한 후 다시 로드하세요.
sudo ln -s /etc/nginx/sites-available/element /etc/nginx/sites-enabled/element
sudo nginx -t
sudo systemctl reload nginx
해당 요소는 HTTPS를 통해 제공되어야 합니다. DNS가 이 서버로 확인되고 80번 포트에 접속할 수 있게 되면, 사용 중인 배포판에 맞는 최신 지침에 따라 Certbot을 설치하고, Nginx 통합 기능을 사용하여 인증서를 요청하고 설치하십시오. Certbot 프로젝트 문서에는 certbot --nginx절차 및 갱신 확인 내용이 자세히 설명되어 있습니다. 패키지 설치는 운영 체제에 따라 다르므로, 사용 중인 버전에 맞는 최신 Nginx 설치 지침을 따르십시오 . Certbot이 서버 블록을 수정하는 경우, sudo nginx -t다시 실행하고 갱신이 예약되었는지 확인하십시오.
개인 정보 보호 모드 브라우저 창에서 여세요 https://chat.example.com. Element 로그인 화면이 스크립트나 스타일 누락 없이 제대로 로드되고, 예상되는 홈서버가 표시되며, 브라우저 주소 표시줄에 유효한 자물쇠 아이콘이 나타나야 합니다. 테스트 계정으로 로그인하여 브라우저가 홈서버에 연결할 수 있는지 확인하세요. 로그인에 실패하면 브라우저 개발자 콘솔과 네트워크 패널에서 차단된 요청, 인증서 오류 또는 잘못된 주소가 있는지 확인하세요 base_url.
root해당 디렉토리를 가리키는지 index.html, 그리고 번들과 i18n디렉토리가 함께 복사되었는지 확인하십시오.config.json하고 파일이 웹 루트에 있는지 확인하십시오. 도메인별 설정을 구성한 경우 config.chat.example.com.jsonElement는 해당 파일을 먼저 시도합니다 config.json. 따라서 파일이 병합되지 않습니다.index.html , version, , 구성 JSON 파일이 캐시되지 않도록 하십시오 i18n. Nginx 정책을 변경한 후에는 브라우저 캐시를 지우거나 다시 검증하십시오.배포가 성공적으로 완료되면 클라이언트는 HTTPS를 통해 사용자 지정 도메인에 접속하고, 구성은 의도한 홈 서버를 가리키며, 테스트 계정은 네트워크 요청 오류 없이 로그인할 수 있어야 합니다. 여기에 설명된 정적 배포 및 서버 블록 동작에 대한 주요 참조 자료는 Element의 웹 호스팅 관련 참고 사항 과 Nginx 인덱스 문서 입니다.
pg_dump를 사용하여 Synapse를 백업하고, 서명 키와 미디어를 보호하고, 오래된 일회용 키를 재사용하지 않고 깨끗한 PostgreSQL 데이터베이스에 복원하세요.
Mjölnir를 전용 Matrix 계정, 암호화된 관리실, Docker Compose, 정책 목록 및 권한 검사와 함께 설정하십시오.
기존 프록시를 건너뛰고 Synapse에 내장된 슬라이딩 동기화 기능을 구성하십시오. 클라이언트 검색을 확인한 다음 호환되는 전화기에서 회의실 목록 로딩 및 재연결 동작을 측정하십시오.
Element Web을 정적 사이트로 배포하고, Matrix 홈서버를 가리키도록 설정하고, HTTPS를 추가하고, Nginx를 구성하여 오래된 파일 없이 업데이트를 제공하도록 하십시오.
64비트 라즈베리 파이 4에 Conduit를 설치하여 영구 데이터 저장, HTTPS 연동, 보호된 회원가입, 그리고 홈서버 작동 여부 확인 기능을 구성합니다.
Element 또는 Matrix API를 사용하여 권한, Synapse 명명 및 연동을 확인하고 Matrix 회의실에 도메인에서 쉽게 공유할 수 있는 주소를 부여하세요.
coturn과 Synapse를 일치하는 TURN 자격 증명으로 구성하고, 필요한 릴레이 포트를 열고, Matrix 클라이언트가 릴레이 후보를 가져올 수 있는지 확인합니다.
Docker Compose, PostgreSQL, 비공개 설정 파일, 그리고 HTTPS를 통해 노출하기 전에 필요한 검사 기능을 사용하여 Synapse 홈 서버를 영구적으로 설정합니다.
Element 웹 배포에 브랜드 이름, 사용자 지정 색상 및 로그인 자산을 설정하는 동시에 Element 브랜드로 유지되는 부분을 파악하세요.
Synapse가 프로세스별 파일 열기 제한에 도달했는지 진단하고, 해당 서비스 또는 워커에 대한 systemd 드롭인을 설정하고, 실제 제한을 확인합니다.