Raspberry Pi 4에서 경량 Matrix 홈서버 실행하기

네, 라즈베리 파이 4에서 Conduit를 실행할 수 있으며, 해당 프로젝트에서는 ARM64 빌드를 제공합니다. 소규모 개인 또는 가족용 홈서버를 구축할 경우, 가장 중요한 설정 사항은 64비트 운영체제, 고정된 Matrix 서버 이름, 영구 저장소, 그리고 작동하는 HTTPS 라우팅입니다. Conduit는 현재 베타 버전이므로 최신 버전으로 업데이트하고, 라즈베리 파이 4의 특정 사용자 용량을 가정하지 마십시오. 해당 프로젝트에서는 라즈베리 파이 4의 용량 벤치마크를 제공하지 않습니다.

이 라즈베리 파이에 Conduit가 적합할까요?

Conduit는 RocksDB를 권장 데이터베이스 백엔드로 사용하는 경량 Matrix 홈 서버입니다. 공식 배포 문서에는 aarch64바이너리 이미지와 OCI 이미지가 제공되며, 이는 64비트 Raspberry Pi OS 설치와 일치합니다. 2026년 10월 10일 기준으로 프로젝트 변경 로그에는 2026년 9월 30일자 v0.10.15 버전이 기록되어 있습니다. 이전 버전인 v0.10.14에서는 계정 접근 취약점이 수정되었으며, 즉시 업그레이드할 것을 권장했습니다. 따라서 업데이트 모니터링은 설치 과정의 필수적인 부분이며, 추후 선택 작업이 아닙니다.

Conduit 웹사이트에서는 여전히 이 프로젝트를 베타 버전으로 표시하고 있으며 일부 기능이 누락되었다고 명시하고 있습니다. 따라서 선택하기 전에 현재 제공되는 기능이 필요한 기능을 모두 충족하는지 확인하십시오. 특히 브리지, 고급 관리 기능 또는 광범위한 클라이언트 호환성이 필요한 경우 더욱 그렇습니다. Raspberry Pi는 소규모 배포에는 적합한 호스트이지만, 트래픽, 미디어 사용량 및 페더레이션 활동은 성능에 영향을 미칩니다. 약속된 사용자 수에 의존하기보다는 적은 수의 사용자 그룹으로 시작하여 메모리, 온도 및 저장 공간 사용량을 관찰하는 것이 좋습니다.

설치하기 전에 무엇을 결정해야 할까요?

  • Matrix 서버 이름을 선택하십시오. 이 예에서는 입니다 matrix.example.org. 이 도메인은 사용자의 Matrix ID(예: )에 표시됩니다 @alex:matrix.example.org. 본인이 관리하고 유지할 도메인을 선택하십시오. 나중에 도메인을 변경하려면 호스트 이름만 수정하면 됩니다.
  • 공용 액세스를 계획하십시오. 도메인에 공용 IP 주소를 가리키는 DNS 레코드를 추가하십시오. 유효한 HTTPS 인증서를 사용하여 라우터 포워딩 및 리버스 프록시를 구성하십시오. Conduit의 배포 지침에서는 HTTPS를 요구하며, 검색 및 프록시 구성에 따라 페더레이션 트래픽이 443번 포트 및/또는 8448번 포트에서 접근 가능해야 한다고 명시하고 있습니다.
  • 64비트 Raspberry Pi OS를 사용하십시오. `docker-uniform-shared` 명령어로 아키텍처를 확인하십시오 uname -m. `docker-uniform-shared`가 표시되어야 합니다 aarch64. Docker의 최신 Raspberry Pi 설치 안내에 따르면 향후 Docker Engine 주요 릴리스에서는 32비트 Raspberry Pi OS용 패키지를 더 이상 제공하지 않으며, 64비트 ARM의 경우 Debian arm64설치 지침을 참조하도록 안내하고 있습니다.
  • 데이터베이스를 영구적으로 유지하십시오. Conduit의 데이터를 영구 디렉터리 또는 Docker 볼륨에 저장하고 테스트를 거친 백업 계획에 포함시키십시오. 컨테이너의 쓰기 가능한 레이어나 포맷할 수 있는 이동식 카드에 유일한 복사본을 저장하지 마십시오.

Docker를 사용하여 Conduit를 시작하는 방법은 무엇입니까?

Raspberry Pi OS 버전에 맞는 최신 지침에 따라 Docker Engine과 Compose 플러그인을 설치하세요. 그런 다음 Docker가 실행 중인지 확인합니다. Conduit 문서에는 안정적인 Docker Hub 이미지 registry.gitlab.com/famedly/conduit/matrix-conduit:latest와 ARM64 OCI 이미지가 나와 있습니다. 안정적인 이미지를 다운로드하고 Docker가 ARM64 이미지를 선택했는지 확인하세요.

