Community코딩 & 개발github.com

jedliuai/vps-proxy-skill

Codex 스킬: VPS 에 자동으로 프록시(과학적 인터넷 접속)를 구축합니다. Hysteria2, Trojan, VLESS REALITY 지원; Clash/Mihomo, V2Ray/Shadowrocket 구독; SSH 안내, Cloudflare 옵션 및 장애 복구. 자체 호스팅 프록시 자동화.

vps-proxy-skill란 무엇인가요?

이 스킬은 AI 코딩 에이전트(Codex, Claude Code 등)가 VPS 상에서 프록시 서비스를 자동으로 구축, 진단 및 복구할 수 있도록 설계된 포괄적인 도구입니다. Hysteria2, Trojan, VLESS REALITY 와 같은 최신 프로토콜을 지원하며, Clash/Mihomo 및 V2Ray/Shadowrocket 용 구독 링크를 생성합니다. Cloudflare 를 통한 CDN 우회 및 Workers 기반 구독 관리를 선택적으로 지원합니다. 주요 기능으로는 SSH 를 통한 서버 부트스트랩, 사전 점검, 장애 진단 및 복구, 인수 테스트가 포함됩니다. 이 스킬은 사용자가 구매, 로그인 및 필수 권한 부여와 같은 수동 단계만 처리하면 Codex 가 나머지 SSH 명령, DNS 설정 및 설치를 자동화하여 반자동화된 원클릭 경험을 제공합니다. 보안에 중점을 두어 사용자를 잠그지 않고, 기존 서비스를 덮어쓰지 않으며, 자격 증명이 코드나 로그에 유출되지 않도록 보장합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add jedliuai/vps-proxy-skill

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

VPS Proxy Builder · Codex 실행 진입점

구성, 점검 및 문제 해결은 Codex 에게 맡기고, 사용자는 구매, 계정 로그인, 필수 권한 부여, 원격으로 대체할 수 없는 클라이언트 검수만 처리하도록 합니다. 사용자의 언어로 소통하며, 프로토콜 파라미터를 이해하도록 요구하지 않고, 플러그인이나 단일 스크립트 실행이 성공을 보장한다고 가장하지 않습니다.

먼저 위치를 파악한 후 행동하라

이 스킬은 전체 vps-proxy-skill 저장소에 의존하며, 독립 설치 패키지가 아닙니다. 현재 작업 디렉토리에서 deploy/server-bootstrap.sh, deploy/preflight.py, cloudflare-worker/ 를 포함하는 저장소를 찾습니다. 스킬이 개인 스킬 디렉토리에 단독으로 복사된 경우, 사용자가 액세스할 수 있는 전체 저장소를 확보하고 해당 저장소로 전환하십시오. 개인 스킬 디렉토리를 기준으로 배포를 실행하지 마십시오. 이번 Git revision 을 기록합니다. 기록된 도메인, IP, SSH alias, Cloudflare ID 및 US-* 이름은 원본 인스턴스 기록일 뿐, 사용자 구성이 아닙니다.

요청에 따라 모드를 선택하십시오:

  • 읽기/계획/문서 전용: 설명만 하고 SSH, 배포, DNS 쓰기 또는 플러그인 설치를 수행하지 않습니다.
  • 신규 구축: 준비 및 도구 를 읽은 후 배포 단계 를 읽습니다.
  • 기존 노드 장애: 진단 및 복구 를 읽고 먼저 읽기 전용으로 대조합니다. 전체 bootstrap 을 복구 버튼처럼 사용하지 마십시오.
  • 인수 또는 인도: 인수 및 인도 를 읽습니다.

변경을 수행하기 전에 저장소 보안 규칙 을 읽습니다. 현재 단계에 필요한 참조만 로드하고 전체 기록을 읽을 필요는 없습니다.

이번 자동화의 계약

간단한 계획으로 다음을 명확히 합니다: 대상 SSH alias/호스트, 운영체제, 전용 VPS 여부, 도메인 소유권, 직결 또는 Cloudflare 구독 여부, 변경이 허용된 서비스 및 방화벽, 예산 제한, 롤백 진입점. 목표가 명확하지 않으면 최소한의 누락된 정보만 질문합니다.

이 계획이 승인되었는지 확인한 후, 범위 내의 점검, 구성 및 테스트를 연속적으로 완료하고, 일반 명령어 하나하나에 대해 반복적으로 묻지 않습니다. 구매, 용량 확장, 새 VM 생성, 유료 제품, IP 변경, 기존 서비스 삭제, 모니터링 비활성화, 저장소 공개, 이미 사용된 자격 증명 교체 또는 영향 범위 변경은 별도 승인을 받아야 합니다. 수동 로그인이 필요한 경우 해당 단계에서 일시 중지하고, 클릭 위치/권한 부여 내용을 설명합니다. 권한을 우회하거나 Codex 보안 제한을 해제하는 것을 금지합니다.

자동화 기준: 전용 Debian 13 / x86_64 / systemd / SSH 22 / 공인 IPv4 / 사용자 제어 도메인. ARM, Ubuntu, 사용자 정의 SSH 포트, NAT 전용, IPv6 전용, 공유 서비스 호스트는 적응 작업이며, 게이트를 건너뛰고 강제로 실행할 수 없습니다. 기존 템플릿은 중국 가정용 네트워크 분할을 시나리오로 합니다. 지역 및 정책은 사용자에게 설명해야 하며, 미국 레이블을 다른 국가에 적용하지 않습니다.

