clash/
├── index.html              # 前端页面
├── worker.js               # Cloudflare Worker 后端代码
├── wrangler.jsonc          # Wrangler 配置文件
├── _headers                # Cloudflare Pages HTTP头配置
├── .github/
│   └── workflows/
│       └── deploy.yml      # GitHub Actions 部署配置
├── README.md              # 项目说明文档
└── package.json           # 项目配置文件

🚀 빠른 시작

방법 1: 로컬 실행

프로젝트 클론

   git clone 
   cd clash
   ``
로컬 서버 시작
   `bash
   # 使用 Python
   python -m http.server 8000
   
   # 或使用 Node.js
   npx serve .
   `애플리케이션 접속
   브라우저를 열고 http://localhost:8000에 접속하세요.

   로컬 환경에서는 예시 설정이 표시됩니다.
방법 2: Cloudflare Workers 배포
#### 단계 1: Worker 생성
Cloudflare Workers에 접속합니다.

Cloudflare 계정에 가입/로그인합니다.
"Create a Worker"를 클릭합니다.
worker.js의 코드를 전체 복사하여 에디터에 붙여넣습니다.

"Save and Deploy"를 클릭합니다.
#### 단계 2: Wrangler CLI로 배포

bash
安装 Wrangler CLI
npm install -g wrangler
登录到 Cloudflare
wrangler login
部署 Worker
npm run deploy:worker

#### 3단계: 도메인 구성 (선택 사항)
Worker 설정에서 사용자 지정 도메인 추가
또는 Cloudflare에서 제공하는 기본 도메인 사용
방법 3: Cloudflare Pages 배포
#### 옵션 A: GitHub 연동(추천)저장소 준비
   코드를 GitHub 저장소에 푸시
   모든 필요한 파일이 포함되어 있는지 확인
Pages 프로젝트 생성
   Cloudflare Pages 접속
   GitHub 저장소 연결
   프로젝트 저장소 선택
빌드 설정
   빌드 명령: 비워두거나 echo "No build required"

   빌드 출력 디렉토리: /(루트 디렉토리)

   환경 변수: 설정 불필요
#### 옵션 B: 직접 업로드
bash
使用 Wrangler Pages 部署
npm run deploy:pages

🛠️ 기술 아키텍처
프론트엔드 기술 스택
HTML5 - 현대적 마크업 언어
CSS3 - 반응형 디자인 및 애니메이션 효과
Vanilla JavaScript - 경량 프론트엔드 인터랙션
백엔드 기술 스택
Cloudflare Workers - 엣지 컴퓨팅 플랫폼
Web APIs - 표준 Fetch API 및 응답 처리
지원 프로토콜 포맷
VMess - V2Ray 표준 프로토콜
VLESS - V2Ray 경량 프로토콜(Reality 지원)
Shadowsocks - 클래식 프록시 프로토콜
Trojan - 최신 프록시 프로토콜
API 엔드포인트
GET / - 메인 페이지

POST /convert - 구독 변환 API

GET /clash/{config-id} - YAML 설정 파일 가져오기(구독 링크)

GET /yaml/{config-id} - YAML 설정 파일 다운로드

