VTbox
한국어
로그인 가입

SETUP GUIDE

모든 플랫폼용 Clash 설정

운영체제에 맞는 클라이언트를 설치하고 VTbox 비공개 구독을 가져온 뒤 라우팅과 연결을 확인하세요.

설정 문제 찾기

01

클라이언트 다운로드 및 설치

운영체제 버전과 프로세서 아키텍처에 맞는 설치 파일을 선택하세요. 공식 릴리스 페이지에서도 다운로드할 수 있습니다.

iOS · Shadowrocket

App Store에서 Shadowrocket을 받으세요. 가격과 제공 여부는 지역별 스토어를 확인하세요. VTbox 대시보드에서 범용 Base64 / Shadowrocket 링크를 복사하고 앱의 새 구독에 붙여 넣으세요. 업데이트한 뒤 VTbox 노드를 선택하고 VPN 연결을 허용하세요.

App Store에서 Shadowrocket 보기

Linux · Clash Verge Rev / Mihomo

그래픽 인터페이스가 필요하면 Clash Verge Rev를 사용하세요. Debian과 Ubuntu는 DEB, Fedora와 openSUSE는 RPM을 선택하고 CPU 아키텍처를 확인하세요.

아키텍처에 맞는 Mihomo를 설치합니다. 대시보드의 Clash / Mihomo / Stash 링크에서 프로필을 받고 현재 사용자만 읽을 수 있는 config.yaml로 저장합니다. mihomo -t -f config.yaml 로 파일을 검사하고 mihomo -f config.yaml 을 실행해 클라이언트를 시작합니다.

Clash Verge Rev 공식 릴리스

Mihomo 공식 릴리스

02

구독 받기 및 가져오기

  1. VTbox 대시보드에 로그인한 뒤 클라이언트에 맞는 활성 구독 링크를 복사합니다. Clash Verge Rev, Clash Meta for Android, Mihomo는 Clash / Mihomo / Stash(YAML), Shadowrocket은 범용 Base64 / Shadowrocket을 사용합니다.
  2. 클라이언트의 프로필 또는 구독에서 URL로 가져오기를 선택해 링크를 붙여 넣습니다. 이름을 VTbox로 지정할 수 있습니다.
  3. 프로필을 저장하고 선택합니다. 업데이트 버튼이 있으면 눌러 새로고침이 되는지 확인하세요.

구독 링크에는 인증 정보가 포함됩니다. 화면을 공유하거나 오류를 신고할 때는 링크 전체를 가리세요.

03

프록시 모드와 라우팅 규칙 선택

  • Rule(규칙) 모드는 프로필 규칙에 따라 프록시 또는 직접 연결을 사용합니다. 기본 VTbox 프로필은 일치하는 트래픽을 VTbox 노드로 보내며 필요에 따라 직접 연결 규칙을 추가할 수 있습니다.
  • Global(전역) 모드는 가로챈 트래픽을 전역 정책으로 전송합니다. 문제가 생기면 선택된 노드를 확인하세요.
  • Direct(직접) 모드는 트래픽을 직접 연결합니다. 프록시 모드와 연결 상태를 비교할 때 유용합니다.
04

시스템 프록시 활성화 및 연결 확인

  1. Windows와 macOS에서는 시스템 프록시를 먼저 사용해 보세요. Android와 iOS에서는 앱에서 VPN을 시작하고 권한을 허용합니다. Linux에서는 데스크톱이나 대상 앱에 로컬 프록시를 지정하세요.
  2. 프록시 또는 노드 화면에서 노드를 선택해 지연을 테스트한 뒤 대상 사이트가 정상적으로 열리는지 확인합니다.
  3. 더 많은 앱을 프록시로 연결하려면 아래 TUN 안내를 보고 클라이언트와 시스템의 지원 여부를 확인하세요.

TROUBLESHOOTING

문제 해결

가져오기 중 네트워크 오류, 403 또는 분석 오류가 발생하면?

대시보드에서 전체 링크를 다시 복사하고 구독 상태와 남은 데이터를 확인합니다. 다른 프록시를 잠시 끄고 VTbox 접속 여부를 테스트하세요. 계속 분석 오류가 나면 클라이언트를 업데이트하거나 노드 프로토콜 지원 여부를 확인하세요.

프록시를 켰을 때 WeChat이나 국내 사이트가 느리거나 열리지 않으면?

직접 연결 모드로 잠시 바꿔 프록시의 영향을 확인합니다. 사용자 규칙을 지원하는 클라이언트에서는 직접 연결 규칙을 추가하고 연결 기록을 확인하세요.

TUN 모드는 어떻게 켜나요?

데스크톱 설정에서 TUN 또는 가상 어댑터를 켜고 시스템 서비스 설치나 권한 요청을 따릅니다. 라우팅이 충돌하면 다른 VPN이나 가상 어댑터를 종료하고 다시 시도하세요.

같은 LAN에서 프록시를 공유하려면?

신뢰하는 네트워크에서만 LAN 연결을 허용합니다. 같은 Wi-Fi에 연결된 기기에서 프록시 호스트의 LAN IP와 클라이언트에 표시된 포트를 입력하세요. 사용한 뒤 공유를 끕니다.

시스템 시간이 다르면 TLS가 실패하나요?

기기의 날짜, 시간, 시간대를 자동으로 설정합니다. 동기화가 끝나면 구독을 새로고침하고 다시 테스트하세요.