docker image pull registry.gitlab.com/famedly/conduit/matrix-conduit:latest
docker image inspect registry.gitlab.com/famedly/conduit/matrix-conduit:latest \
  --format '{{.Architecture}}'

보고된 아키텍처가 64비트 운영 체제와 일치하는 경우에만 계속 진행하십시오. 작업 디렉터리와 Compose 파일을 생성하십시오.

mkdir -p ~/matrix-conduit/data
cd ~/matrix-conduit
nano compose.yaml

이 구성을 시작점으로 사용하십시오. 이 구성은 리버스 프록시가 Pi 호스트에서 실행되고 Matrix 요청을 6167번 포트로 전달한다고 가정합니다. 예시 서버 이름을 바꿔주세요. 빈 칸은 CONDUIT_CONFIG컨테이너가 환경 변수를 사용하도록 지시하며, 현재 Conduit Docker 설정 지침에서 요구하는 사항입니다.

services:
  conduit:
    image: registry.gitlab.com/famedly/conduit/matrix-conduit:latest
    container_name: conduit
    restart: unless-stopped
    ports:
      - "127.0.0.1:6167:6167"
    volumes:
      - ./data:/var/lib/matrix-conduit
    environment:
      CONDUIT_CONFIG: ""
      CONDUIT_SERVER_NAME: "matrix.example.org"
      CONDUIT_ADDRESS: "0.0.0.0"
      CONDUIT_PORT: "6167"
      CONDUIT_DATABASE_BACKEND: "rocksdb"
      CONDUIT_ALLOW_REGISTRATION: "true"
      CONDUIT_REGISTRATION_TOKEN: "${CONDUIT_REGISTRATION_TOKEN}"
      CONDUIT_ALLOW_FEDERATION: "true"
      CONDUIT_TRUSTED_SERVERS: '["matrix.org"]'

개인 등록 토큰 파일을 생성하고 서비스를 시작하세요.

umask 077
printf 'CONDUIT_REGISTRATION_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env
docker compose up -d
docker compose logs --tail=100 conduit

토큰은 첫 계정을 등록하는 데 필요합니다. Conduit는 처음 생성된 사용자를 서버 관리자로 지정합니다. 이 .env파일은 비공개로 유지하고 공개 저장소에 커밋하지 마십시오. 예제에서는 Conduit를 Raspberry Pi의 루프백 인터페이스에 바인딩하므로 동일 호스트에서 실행되는 리버스 프록시를 통해서만 접근할 수 있습니다. 프록시가 다른 컨테이너 또는 다른 머신에서 실행되는 경우, 포트 6167을 공개적으로 노출하는 대신 개인 Docker 네트워크 또는 보호된 개인 인터페이스를 사용하십시오.

서버에 접근 가능하고 안전한 환경을 조성하려면 어떻게 해야 할까요?

리버스 프록시를 구성하여 도메인을 HTTPS로 제공하고 Matrix 클라이언트 및 페더레이션 요청( /_matrix/및 포함 /.well-known/matrix/)을 Conduit로 전달하십시오. 가장 간단한 공용 구성은 사용하는 프록시와 페더레이션에서 8448 포트를 사용하는지 또는 443 포트를 통한 위임된 검색을 사용하는지에 따라 달라집니다. Conduit의 Docker 배포 문서에 있는 해당 예제를 따르십시오. 호스트 이름, 인증서 처리 및 네트워크 경로를 수정하지 않고 프록시 코드 조각을 그대로 복사하지 마십시오.

Conduit와 홈서버 URL 에 동일한 도메인을 사용하는 경우 server_name클라이언트가 광고된 HTTPS 엔드포인트에 연결할 수 있는지 확인하십시오. Conduit가 Matrix ID 도메인과 다른 서브도메인에 호스팅되는 경우 위임 가이드에 설명된 대로 두 URL을 모두 구성하십시오 /.well-known/matrix/client. /.well-known/matrix/server포트만 여는 것으로는 검색 또는 TLS가 구성되지 않습니다.

등록 토큰을 지원하는 Matrix 클라이언트를 사용하여 관리자 계정을 즉시 등록하십시오. 다른 사용자가 계정을 생성하도록 의도적으로 허용하지 않는 한, 공개 등록 기능을 비활성화하십시오. Compose에서 CONDUIT_ALLOW_REGISTRATION설정을 변경하고 "false"서비스 환경에서 등록 토큰을 제거한 다음, 명령어를 사용하여 컨테이너를 다시 생성하십시오 docker compose up -d. 바인드 마운트된 데이터 디렉터리는 그대로 유지됩니다. 서버 비밀 키를 노출하거나 변경할 수 있는 사용자를 포함하여, Raspberry Pi의 Docker 소켓 및 구성 파일에 접근할 수 있는 사용자를 검토하십시오.

