추측 없이 Synapse의 Systemd 파일 제한을 늘리는 방법
Synapse가 프로세스별 파일 열기 제한에 도달했는지 진단하고, 해당 서비스 또는 워커에 대한 systemd 드롭인을 설정하고, 실제 제한을 확인합니다.
WhatsApp, Telegram, Discord를 연결하려면 각각 별도의 브리지를 실행하고, 각 브리지를 애플리케이션 서비스로 등록한 후, 각 브리지의 고유한 로그인 절차를 따라야 합니다. 성공적인 연결은 각 봇이 인증된 세션을 보고하고, 테스트 메시지가 포털 룸을 통해 양방향으로 전송되는 것을 의미합니다. 봇이 단순히 온라인 상태로 표시되는 것만으로는 충분하지 않습니다.
이 내용은 애플리케이션 서비스를 허용하는 홈서버 관리자를 위한 것입니다. matrix.org 관리자가 제공하는 브리지가 아니면 자체 호스팅 브리지를 추가할 수 없습니다. 직접 관리하는 서버 또는 사용 가능한 호스팅 브리지를 사용하십시오. 프로젝트 문서는 2026년 10월 10일에 검토되었습니다.
이 세 가지 서비스는 각각 고유한 구성, 등록, 데이터베이스 및 로그인 방식을 가진 별개의 서비스입니다. Matrix는 주로 퍼펫팅 방식을 사용합니다. 메시지는 연결된 원격 계정을 통해 전달되어 Matrix에 해당 계정으로 표시됩니다. 릴레이 봇은 이와는 다릅니다. 개인 계정 대신 공유 봇 ID를 사용하려는 경우에만 릴레이 봇을 선택하십시오.
애플리케이션 서비스 기능을 갖춘 홈 서버, 관리자 권한, 그리고 각 브리지와의 네트워크 연결이 필요합니다. Docker 관련 문서가 있으니 참고하세요. 각 브리지에 고유한 데이터 디렉터리를 할당하고, 최신 버전 태그를 선택하세요. Mautrix에서는 latest릴리스 버전이 아닌 최신 커밋을 추적하는 태그를 사용할 수도 있다고 언급합니다.
브리지별로 별도의 데이터베이스를 사용하십시오. PostgreSQL 서버는 공유할 수 있지만, 데이터베이스 자체는 다른 브리지 또는 Synapse와 공유해서는 안 됩니다. 소규모 인스턴스의 경우 SQLite를 사용할 수 있습니다. 포털 회의실에 종단 간 암호화를 적용하려면 로그인 전에 결정해야 합니다. 나중에 기존 포털 회의실에 종단 간 암호화를 활성화하는 것은 어렵습니다.

http://synapse:8008. 애플리케이션 서비스 주소는 해당 브리지의 서비스 이름과 수신 포트를 가리켜야 합니다. localhost브리지 컨테이너 내부에서 `@Bridge.homeserver.com`이 Synapse 또는 다른 브리지가 아닌 해당 컨테이너를 가리키도록 설정하면 일반적으로 통신이 중단됩니다. 홈서버가 Docker 외부에 있는 경우, 필요한 브리지 포트를 게시하거나 라우팅하십시오.homeserver.yaml아래에 해당 파일들의 경로를 추가합니다 . app_service_config_files예를 들면 다음과 같습니다.app_service_config_files:
- /data/appservices/mautrix-whatsapp-registration.yaml
- /data/appservices/mautrix-telegram-registration.yaml
- /data/appservices/mautrix-discord-registration.yaml
Synapse가 Docker에서 실행되는 경우 Synapse 컨테이너 내부에 등록 파일을 마운트하십시오. 목록을 편집한 후에는 Synapse를 다시 시작해야 합니다. YAML 파일의 오타, 잘못된 경로, 읽을 수 없는 마운트 또는 일치하지 않는 브리지 주소로 인해 등록이 실패하거나 Synapse가 시작되지 않을 수 있습니다. 나중에 등록 관련 브리지 설정을 변경하는 경우 해당 등록 파일을 다시 생성하고 Synapse를 다시 시작하십시오.


