PostgreSQL 덤프를 사용하여 Matrix Synapse를 안전하게 복원하세요
pg_dump를 사용하여 Synapse를 백업하고, 서명 키와 미디어를 보호하고, 오래된 일회용 키를 재사용하지 않고 깨끗한 PostgreSQL 데이터베이스에 복원하세요.
Matrix 관리자 권한이 여러 개인 계정과 방에 분산되어 있는 경우, Mjölnir를 전용 봇으로 실행하고 관리자에게 명령어 관리를 위한 개인 관리 방을 하나 제공하세요. 가장 간단한 자체 호스팅 설정은 Docker Compose, 별도의 Matrix 계정, 그리고 암호화된 관리 방을 사용하는 것입니다. 그런 다음 Mjölnir가 보호해야 할 커뮤니티 방을 추가하고 권한을 확인하면 됩니다.
Mjölnir는 Matrix 운영 체제에서 정책 목록과 운영 조치를 자체 계정처럼 적용하는 관리 봇입니다. 홈서버 는 사용자 계정과 채팅방을 호스팅하는 Matrix 서버입니다. 관리방은 권한 있는 운영자가 봇 명령을 실행하는 비공개 채팅방입니다. 보호방은 Mjölnir가 모니터링하고 관리할 수 있는 채팅방입니다.
이 가이드를 사용하려면 홈서버의 Matrix 계정에 접근 권한이 있어야 하고, 봇 계정 및 방 생성 권한이 있어야 하며, Docker Engine과 Docker Compose 플러그인이 설치된 호스트가 필요합니다. 일반적인 방 관리에는 Mjölnir를 홈서버 관리자로 지정할 필요가 없습니다. 사용자 비활성화 또는 방 폐쇄와 같은 서버 전체 작업에는 Synapse 홈서버와 서버 관리자 권한이 필요하므로, 사용 사례에 필요한 경우가 아니면 해당 권한은 지정하지 마십시오. 자세한 내용은 Mjölnir 공식 저장소를 참조하십시오 .
홈서버 와 같은 곳에 전용 계정을 등록하세요 @mjolnir:example.org. 관리자 개인 계정을 사용하지 마세요. 별도의 계정 정보를 사용하면 접근 권한을 쉽게 순환하고 봇의 활동을 구분할 수 있습니다. 관리자 전용 비공개 방을 만들고, 종단 간 암호화를 활성화한 후, 관리자와 봇을 모두 초대하세요. 신뢰할 수 있는 사람들로만 방의 멤버십을 제한하세요. 설정된 관리 방에 있는 사람은 누구나 명령을 내릴 수 있으며, Mjölnir는 해당 방 내에서 세부적인 명령 권한 설정을 제공하지 않습니다.
Element의 도움말 및 정보 설정 에서 봇의 Matrix 액세스 토큰을 얻으려면 별도의 브라우저 프로필 또는 개인 창에서 봇으로 로그인하십시오 . 토큰을 안전하게 구성 파일에 복사합니다. 로그아웃하지 않고 해당 브라우저 창을 닫습니다. 로그아웃하면 토큰이 무효화됩니다. 공식 설정 문서에서는 관리실에 암호화를 권장하며, 봇이 관리실과 통신할 수 있도록 Mjölnir 구성에서 암호화를 활성화하라고 안내합니다.

Docker 호스트에 영구 데이터 디렉터리를 생성하고 프로젝트의 샘플 구성 파일을 해당 디렉터리에 복사합니다 ./mjolnir/config/production.yaml. 샘플 파일에는 추가 옵션이 설명되어 있으므로 배포에 필요한 값만 설정하십시오. 최소한 홈서버의 클라이언트 API URL, 봇 토큰, 네이티브 암호화 및 관리실의 Matrix 룸 ID 또는 별칭을 사용해야 합니다.
homeserverUrl: "https://matrix.example.org"
accessToken: "YOUR_BOT_ACCESS_TOKEN"
encryption:
use: true
managementRoom: "!roomid:example.org"
모든 예시 값을 바꿔주세요. 방 ID는 !;로 시작하고, 별칭은 .로 시작합니다 . 링크를 #붙여넣지 마세요 . 구성 파일과 토큰은 비밀 정보로 취급하세요. 파일 접근을 제한하고, 소스 코드 관리 시스템에 저장하지 말고, 지원 요청에도 공개하지 마세요. 봇이 관리 방을 해독할 수 없는 경우, 암호화 설정을 다시 확인하고 봇이 방에 참여했는지 확인하세요.matrix.tomanagementRoom