OPTIONS /* - CORS 사전 검사 요청
📖 사용 가이드
기본 사용법
구독 링크 입력

   프록시 구독 링크를 입력란에 붙여넣기
   Base64 인코딩된 구독 링크 지원
설정 파일 이름 지정
   설정 파일에 사용자 정의 이름을 선택적으로 지정 가능
   기본값은 "My Clash Config"
설정 변환
   "구독 변환" 버튼 클릭
   변환 완료까지 기다리기
구성 사용
   생성된 YAML 구성을 복사합니다
   Clash 클라이언트에 가져와서 사용합니다
구독 링크 사용(추천)
   생성된 구독 링크를 복사합니다
   Clash 클라이언트에 구독을 추가합니다
   구성이 자동으로 동기화되며, 수동으로 업데이트할 필요가 없습니다
고급 구성
생성된 Clash 구성에는 다음과 같은 기능이 포함되어 있습니다:
프록시 그룹 정책

  🚀 노드 선택 - 프록시를 수동으로 선택
  ♻️ 자동 선택 - 지연 테스트로 자동 선택
  🎯 글로벌 직결 - 직접 연결
DNS 구성
  DNS 해석 활성화
  fake-ip 모드 지원
  국내/국외 DNS 분리
라우팅 규칙
  로컬 주소 직결
  국내 IP 직결
  기타 트래픽은 프록시를 통해 전달
🔧 배포 문제 해결
자주 묻는 질문
#### 1. Wrangler에서 진입점을 찾을 수 없음
오류 메시지: Missing entry-point to Worker script
해결 방법: 
프로젝트 루트 디렉터리에 wrangler.jsonc 파일이 있는지 확인

wrangler.jsonc에서 main 필드가 worker.js를 가리키고 있는지 확인

#### 2. GitHub Actions 배포 실패
해결 방법:
GitHub 저장소 설정에서 다음 Secrets를 추가하세요:
  CLOUDFLARE_API_TOKEN: Cloudflare API 토큰

  CLOUDFLARE_ACCOUNT_ID: Cloudflare 계정 ID
#### 3. Pages 빌드 실패
해결 방법:
빌드 명령을 비워두거나 echo "No build required"로 설정하세요

빌드 출력 디렉터리가 /로 설정되어 있는지 확인하세요
배포 구성 파일 설명
wrangler.jsonc: Worker 배포를 위한 Wrangler CLI 구성

_headers: Cloudflare Pages HTTP 헤더 구성

.github/workflows/deploy.yml: GitHub Actions 자동 배포 구성
🔧 사용자 정의 구성
프록시 그룹 수정
worker.js 파일의 convertToClash 함수에서 프록시 그룹을 사용자 정의할 수 있습니다:
javascript
'proxy-groups': [
  {
    name: '🚀 节点选择',
    type: 'select',
    proxies: ['♻️ 自动选择', '🎯 全球直连', ...proxyNames]
  },
  // 添加更多代理组...
]

사용자 지정 라우팅 규칙
rules 배열을 수정하여 사용자 지정 라우팅 규칙을 추가합니다:
javascript
rules: [
  'DOMAIN-SUFFIX,youtube.com,🚀 节点选择',
  'DOMAIN-SUFFIX,local,DIRECT',
  // 添加更多规则...
]


📊 성능 특성
글로벌 CDN - Cloudflare의 전 세계 엣지 노드 커버리지
빠른 응답 - 평균 응답 시간 < 100ms
높은 가용성 - 99.9% 서비스 가용성
무료 할당량 - 하루 100,000회 요청
🔒 보안 안내
데이터 프라이버시 - 구독 데이터는 변환 과정에서만 사용되며 저장되지 않음
HTTPS 암호화 - 모든 통신은 HTTPS로 암호화됨
오픈소스 투명성 - 전체 소스코드 공개, 직접 검토 가능
🤝 기여 가이드
Issue 및 Pull Request 제출을 환영합니다!

본 저장소를 Fork

기능 브랜치 생성 (git checkout -b feature/AmazingFeature)

변경 사항 커밋 (git commit -m 'Add some AmazingFeature')

브랜치에 푸시 (git push origin feature/AmazingFeature`)
Pull Request 생성

📝 업데이트 로그

v1.1.0

✅ VLESS 프로토콜 지원 추가(Reality 안전 전송 포함)
✅ 프로토콜 호환성 개선

v1.0.0

✅ 기본 구독 변환 기능
✅ 미려한 사용자 인터페이스
✅ Cloudflare Workers 지원
✅ 다중 프로토콜 지원(VMess, Shadowsocks, Trojan)
✅ 반응형 디자인
✅ 원클릭 복사 기능

📞 지원 및 피드백

사용 중 문제가 발생하거나 제안이 있으시면 다음을 참고하세요:

본 README 문서를 확인하세요
Issue 를 제출하세요
Discussion 을 시작하세요

📄 라이선스

이 프로젝트는 MIT 라이선스를 사용합니다 - 자세한 내용은 LICENSE 파일을 참조하세요

🙏 감사의 말씀

Cloudflare Workers - 엣지 컴퓨팅 플랫폼 제공
Clash - 우수한 프록시 클라이언트
모든 기여자와 사용자들의 지원

---

⭐ 이 프로젝트가 도움이 되었다면 Star를 남겨주세요!

--- Tranlated By Open Ai Tx | Last indexed: 2025-09-06 ---

clash

🚀 Clash 구독 변환기

✨ 기능 특성

📁 프로젝트 구조

🚀 빠른 시작

방법 1: 로컬 실행

`방법 2: Cloudflare Workers 배포`

安装 Wrangler CLI

登录到 Cloudflare

部署 Worker

방법 3: Cloudflare Pages 배포

使用 Wrangler Pages 部署

🛠️ 기술 아키텍처

프론트엔드 기술 스택

백엔드 기술 스택

지원 프로토콜 포맷

API 엔드포인트

`📖 사용 가이드`

`기본 사용법`

`고급 구성`

`🔧 배포 문제 해결`

`자주 묻는 질문`

`배포 구성 파일 설명`

`🔧 사용자 정의 구성`

`프록시 그룹 수정`

사용자 지정 라우팅 규칙

📊 성능 특성

🔒 보안 안내

🤝 기여 가이드

📝 업데이트 로그

v1.1.0

v1.0.0

📞 지원 및 피드백

📄 라이선스

🙏 감사의 말씀