시작하기

이 페이지는 첫 실행 과정을 안내합니다: Chute에 구성을 넣고, 선택하고, 프록시를 시작하고, 트래픽이 흐르는지 확인합니다. 이 매뉴얼의 나머지 내용은 모두 동작하는 환경 위에서 이어집니다.

Chute iOS

1. 구성 구하기

구성이 하나도 없는 상태로 처음 실행하면 Chute는 설정 가이드("Chute에 오신 것을 환영합니다")를 열고 세 가지 경로를 제시합니다: 제공자가 발급한 URL을 위한 구독 링크, QR 코드 스캔, 그리고 서버 정보, 프록시할 사이트, DNS 선택을 차례로 입력하면 "Default"라는 이름의 구성을 만들어 연결하는 수동 설정입니다.

나중에 구성을 추가하려면 메인 화면 상단의 구성 바를 탭한 다음 구성 추가 방법...을 탭하세요:

• 빈 구성 — 빈 구성으로 내장 편집기를 엽니다(무엇을 넣을지는 아래의 최소 구성 예시를 참고하세요).
• 구독 추가 — 구독 URL에서 다운로드하고 최신 상태로 유지합니다: 네이티브 프로필은 24시간마다, 또는 프로필 자체의 #!MANAGED-CONFIG 줄이 정한 간격마다 다시 가져오는 관리형 구성으로 저장됩니다. Clash나 sing-box 구독은 가져오는 과정에서 변환되어 업데이트 헤더가 없는 정적 스냅숏으로 저장되므로 스스로 갱신하지 않습니다 — 업데이트하려면 다시 가져오세요.
• 로컬 파일에서 가져오기 — Chute(.conf), sing-box(.json) 또는 Clash/mihomo(.yaml) 파일을 가져옵니다; 네이티브가 아닌 형식은 자동으로 변환됩니다.
• iCloud에서 동기화, URL에서 다운로드, Wi-Fi로 파일 업로드, QR 코드에서 다운로드 — 같은 일을 위한 다른 전송 방식입니다.

라이선스가 없으면 iPhone이나 iPad는 구성을 하나만 보관합니다. 하나가 들어온 뒤에는 위의 모든 경로가 구매 안내를 띄우며, 다른 구성을 선택하는 것도 마찬가지입니다 — 라이선스와 활성화를 보세요.

2. 선택하기

구성 목록에서 구성을 탭해 체크 표시가 나타나게 한 다음 완료를 탭하세요. Chute는 항상 선택된 구성을 실행합니다 — 아무것도 선택되어 있지 않으면 메인 스위치가 켜지기를 거부합니다("먼저 구성을 선택해 주세요").

3. 시작하고 승인하기

메인 화면의 둥근 스위치를 탭하세요. 맨 처음 시작할 때 iOS가 VPN 구성 추가를 요청합니다 — 승인하고 Face ID / Touch ID / 암호로 확인하세요. 요청을 거부했다면 스위치를 다시 켜기만 하면 됩니다; VPN 프로파일이 꼬였다면 앱 설정의 VPN 구성 재설정이 이를 제거하며, 다음 시작 시 다시 생성됩니다.

4. 확인하기

스위치가 켜지면 아웃바운드 모드를 규칙 기반에 둔 채(다이렉트 / 글로벌 모드는 프록시를 통째로 우회하거나 강제합니다) 웹사이트를 하나 열어 보세요. 대시보드 버튼은 실시간 트래픽과 연결별 상세 정보를 보여 줍니다 — 구성이 의도대로 동작하는지 확인하는 가장 빠른 방법입니다.

Chute Mac

Chute Mac은 메뉴 막대에 상주합니다(기본적으로 Dock 아이콘이 없습니다). 메뉴 막대 아이콘을 클릭하세요:

1. 구성 가져오기 — 구성 가져오기...는 메인 창의 프로필 탭을 엽니다. 이 탭에는 디스크의 파일을 위한 파일에서 가져오기…와 구독 URL이나 공유 링크(ss://, vmess://, ...; 네 앱 중 공유 링크를 가져오는 것은 Chute Mac뿐입니다)를 위한 URL 또는 공유 링크에서 가져오기…가 있습니다. 단계별로 만들려면 대신 설정 도우미...를 사용하세요. 이 두 메뉴 항목은 프록시가 멈춰 있을 때만 나타납니다. 구독 및 변환된 프로필은 ~/Library/Application Support/<bundle id>/Profiles/ 아래에 저장되고, 디스크에서 가져온 파일은 원래 위치 그대로 참조됩니다.
2. 선택하기 — 구성 파일 선택, 또는 프록시 실행 중에는 구성 전환. 엔진이 처음 시작될 때 Chute는 시스템 프록시를 설정하고 향상 모드의 인터페이스를 만드는 권한 있는 도우미를 설치합니다: 먼저 그 이유를 설명하고(Chute에 도우미가 필요합니다), 이어서 macOS가 승인을 요청합니다. macOS 13 이상에서는 시스템 설정 > 일반 > 로그인 항목 및 확장 프로그램에서 도우미를 허용해야 할 수도 있으며, Chute는 승인 필요 또는 로그인 항목에서 Chute 허용으로 이를 알려 줍니다.
3. 켜기 — 두 개의 독립적인 스위치가 서로 다른 용도를 담당합니다:
   • 시스템 프록시 — 메뉴 상단의 토글입니다. Chute를 시스템 HTTP/SOCKS 프록시로 등록합니다; 시스템 프록시를 따르는 앱은 Chute를 거칩니다.
   • 향상 모드(⌘E) — 시스템 프록시를 무시하는 앱까지 포함해 네트워크 계층에서 모든 트래픽을 가로챕니다. 기본 유형인 Helper utun (레거시)는 켜기 전에 안내문을 보여 줄 뿐 별도의 승인이 필요 없습니다; Chute의 네트워크 확장 프로그램과 VPN 구성 승인을 요청하는 것은 PacketTunnel (권장) 유형뿐입니다. 유형 선택과 승인 절차는 향상 모드를 참조하세요.
4. 확인하기 — 메뉴 헤더에 "시스템 프록시: 활성"이 표시되고, 메인 창의 트래픽 및 로그 탭에서 무엇이 어떤 이유로 흐르는지 확인할 수 있습니다.

주의: 위 단계는 새 메인 창을 기준으로 합니다. Chute Mac은 아직 구성이 하나도 없는 설치에서만 새 메인 창을 스스로 켭니다. 이미 구성이 있던 설치는 이전 인터페이스를 유지합니다: 그 메뉴에는 대시보드 열기... 대신 환경설정...이 있고, 그 창에는 트래픽이나 로그 탭이 없습니다. 전환하려면 메뉴에서 새 메인 UI 사용을 체크하세요 — 이 항목은 프록시가 실행 중일 때 나타납니다.

Chute tvOS

Chute tvOS는 다른 기기 없이 자체적으로 구성을 추가할 수 있습니다. 구성 목록의 구성 추가 방법...은 빈 구성, Wi-Fi 또는 Chute iOS로 파일 업로드, URL에서 다운로드를 제공합니다. Wi-Fi 업로드는 TV의 주소에 평범한 HTTP 페이지를 띄우고, 같은 네트워크의 어떤 브라우저에서든 그 페이지로 파일을 올릴 수 있습니다. iPhone에서 그 페이지를 열면 chute://tv URL 스킴을 통해 Chute iOS로 넘어가는데, Chute iOS의 원격 구성 가져오기 화면은 바로 이때 사용됩니다. 구성 하나 제한은 iOS와 같습니다.

Chute Android

Android에서의 첫 실행(구성 추가, VPN 동의, 서비스 모드와 앱별 모드, 확인 위치)은 별도 페이지 Android 시작하기에 있습니다. 아래 최소 구성은 Android에서도 그대로 동작합니다.

최소 구성

Shadowsocks 서버 하나를 위한 완전하고 동작하는 구성입니다 — LAN과 중국행 트래픽은 직접 연결하고, 나머지는 모두 프록시를 거칩니다:

[General]
loglevel = notify
dns-server = 1.1.1.1, 8.8.8.8
skip-proxy = 127.0.0.1, 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12, 100.64.0.0/10, localhost, *.local

[Proxy]
MyProxy = ss, example.com, 8388, aes-256-gcm, "password"

[Proxy Group]
MainGroup = select, MyProxy, DIRECT

[Rule]
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR,10.0.0.0/8,DIRECT
IP-CIDR,172.16.0.0/12,DIRECT
IP-CIDR,127.0.0.0/8,DIRECT
GEOIP,CN,DIRECT
FINAL,MainGroup

[Proxy] 줄을 사용 중인 서버의 프로토콜과 매개변수로 바꾸세요 — 지원되는 모든 프로토콜은 프록시 서버에 문서화되어 있습니다. 여기서부터는:

• 구성 — 파일 형식과 모든 섹션.
• 규칙 — 규칙이 평가되는 방식과 전체 규칙 유형 목록.
• 정책 그룹 — 자동 선택(url-test, fallback, load-balance).
• 문제 해결 — 무언가 동작하지 않을 때.