설치가 제대로 되었는지 어떻게 확인할 수 있나요?

공개 HTTPS 호스트 이름을 통해 로컬 Matrix 클라이언트 API를 확인하세요.

curl -fsS https://matrix.example.org/_matrix/client/versions

JSON 응답은 클라이언트 API에 접근 가능하다는 것을 확인시켜 줄 뿐, 페더레이션이 제대로 작동하고 있다는 것을 증명하는 것은 아닙니다. 서버 이름으로 Matrix Federation Tester 공식 도구를 실행하고, DNS, TLS, 포트 포워딩 또는 기타 .well-known오류를 수정하세요. 마지막으로 새 계정으로 로그인하여 관리자 권한이 있는지 확인하고, 페더레이션이 목표라면 다른 홈서버의 사용자와 채팅방에서 메시지를 주고받으며 테스트해 보세요.

위의 기술 세부 정보는 2026년 10월 10일 Conduit의 공식 Docker, 구성, 위임 및 변경 로그 페이지를 기준으로 확인되었습니다. 릴리스별로 다를 수 있는 세부 정보는 Conduit Docker 배포 가이드 , ARM64 바이너리 및 일반 배포 가이드 , 구성 참조 , 위임 가이드 , Conduit 변경 로그 및 Docker의 Raspberry Pi OS 설치 참고 사항을 참조하십시오 .

댓글 남기기

PostgreSQL 덤프를 사용하여 Matrix Synapse를 안전하게 복원하세요

pg_dump를 사용하여 Synapse를 백업하고, 서명 키와 미디어를 보호하고, 오래된 일회용 키를 재사용하지 않고 깨끗한 PostgreSQL 데이터베이스에 복원하세요.

Docker를 사용하여 Mjölnir를 Matrix Room 관리 봇으로 실행하세요

Docker를 사용하여 Mjölnir를 Matrix Room 관리 봇으로 실행하세요

Mjölnir를 전용 Matrix 계정, 암호화된 관리실, Docker Compose, 정책 목록 및 권한 검사와 함께 설정하십시오.

모바일 로딩 속도 향상을 위해 네이티브 매트릭스 슬라이딩 동기화를 활성화하세요.

모바일 로딩 속도 향상을 위해 네이티브 매트릭스 슬라이딩 동기화를 활성화하세요.

기존 프록시를 건너뛰고 Synapse에 내장된 슬라이딩 동기화 기능을 구성하십시오. 클라이언트 검색을 확인한 다음 호환되는 전화기에서 회의실 목록 로딩 및 재연결 동작을 측정하십시오.

사용자 지정 홈서버를 사용하여 Nginx에서 Host Element Web을 운영합니다.

Element Web을 정적 사이트로 배포하고, Matrix 홈서버를 가리키도록 설정하고, HTTPS를 추가하고, Nginx를 구성하여 오래된 파일 없이 업데이트를 제공하도록 하십시오.

Raspberry Pi 4에서 경량 Matrix 홈서버 실행하기

64비트 라즈베리 파이 4에 Conduit를 설치하여 영구 데이터 저장, HTTPS 연동, 보호된 회원가입, 그리고 홈서버 작동 여부 확인 기능을 구성합니다.

사용자 지정 Matrix Room 별칭을 도메인에 설정하세요

Element 또는 Matrix API를 사용하여 권한, Synapse 명명 및 연동을 확인하고 Matrix 회의실에 도메인에서 쉽게 공유할 수 있는 주소를 부여하세요.

안정적인 Matrix 음성 및 영상 통화를 위해 coturn을 설정하세요.

coturn과 Synapse를 일치하는 TURN 자격 증명으로 구성하고, 필요한 릴레이 포트를 열고, Matrix 클라이언트가 릴레이 후보를 가져올 수 있는지 확인합니다.

Docker Compose 및 PostgreSQL을 사용하여 Matrix Synapse를 배포하세요.

Docker Compose 및 PostgreSQL을 사용하여 Matrix Synapse를 배포하세요.

Docker Compose, PostgreSQL, 비공개 설정 파일, 그리고 HTTPS를 통해 노출하기 전에 필요한 검사 기능을 사용하여 Synapse 홈 서버를 영구적으로 설정합니다.

Element Web의 테마와 브랜딩을 맞춤 설정하세요

Element 웹 배포에 브랜드 이름, 사용자 지정 색상 및 로그인 자산을 설정하는 동시에 Element 브랜드로 유지되는 부분을 파악하세요.

추측 없이 Synapse의 Systemd 파일 제한을 늘리는 방법

추측 없이 Synapse의 Systemd 파일 제한을 늘리는 방법

Synapse가 프로세스별 파일 열기 제한에 도달했는지 진단하고, 해당 서비스 또는 워커에 대한 systemd 드롭인을 설정하고, 실제 제한을 확인합니다.