Done Hub

신규 채널(Provider) 유형

• Codex 리버스 프록시: Codex CLI 및 Codex API를 표준 상류 Provider로 연결합니다.
• Claude Code 리버스 프록시: /v1/messages 등 Claude Code 네이티브 프로토콜을 직접 처리합니다.
• Gemini CLI 리버스 프록시(Channel Type 57): Gemini CLI 클라이언트의 네이티브 요청을 투명하게 전달합니다.
• Antigravity 리버스 프록시(Channel Type 60): daily-cloudcode-pa.googleapis.com 등 대체 엔드포인트를 연결합니다.
• Vertex AI Express(Channel Type 61): 일반 Vertex AI 대비 더 가벼운 연동 경로를 제공합니다.

네이티브 라우트 상호 호환

• 사용자 정의 채널이 Claude 네이티브 라우트(/v1/messages)로 서비스를 제공해 Claude Code를 바로 연결할 수 있습니다.
• Vertex AI 채널이 Gemini 네이티브 라우트(/gemini/*)로 동작해 Gemini CLI를 바로 연결할 수 있고, Claude 네이티브 라우트도 함께 지원합니다.
• Vertex AI는 복수 Region을 등록해 요청 단위로 무작위 로드밸런싱을 수행합니다.
• Google Gemini의 /gemini 라우트는 Veo 시리즈 모델의 네이티브 비디오 생성을 지원하며, gemini-2.0-flash-preview-image-generation의 텍스트·이미지 변환과 OpenAI Chat Completions 호환을 제공합니다.

채널 단위 기능 강화

• /gemini 네이티브 이미지 생성 요청과 Claude 채널(OpenAI 호환/네이티브) 모두 추가 파라미터 패스스루를 지원합니다.
• remove_params는 generationConfig.thinkingConfig 등 중첩 필드 삭제를 지원합니다.
• 모델명 대소문자 무시, 요청/응답 모델명 통일, 모델 리디렉션 키 자동 매핑을 제공합니다.
• 채널 BaseURL에 모델 변수 치환을 적용해 요청 모델 기반으로 상류 주소를 동적으로 조합합니다.
• 빈 응답 과금 여부, 내장 채팅 기능, allow_extra_body 등 채널 단위 동작 토글을 제공합니다.

초대 및 리베이트

• 초대 코드 모듈은 수동/자동 발급, 최대 100개 단위 일괄 생성/삭제, 사용 횟수와 유효 기간, 활성화 상태, 사용 통계를 제공합니다.
• 피초대자 충전 시 초대자에게 정액 또는 비율형 리베이트를 부여하며, 기존 초대赠送额度와 함께 사용 가능합니다.
• 서드파티 로그인과 초대 코드 인증이 분리되어 정책 독립 구성이 가능합니다.

일괄 관리와 데이터 분석

• 채널 일괄 삭제, 여러 채널에 대한 모델 일괄 추가, 사용자 그룹 일괄 추가를 지원합니다.
• 초대 코드, 시스템 로그 등에도 일괄 작업이 보강되었습니다.
• RPM/TPM/CPM 실시간 지표, 연/월/주/일 단위 충전 통계, 시스템 로그 조건 조회와 페이징, CSV 내보내기를 제공합니다.

로그인과 UI

• LinuxDo OAuth 로그인을 추가하고 Trust Level(Basic/Member/Regular/Leader)에 따른 가입/로그인 제한을 지원합니다.
• 시스템 정보 모듈 재구성, OS 다크/라이트 자동 연동, 이메일 규칙 검증, 테이블/아이콘/폼/알림 등 다수 UI 개선이 포함됩니다.

버그 수정 및 안정성

• 과금, 캐시, 통계, 결제, 보안 관련 다수 결정을 수정합니다(예: 사용자 쿼터 캐시와 DB 불일치, 응답 API의 cached_tokens 누락, MySQL 다중 버전의 시간 포맷 불일치, 다중 인스턴스 결제回调, GLM 모델 토큰 부동소수점 처리, CDN 캐시로 인한 API 라우트 권한 상승 등).
• Vertex AI 인증 캐시, 키 캐시 예열, 채널 갱신 즉시 메모리 반영, 재시도/쿨다운 로직, /gemini의 google_search 응답 처리, Alipay/Epay 결제 경로가 최적화됩니다.

설치와 기본 사용

원본 배포 안내에 따라 이미지만을 deanxv/done-hub로 교체해 그대로 배포할 수 있으며, 데이터베이스 호환을 통해 one-hub 사용자는 동일 데이터로 마이그레이션이 가능합니다. Docker 환경에서는 다음 예시를 참고할 수 있습니다.

docker pull deanxv/done-hub:latest

docker run -d 
  --name done-hub 
  -p 3000:3000 
  -e TZ=Asia/Shanghai 
  -v $(pwd)/data:/data 
  deanxv/done-hub:latest

Windows에서는 winget의 deanxv.DoneHub 패키지(포터블, x64)로 동일한 서비스를 설치할 수 있습니다.

제한 및 확인 사항

• 소스 코드는 Apache-2.0 라이선스로 공개되어 있으며, 라이선스 전문은 저장소 내 LICENSE 파일에서 확인할 수 있습니다.
• 배포, 설정, 과금, 모델 가격 등 운영 세부 항목은 원본 one-hub 문서(https://one-hub-doc.vercel.app/)를 함께 참조하도록 안내됩니다.