Repolode
aozorae

aozorae/Edgechat

Cloudflare Workers에서 실행되는 셀프 호스팅 팀 채팅으로, 실시간 메시지, 양방향 Telegram 브리지, 서버 측 암호화를 지원합니다.

대체할 수 있는 제품:SlackDiscord

스타
1,250
포크
476
열린 이슈
2
마지막 커밋
그저께

어떤 프로젝트인가요?

EdgeChat은 Cloudflare에서 전적으로 실행되는 오픈소스 팀 채팅 시스템입니다. 그룹 채팅과 다이렉트 메시지, 음성 메시지, 파일 공유, 일대일 음성 통화를 제공합니다. 앱과 데이터 리소스를 자체 Cloudflare 계정에 배포하고, 배포와 업데이트는 GitHub Actions가 처리하므로 상시 운영하는 서버를 유지할 필요가 없습니다.

그룹을 Telegram 그룹에 연결하면 메시지가 양방향으로 동기화되어 Telegram 사용자가 기존 클라이언트를 계속 사용할 수 있습니다. 별도로 배포한 EdgeChat 인스턴스 두 개도 일회용 초대 코드로 그룹을 연결할 수 있습니다. 실험적인 WebMCP 인터페이스를 사용하면 호환되는 AI 클라이언트가 로그인하고 세션을 읽거나 메시지를 보낼 수 있습니다.

새 메시지 본문과 새로 업로드한 첨부 파일은 AES-256-GCM으로 서버에서 암호화됩니다. 버전이 관리되는 키를 사용하므로 기존 암호문에 영향을 주지 않고 키를 교체할 수 있습니다. 이는 종단 간 암호화가 아니라 서버 측 암호화입니다. Worker가 권한을 확인한 뒤 콘텐츠를 복호화하므로 Cloudflare 환경과 키를 보유한 배포자를 신뢰해야 합니다.

핵심 기능

  • 01WebSocket을 통한 실시간 업데이트를 지원하는 그룹 채팅과 다이렉트 메시지
  • 02텍스트, 이미지, 동영상, 음성, 파일을 지원하는 양방향 Telegram 그룹 브리지
  • 03별도로 배포한 EdgeChat 인스턴스 간 그룹 연결
  • 04새 메시지와 첨부 파일에 적용되는 AES-256-GCM 서버 측 암호화 및 키 교체
  • 05영구 차단과 임시 차단을 지원하는 초대 전용 계정
  • 06Cloudflare Workers, D1, KV, R2, Durable Objects에서 실행되며 GitHub Actions로 배포

활용 사례

  • 자체 서버를 운영하지 않고 셀프 호스팅 채팅을 이용하려는 소규모 팀이나 커뮤니티
  • 이미 Telegram 그룹을 사용하며 별도의 웹 채팅 진입점도 원하는 그룹
  • 각자의 채팅 인스턴스에서 공동 그룹을 운영해야 하는 두 조직
  • WebMCP를 통해 AI 어시스턴트가 채팅방에 참여하도록 하려는 개발자

빠른 시작

  1. 1

    리포지토리를 클론합니다

    git clone https://github.com/aozorae/Edgechat.git
  2. 2

    프로젝트 폴더로 이동합니다

    cd Edgechat
  3. 3

    종속성을 설치합니다

    npm install
  4. 4

    프런트엔드 전용 데모를 시작합니다(클라우드 리소스 필요 없음)

    npm run dev:demo

사용 전 알아둘 점

  • 암호화는 서버 측에서 이루어지며 종단 간 암호화가 아닙니다. Cloudflare와 배포자를 신뢰해야 합니다.
  • 실제 백엔드를 배포하려면 먼저 Cloudflare 리소스와 구성을 설정해야 합니다.
  • MESSAGE_RETENTION_DAYS를 설정하지 않으면 메시지는 기본적으로 15일 후 삭제됩니다.

토픽

자주 묻는 질문

Edgechat은(는) 무엇인가요?
Cloudflare Workers에서 실행되는 셀프 호스팅 팀 채팅으로, 실시간 메시지, 양방향 Telegram 브리지, 서버 측 암호화를 지원합니다. EdgeChat은 Cloudflare에서 전적으로 실행되는 오픈소스 팀 채팅 시스템입니다. 그룹 채팅과 다이렉트 메시지, 음성 메시지, 파일 공유, 일대일 음성 통화를 제공합니다. 앱과 데이터 리소스를 자체 Cloudflare 계정에 배포하고, 배포와 업데이트는 GitHub Actions가 처리하므로 상시 운영하는 서버를 유지할 필요가 없습니다.
Edgechat은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
Edgechat은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
Edgechat은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. Edgechat의 마지막 커밋은 2026년 10월 18일입니다.
Edgechat은(는) 어디에 사용할 수 있나요?
자체 서버를 운영하지 않고 셀프 호스팅 채팅을 이용하려는 소규모 팀이나 커뮤니티 이미 Telegram 그룹을 사용하며 별도의 웹 채팅 진입점도 원하는 그룹 각자의 채팅 인스턴스에서 공동 그룹을 운영해야 하는 두 조직 WebMCP를 통해 AI 어시스턴트가 채팅방에 참여하도록 하려는 개발자
Edgechat는 어떻게 설치하나요?
리포지토리를 클론합니다: git clone https://github.com/aozorae/Edgechat.git 프로젝트 폴더로 이동합니다: cd Edgechat 종속성을 설치합니다: npm install 프런트엔드 전용 데모를 시작합니다(클라우드 리소스 필요 없음): npm run dev:demo
Edgechat은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/aozorae/Edgechat

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트