mautrix-whatsapp을 실행하고 브리지 봇을 통해 Matrix 다이렉트 메시지를 엽니다 @whatsappbot:your.server. 일반적으로 메시지를 보낸 login qr다음 휴대폰의 WhatsApp 연결된 기기 화면에서 QR 코드를 스캔합니다. 봇이 인증을 확인할 때까지 기다립니다. 브리지 문서에 따르면 포털 룸이 나타나는 데 약 1분 정도 걸릴 수 있습니다. WhatsApp은 기기로 연결되므로 독립형 클라우드 계정이 아닙니다. 브리지 문서에 따르면 휴대폰이 2주 이상 오프라인 상태이면 연결된 기기 연결이 끊어집니다. 휴대폰을 항상 활성화 상태로 유지할 수 없는 경우 중요한 채팅에 이 브리지를 사용하기 전에 안정성 요구 사항을 충족하는지 고려해야 합니다.
텔레그램에 로그인하기 전에 my.telegram.org/apps 에서 API 애플리케이션을 생성하고 해당 애플리케이션의 API 값 api_id을 api_hashmautrix-telegram 설정에 추가하세요 . 이러한 API 값은 브리지가 텔레그램 API에 연결하는 데 사용되며, 텔레그램 계정을 직접 인증하는 것은 아닙니다. 그런 다음 메시지를 @telegrambot:your.server보내고 login qr텔레그램 모바일 앱의 설정 > 기기 > 데스크톱 기기 연결에서 코드를 스캔하여 사용하세요. 인증 코드는 SMS 대신 기존 텔레그램 세션으로 전송될 수 있으며, 브리지에서 2단계 인증 비밀번호를 입력하라는 메시지가 나타날 수 있습니다. 이전 메시지 가져오기가 중요한 경우 로그인하기 전에 브리지의 백필 설정을 확인하세요. 포털 채팅방이 생성된 후에는 설정을 변경하기 어려울 수 있습니다.
서버를 운영할 때는 개인 계정 자동화가 아닌 전용 Discord 봇을 사용하세요. Discord는 자체 봇 사용을 금지하며, 적발 시 계정이 정지될 수 있습니다. 개발자 포털에서 애플리케이션과 봇을 생성하고, 브리지에 필요한 권한 있는 인텐트만 활성화한 다음, OAuth2 봇 스코프와 최소한의 채널 권한으로 초대하세요. 인텐트 접근은 정책에 따라 제어되므로, 필요한 메시지 내용이나 멤버 접근 권한이 없으면 일부 기능이 작동하지 않을 수 있습니다. Matrix에서는 DM을 @discordbot:your.server보내 mautrix-discord의 봇 토큰 로그인 지침을 따르세요. 봇은 사용자 계정 브리지처럼 개인 DM 접근 권한을 제공하지 않습니다.

각 브리지 봇에 DM을 보내 인증 상태를 확인하세요. 서비스별로 하나의 포털 룸에서 Matrix에서 테스트 메시지를 보내고 원격 앱에서 답장을 보내세요. 두 메시지가 모두 올바른 룸에 도착했는지 확인하세요. 그룹 또는 Discord 채널의 경우, 먼저 브리지 계정이 존재하고 읽기/게시 권한이 있는지 확인하세요. 로그인 성공만으로는 메시지 전달이 보장되지 않습니다.
봇이 응답하지 않으면 로그에서 누락된 값, 데이터베이스 오류 또는 홈서버 연결 문제를 확인하세요. 로그인은 되지만 채팅방이 표시되지 않으면 포털 및 백필 설정을 확인하세요. Discord 채널 메시지가 누락되면 봇 멤버십, 권한 및 인텐트 접근 권한을 확인하세요. Synapse가 시작되지 않으면 YAML 들여쓰기 및 읽기 가능한 등록 파일 마운트를 확인하세요.
브리지 버전 및 계정 유형에 따라 기능 지원 여부가 다를 수 있습니다. 통화, 반응, 암호화된 채팅, 미디어 및 기록 가져오기 기능은 지원되지 않거나 다를 수 있습니다. 브리지를 유일한 액세스 포인트로 사용하기 전에 각 브리지의 최신 기능 목록을 확인하십시오. 등록 파일 및 자격 증명에 대한 접근을 제한하고, 브리지 데이터를 안전하게 백업하며, 노출된 경우 연결된 세션이나 토큰을 취소하십시오.
최신 Mautrix Docker 지침 , 등록 가이드 , 구성 참조 및 WhatsApp , Telegram , Discord 인증 페이지를 참조하여 버전별 명령어를 확인하십시오. Discord의 자체 봇 정책을 검토하십시오 .
Synapse가 프로세스별 파일 열기 제한에 도달했는지 진단하고, 해당 서비스 또는 워커에 대한 systemd 드롭인을 설정하고, 실제 제한을 확인합니다.
오류가 특정 브라우저 또는 특정 이벤트에만 국한되는지 확인한 다음, Element의 복구 키 또는 신뢰할 수 있는 장치를 사용하여 암호화된 나머지 기록을 손상시키지 않고 복구할 수 있습니다.
Synapse의 기록 및 미디어 삭제 API 또는 보존 설정을 사용하여 오래된 데이터를 안전하게 제거한 다음 완료 여부와 디스크 공간 복구를 확인하십시오.
최신 라이브러리를 설치하고, 전용 Matrix 계정을 연결한 다음, 더욱 안전한 자격 증명 처리와 명확한 테스트를 포함하는 간단한 !echo 봇을 실행하세요.
등록, 로그인 및 테스트가 각각 다른 세 개의 Mautrix 브리지를 설정하여 Docker 네트워킹, 계정 정책 및 동기화 관련 예상치 못한 문제를 방지하세요.
Synapse 저장소를 채우는 항목을 찾고, 안전한 미디어 보존 설정을 지정하고, 디스크에서 파일을 직접 삭제하지 않고 원격 캐시를 정리하세요.
기기 활동을 검토하고, 관리자 API를 통해 비활성으로 확인된 Synapse 계정을 비활성화하고, 선택적 삭제 플래그가 실제로 무엇을 제거하는지 알아보세요.
PostgreSQL 메모리 사용량이 쿼리 작업, 공유 버퍼, 연결 또는 유지 관리 작업 중 어느 것에서 발생하는지 확인한 다음 Synapse에서 안전하게 적용할 수 있는 변경 사항을 적용하세요.
Synapse 설정을 변경하기 전에 Matrix 룸이 원격 홈서버에 느리게 참여하는 원인, 페더레이션 백오프, 로컬 데이터베이스 부하 또는 아웃바운드 발신자 대기열 등을 추적해 보세요.
자체 호스팅 Synapse 서버에서 계정 생성을 중단하거나, 제한된 사용 횟수의 등록 토큰을 사용하여 초대 전용으로 가입을 유지하세요.