Cloudflare Workers용 Zeus Panel 자동배포
Cloudflare Workers와 D1 기반으로 자동 배포와 사용자·요금·접속 관리를 제공하는 오픈소스 패널이다.
TL;DR
이 레포는 Cloudflare Workers와 D1 데이터베이스를 활용해 원클릭 배포로 엣지에 패널을 설치하고 사용자별 구독 링크와 사용량 제어를 제공하는 오픈소스 솔루션이다. 설치자는 Cloudflare에서 발급한 API 토큰을 Deployer에 입력하면 워커와 D1가 자동으로 생성되고 초기 관리자 계정과 백업 기능이 함께 구성된다. 패널은 Fragment 제어와 Fingerprint 시뮬레이터로 접속 패턴과 브라우저 지문을 조정할 수 있도록 하여 차단 환경에서의 접속 성공률 제어를 지원하며 실시간 리퀘스트 모니터링과 그룹 작업으로 운영 편의성을 확보한다. 다만 배포된 워커와 필터 우회 설정의 법적·정책적 제약을 사용자가 검토해야 하며 성능 벤치마크 수치는 README에 명시되어 있지 않다. 따라서 빠른 엣지 배포와 상세 사용자 제어가 필요하지만 규제·정책 검토가 가능한 환경에서 채택 가치가 높다.
주요 기능
- 사용자를 볼륨·시간·요청 수·동시 기기로 제한하고 관리할 수 있다. 패널은 각 사용자에 대해 GB 단위 용량, 기간(일), 리퀘스트 상한과 동시 접속 수를 설정할 수 있는 UI를 제공한다. 관리자는 그룹 작업으로 다수 사용자의 설정을 한꺼번에 편집하거나 리셋할 수 있다.
- Fragment와 Fingerprint 시뮬레이션 옵션을 통해 네트워크 필터링을 우회하도록 클라이언트 동작을 조정할 수 있다. 관리 인터페이스에서 Fragment 간격과 길이, 브라우저 지문 템플릿을 선택해 워커 응답을 변조하는 구성을 적용할 수 있다. 이러한 설정은 차단 로직을 회피하기 위한 전송 패턴과 식별자 변조를 동시에 조작하도록 설계되어 있다.
- 원클릭 설치·자동 배포 기능을 제공해 Cloudflare API 토큰 입력만으로 Worker와 D1 데이터베이스를 생성한다. 설치용 Deployer 페이지에서 토큰을 넣고 'Build' 동작을 수행하면 워커와 데이터베이스가 자동으로 프로비저닝되는 흐름이 구현되어 있다. 배포 과정에서 기본 어드민 계정과 초기 비밀번호가 생성되며 백업(Export/Import) 기능을 통해 데이터 이동을 지원한다.
- 사용자별 구독 링크·QR 코드·전용 상태 페이지를 생성해 배포와 모니터링을 간소화한다. 각 계정 카드에서 서브스크립션 링크 복사, QR 생성, 상태 페이지 진입을 바로 수행할 수 있도록 UI가 구성되어 있다. 관리자는 실시간 리퀘스트 카운트와 총 사용량을 대시보드에서 확인해 즉시 대응할 수 있다.
어떻게 동작하는가
설치자는 Cloudflare에서 발급한 API 토큰을 Deployer 인터페이스에 입력하면 자동으로 Worker 스크립트와 D1 데이터베이스를 생성한다. 패널은 Worker가 엣지에서 사용자 인증, 트래픽 계량, 리퀘스트 필터링 및 구독 링크 제공을 수행하도록 구성된 JavaScript 코드와 Tailwind CSS 기반 프런트엔드를 함께 배포한다. Fragment 제어와 Fingerprint 시뮬레이션은 워커 레벨에서 응답 헤더와 전송 패턴을 조정하는 설정값으로 적용되어 실시간 모니터링과 결합된다.
해결 문제
수동으로 Cloudflare Worker와 데이터베이스를 구성하지 않고도 엣지 기반 사용자 관리·구독 배포 인프라를 빠르게 구축하는 문제를 해결한다. 패널은 토큰 입력만으로 워커와 D1를 자동 생성하고 사용자별 용량·기간·요청 한계를 UI에서 관리 가능하게 한다. 또한 구독 링크·QR 코드·상태 페이지를 자동 발급해 최종 사용자 배포 작업을 단순화한다.
지금 주목받는 이유
이 프로젝트는 Cloudflare Workers 기반 원클릭 설치 흐름과 UI 중심의 자동 배포 도구를 탑재해 주목을 받고 있다. README에 표시된 배포 버튼과 자동화 워크플로가 즉시 설치 가능한 체험을 제공하며 GitHub 상의 스타가 눈에 띄는 주요 지표로 표시되어 있다. 또한 Telegram 채널과 연동된 개발자 커뮤니케이션이 활발하게 링크되어 있어 사용자 유입 경로가 확보되어 있다.
차별점
- 원클릭 Deployer로 Cloudflare Workers와 D1를 자동 생성하는 통합 워크플로를 제공한다. 수작업으로 API 호출이나 스크립트 배포를 수행할 필요 없이 설치 페이지의 토큰 입력과 버튼 클릭으로 프로비저닝이 완료된다. 이 자동화는 배포 지연과 설정 실수를 줄여 배포 편의성을 높인다.
- Fragment 제어와 Fingerprint 시뮬레이터를 UI 수준에서 노출해 필터링 회피 구성을 쉽게 적용할 수 있도록 했다. 관리자는 Fragment 간격·길이와 브라우저 지문 템플릿을 선택해 워커 응답을 조정할 수 있으며, 이는 네트워크 차단을 우회하는 세부 파라미터를 직접 설정할 수 있게 한다. 이 조합은 단순 구독 패널보다 더 정교한 접속 회피 옵션을 제공한다.
- 사용자 단위로 구독 링크, QR 코드, 전용 상태 페이지를 자동 생성해 배포와 모니터링을 통합했다. 각 사용자는 패널에서 즉시 링크를 복사하거나 QR로 공유할 수 있으며 관리자는 실시간 리퀘스트와 총 사용량을 대시보드로 확인할 수 있다. 이 기능은 사용자 온보딩과 운영 관리를 동시에 간소화한다.
사용 사례
- 프록시·VLESS 같은 클라이언트 설정을 중앙에서 발급하고 사용량을 계량해야 하는 환경에서 활용할 수 있다. 패널은 사용자별 구독 링크와 QR 코드를 자동 발급하므로 클라이언트가 별다른 수동 설정 없이 연결 정보를 받을 수 있다. 실시간 리퀘스트 모니터링과 리셋 기능으로 운영 중인 사용자 집단을 관리하기 용이하다.
- 제한된 대역폭이나 요청 수 기반 과금 모델을 실현하려는 소규모 서비스 운영자에게 유용하다. 관리자가 각 사용자에 대해 GB 단위 용량과 기간, 요청 상한을 설정할 수 있으므로 사용량 기반 요금제나 체험 계정 정책을 적용하기 적합하다. 백업(Export/Import) 기능으로 계정 데이터를 이관하거나 보관할 수 있다.
- 네트워크 필터링이 엄격한 환경에서 Fragment 및 Fingerprint 시뮬레이션을 이용해 접속 성공률을 높이는 시나리오에서 사용 가능하다. 패널에서 Fragment 패러미터와 지문 템플릿을 조합해 워커의 응답을 변경하면 특정 차단 규칙을 우회할 가능성을 제어할 수 있다. 다만 필터링 우회는 법적·정책적 제약이 있을 수 있으므로 주의가 필요하다.
시작하기
설치 절차는 Deployer 웹페이지로 이동해 Cloudflare API 토큰을 발급·복사한 뒤 해당 토큰을 설치 페이지의 입력란에 붙여넣는 것으로 시작된다. 토큰 입력 후 'Build' 혹은 'ساخت پنل' 버튼을 클릭하면 Worker 스크립트와 D1 데이터베이스가 자동으로 프로비저닝되고 초기 관리자 계정이 생성된다. 배포가 완료되면 관리자 페이지에 로그인해 사용자 생성, Fragment 및 Fingerprint 설정, 구독 링크 발급과 백업 기능을 사용할 수 있다.
요구사항
- Cloudflare 계정과 API 토큰이 필요하며 해당 토큰은 Deployer에서 권한 부여 단계로 발급받아야 한다. 프로젝트는 JavaScript 기반으로 Cloudflare Workers 런타임과 D1 데이터베이스를 사용하므로 별도의 서버 호스팅은 필요하지 않다. 관리자 대시보드 접속과 토큰 발급을 위해 웹 브라우저가 필요하며 초기 비밀번호는 안전하게 보관해야 한다.
이미지 분석




1.2k
Stars
191
Forks
+208
Trending
4
조회수
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.