matrix-construct/tuwunel

어떤 프로젝트인가요?

핵심 기능

• 01거의 모든 사용 사례에 맞춰 Matrix Specification을 구현합니다.
• 02RocksDB에 데이터를 저장하며 Conduit 및 conduwuit 데이터베이스에서 그대로 마이그레이션할 수 있습니다.
• 03단일 TOML 파일로 설정하며 비밀 등록 토큰 옵션을 제공합니다.
• 04최초로 등록된 계정이 서버 관리자가 됩니다.
• 05Docker 이미지, 정적 바이너리, Deb, RPM, Nix 패키지로 제공됩니다.

활용 사례

• 가족, 팀 또는 커뮤니티를 위한 비공개 Matrix 채팅 서버 운영.
• 마이그레이션이 지원되는 환경에서 Synapse 배포를 더 가벼운 Rust 기반 홈서버로 교체.
• Matrix 클라이언트, 브리지, 봇을 위한 홈서버 호스팅.
• Debian, Ubuntu, Fedora 또는 NixOS에서 자체 호스팅 Matrix 서버 배포.

빠른 시작

1. 1

   공식 Docker 이미지를 가져옵니다

   docker pull jevolk/tuwunel:latest
2. 2

   또는 소스 코드를 클론합니다

   git clone https://github.com/matrix-construct/tuwunel.git
3. 3

   tuwunel-example.toml을 복사해 편집하고 server_name과 database_path를 설정합니다

4. 4

   서버를 시작하고 클라이언트를 연결해 가입합니다. 가장 먼저 가입한 사용자가 관리자가 됩니다

사용 전 알아둘 점

• !아직 Synapse에서의 마이그레이션은 지원하지 않습니다.
• !server_name은 설정한 후 변경할 수 없으므로 신중하게 선택하세요.

포함된 컬렉션

토픽

자주 묻는 질문

tuwunel은(는) 무엇인가요?

Rust로 작성된 Matrix 홈서버로, Synapse의 대체재이자 conduwuit의 후속 프로젝트입니다. Tuwunel은 전적으로 Rust로 작성된 Matrix 홈서버입니다. 기존 Matrix 클라이언트, 브리지, 봇과 함께 사용할 수 있으며, 극히 특수한 용도를 제외한 대부분의 경우 Matrix Specification을 완전히 구현하는 것을 목표로 합니다. 자체 채팅 서버를 운영하려는 사용자를 위한 저비용 Synapse 대체재로 자리매김하고 있습니다.

tuwunel은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

tuwunel은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

tuwunel은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. tuwunel의 마지막 커밋은 2026년 11월 6일입니다.

tuwunel은(는) 어디에 사용할 수 있나요?

가족, 팀 또는 커뮤니티를 위한 비공개 Matrix 채팅 서버 운영. 마이그레이션이 지원되는 환경에서 Synapse 배포를 더 가벼운 Rust 기반 홈서버로 교체. Matrix 클라이언트, 브리지, 봇을 위한 홈서버 호스팅. Debian, Ubuntu, Fedora 또는 NixOS에서 자체 호스팅 Matrix 서버 배포.

tuwunel는 어떻게 설치하나요?

공식 Docker 이미지를 가져옵니다: docker pull jevolk/tuwunel:latest 또는 소스 코드를 클론합니다: git clone https://github.com/matrix-construct/tuwunel.git tuwunel-example.toml을 복사해 편집하고 server_name과 database_path를 설정합니다 서버를 시작하고 클라이언트를 연결해 가입합니다. 가장 먼저 가입한 사용자가 관리자가 됩니다

tuwunel은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/matrix-construct/tuwunel