Docker 공식 설명서에서는 matrixdotorg/mjolnir이미지를 사용하고 호스트 디렉터리를 마운트합니다 /data. docker-compose.yml해당 mjolnir디렉터리 옆에 다음 파일을 생성하세요.
services:
mjolnir:
image: matrixdotorg/mjolnir:latest
restart: unless-stopped
volumes:
- ./mjolnir:/data
해당 디렉토리에서 다음 명령으로 Mjölnir를 시작하십시오 docker compose up -d. 마운트된 디렉토리는 컨테이너가 다시 생성될 때 구성 및 봇 데이터를 보존합니다. 공식 가이드에서는 latest예시로 태그를 사용하지만, 프로덕션 서버의 경우 테스트를 거친 릴리스 태그를 선택하고 기록해 두면 의도적인 업그레이드가 가능합니다. 시작 후 다음 명령으로 실행하십시오 docker compose logs -f --tail 100 mjolnir. 관리실에서 Mjölnir의 시작 메시지가 표시될 때까지 기다린 후 다음 단계로 진행하십시오.

관리자 화면에서 봇이 !mjolnir help응답하지 않으면 봇에게 문의하세요. 짧은 코드와 방 별칭 이름을 사용하여 차단 목록을 만든 다음, 해당 목록을 기본 목록으로 설정하세요.
!mjolnir list create COC code-of-conduct-ban-list
!mjolnir default COC
Mjölnir가 목록방을 만들고 당신을 초대합니다. 정책 목록 은 운영 규칙이 포함된 Matrix 방이므로 공유하기 전에 공개 범위와 참여 인원을 확인하세요. Mjölnir가 관리할 커뮤니티 방을 각각 추가하세요.
!mjolnir rooms add #community:example.org
!mjolnir verify
봇이 관리 작업을 수행하려면 보호된 모든 방에서 충분한 권한이 필요합니다. 일반적으로 사용자 차단 및 이벤트 수정 기능이 필요합니다. 방의 권한 수준 설정을 사용하여 필요한 권한만 부여하세요. 이 verify명령어는 Mjölnir 봇이 보호된 방에서 필요한 권한을 가지고 있는지 확인합니다. 방을 보호하기 전에 봇을 방에 추가하세요. 임의로 설정하지 마세요 protectAllJoinedRooms. 이렇게 하면 봇이 참여하는 모든 방으로 보호 범위가 확대되어 방별 선택이 어려워집니다.

docker compose ps 서비스가 실행 중임을 보여주고, 로그에는 반복적인 인증 또는 암호화 오류가 없으며, 봇은 관리실에 시작 상태를 게시합니다.!mjolnir status마십시오 .!mjolnir rules!mjolnir rooms 대상 객실 목록을 제공하고 !mjolnir verify적정 전력 수준을 보고합니다.봇이 아무런 반응을 보이지 않으면 먼저 관리실 ID 또는 별칭이 정확한지, 그리고 봇이 해당 방에 참여 중인지 확인하십시오. 암호화된 방의 경우 암호화가 활성화되어 있고 봇이 메시지를 해독할 수 있는지 확인하십시오. 특정 방에서만 중재가 실패하는 경우 해당 방이 보호되어 있고 권한 수준이 요청된 작업을 허용하는지 확인하십시오. 명령 구문 및 구성 옵션에 대한 자세한 내용은 최신 Mjölnir 중재자 가이드 , Docker 설정 가이드 및 샘플 구성을 참조하십시오 .
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 드롭인을 설정하고, 실제 제한을 확인합니다.