반드시 유지해야 할 불변 조건

  1. 사용자를 잠그지 않음: 새 세션으로 비 root 관리자의 키 로그인 및 sudo 사용 가능 여부를 증명하고, 원래 세션/콘솔을 유지합니다. ADMIN_SSH_VERIFIED=1 은 검사 결과의 선언일 뿐, 자동 증명이 아닙니다. 스크립트는 이후 비밀번호 및 root SSH 를 비활성화하고 22번 포트만 유지합니다.
  2. 다른 서비스를 덮어쓰지 않음: 수신 대기, Nginx, nftables/UFW, Docker 및 systemd 상태를 나열합니다. Bootstrap 은 이 스택의 구성을 재구축하고, Nginx 기본 사이트를 교체하며, 인바운드 규칙을 강화하고, 고정 버전을 설치한 후 재시작합니다. 전용 호스트의 스냅샷/복구 콘솔이 준비된 후에 배포하십시오.
  3. 작성자 구성을 재사용하지 않음: 실제 도메인/alias 는 사용자가 제공하거나 이미 승인된 계정 내에서 확인합니다. Cloudflare 구성은 해당 account/zone/KV 를 사용하도록 변경해야 합니다. 새 진입점에는 더 이상 작성자 기본값이 내장되지 않습니다.
  4. 자격 증명을 유출하지 않음: 키는 서버에서 생성됩니다. 구독 URL 자체는 bearer 자격 증명이며, Base64 는 암호화가 아닙니다. 개인 키/비밀번호/URI/YAML/토큰은 Git, 로그, 채팅 또는 공개 변환 사이트에 입력되지 않습니다. 인도 장을 참조하여 사용자 전용 파일만 전달합니다.
  5. 설치를 인수로 간주하지 않음: active 상태, TCP 연결 가능, TLS 성공, 전체 프로토콜 사용 가능, 사용자 네트워크 사용 가능은 서로 다른 증거입니다. 독립적인 임시 클라이언트로 하나씩 테스트하고, 현재 구성을 덮어쓰지 않습니다.
  6. 무한히 시도하지 않음: 스크립트가 처음 실패하면 먼저 민감 정보를 제거한 증거를 저장하고 단계를 파악합니다. 전체 설치를 반복하지 않고, 동시에 배포하지 않습니다. 원래 노드가 악화되면 먼저 알려진 구성을 복원합니다. 업그레이드 및 인증서 재발급 재시도는 근본 원인을 대상으로 해야 하며, ACME 할당량을 소모하는 시행착오를 사용하지 않습니다.

플러그인 이름으로 추측하지 말고, 능력에 따라 의존성을 확인하라

  • Codex 는 전체 저장소를 읽고, 로컬 터미널을 실행하며, 네트워크를 통해 SSH 에 연결할 수 있어야 하며, 해당 권한을 획득해야 합니다. VPS 에 Codex 를 설치할 필요는 없습니다.
  • GitHub 플러그인/커넥터는 저장소 액세스에 사용할 수 있습니다. 승인된 Git/gh 도 가능합니다. 플러그인이 터미널에 클론 자격 증명을 부여하는 것은 아닙니다.
  • Cloudflare 를 선택하는 경우 공식 플러그인을 권장하며, 사용 가능한 도구와 권한을 확인합니다. DNS/Workers/KV/secret 기능이 부족한 경우 승인된 API 또는 잠긴 Wrangler 를 사용합니다. 플러그인 설치는 이러한 권한이 모두 있음을 의미하지 않습니다.
  • 브라우저 제어는 사용자가 콘솔 작업 지원을 원할 때만 사용합니다. 로그인, MFA, 결제는 사용자에게 맡깁니다. 다른 관련 없는 플러그인을 요구하거나 전체 패키지 의존성을 자동으로 설치하지 마십시오.

도구 설치 및 공식 문서 진입점은 준비 참조를 참조하십시오. 고정 모델을 요구하지 않습니다. 능력 부족, 컨텍스트 손실 또는 도구 제한 시 복구 가능한 진행 상황을 저장하며, "어떤 모델이든 감독 없이 완료할 수 있다"고 약속하지 않습니다.

완료 정의 및 후속 작업

클라이언트별로 레이블이 지정된 두 개의 링크 진입점을 제공합니다: Clash 및 v2rayN/v2rayNG/Shadowrocket. Cloudflare 가 제대로 구성되지 않은 경우 검증된 직결 진입점만 제공합니다. 세 가지 프로토콜이 동일한 서버에 있으며, 여러 국가의 출구가 아님을 설명합니다. URI 구독에는 Clash 분할 그룹이 포함되지 않습니다.

테스트 완료/실패/사용자 테스트 대기 상태를 보고하고, 버전, 날짜, 롤백 위치, 인증서 갱신 상태 및 비용 한도를 유지합니다. 사용자 가정 네트워크에서 테스트할 수 없는 경우 "서버 배포 완료, 가정 네트워크 인수 대기 중"으로 명확히 작성해야 하며, 모든 인수가 성공했다고 작성할 수 없습니다.

각 전체 단계마다 중국어로 worklog/YYYY-MM-DD-제목.md 를 작성합니다: 수행한 작업, 이유, 결정/함정, 한 줄 요약. 긴 작업 재개 시 읽기 전용으로 민감 정보를 제거한 기록과 현재 상태를 읽은 후, 완료되지 않은 단계를 계속 진행합니다. 처음부터 배포하지 않고, 자격 증명을 기록하지 않습니다. 새로운 장애의 조건, 증거 및 재사용 가능한 수정 사항을 참조에 추가하고, 개별 사례를 일반적인 결론으로 확장하지 않습니다.

관련 스킬