기타 옵션

[General]
ipv6 = true
loglevel = notify

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

tun-excluded-routes = 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12
tun-included-routes = 192.168.1.12/32

공통 옵션

전체 IPv6 지원 활성화 (기본값: true)

ipv6 = true

로그 레벨 (기본값: warning)

loglevel = notify

none, fatal, warning, notify, info 또는 verbose 중 하나. 일상 사용에서 verbose를 활성화하면 성능이 크게 저하되므로 권장하지 않습니다.

skip-proxy

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

iOS 버전에서는 이 옵션이 Chute TUN을 통해 연결을 강제하며, Chute 프록시 대신 처리합니다. macOS 버전에서는 "시스템 프록시로 설정"이 활성화될 때 이러한 설정이 시스템에 적용됩니다. 이 옵션은 일부 앱과의 호환성 문제를 해결하는 데 사용됩니다.

• 단일 도메인을 지정하려면 도메인 이름을 입력하세요 - 예: apple.com.
• 도메인의 모든 웹사이트를 지정하려면 별표를 도메인 이름 앞에 사용하세요 - 예: *apple.com.
• 도메인의 특정 부분을 지정하려면 각 부분을 지정하세요 - 예: store.apple.com.
• 호스트 또는 네트워크를 IP 주소로 지정하려면 특정 IP 주소를 입력하세요. 예: 192.168.2.11 또는 192.168.2.* 또는 192.168.2.0/24.

참고: IP 주소 또는 주소 범위를 입력하면 해당 주소를 사용하는 호스트에 연결할 때만 프록시를 우회할 수 있으며, 해당 주소로 해석되는 도메인 이름으로 연결할 때는 불가능합니다.

기존 연결 중단

interrupt-exist-connections = true

활성화되면 모든 정책 그룹에서 선택된 정책 변경(URL 테스트, 폴백, 로드 밸런스, SSID 또는 수동 선택을 통해)으로 기존 연결을 정상적으로 종료하여 이전 정책을 사용 중인 연결이 새로운 선택 프록시로 즉시 유지되도록 합니다.

각 영향을 받는 연결은 3초의 시간 초과로 정상 종료되며 강제 종료됩니다.

기본값: false. 이것은 모든 정책 그룹에 영향을 미치는 전역 설정입니다.

네트워크 프레임워크 (macOS / tvOS)

network-framework = true

Apple Network.framework를 활성화하여 아웃바운드 연결에 사용합니다. 이는 macOS 및 tvOS에서 기본적으로 활성화되어 있으며 iOS에서는 비활성화되어 있습니다. Network.framework를 사용하면 지원되는 플랫폼에서 더 나은 성능과 최신 TLS 스택 통합을 제공할 수 있습니다.

기본값: macOS/tvOS에서는 true, iOS에서는 false.

단순 호스트명 제외

exclude-simple-hostnames = true

활성화되면 단일 레이블 이름(점 없는, 예: localhost)이 프록시 규칙을 우회하여 로컬로 해석됩니다. 이는 불필요한 DNS 조회를 방지하는 데 도움이 됩니다.

기본값: false.

데이터베이스 기록 비활성화

disable-db-record = true

활성화되면 Chute가 로컬 데이터베이스에 트래픽 기록 작성을 중지합니다. 이는 성능을 향상시키고 저장소 사용량을 줄일 수 있지만 Chute Dashboard에서 트래픽 기록을 사용할 수 없습니다.

기본값: false.

메뉴 막대 속도 표시 (Mac 전용)

menu-bar-show-speed = true

활성화되면 Chute Mac이 메뉴 막대에 현재 업로드 및 다운로드 속도를 표시합니다.

기본값: false.

다른 DNS 서버 하이재킹

hijack-dns = 8.8.8.8:53

기본적으로 Chute는 Chute DNS 주소(198.18.0.2)로 전송된 DNS 쿼리에 대해서만 가짜 IP 주소를 반환합니다. 표준 DNS로 전송된 쿼리는 단순히 전달됩니다.

일부 기기나 소프트웨어는 항상 하드코드 DNS 서버를 사용합니다. (예: Google Speakers는 항상 8.8.8.8을 사용합니다). 이 옵션을 사용하여 쿼리를 하이재킹하고 가짜 주소를 얻을 수 있습니다.

hijack-dns = *:53을 사용하여 모든 DNS 쿼리를 하이재킹할 수 있습니다.

제외된 경로

tun-excluded-routes = 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12

Chute VIF는 TCP 및 UDP 프로토콜만 처리할 수 있습니다. 이 옵션을 사용하여 특정 IP 범위를 우회하여 모든 트래픽이 통과할 수 있도록 합니다.

참고: 이 옵션은 VIF(utun) 향상 모드 유형에만 적용되며, PacketTunnel VPN 유형을 사용할 때는 효과가 없습니다. Chute 프록시 서버에서 처리된 요청은 영향을 받지 않습니다. 'skip-proxy'와 'tun-excluded-routes'를 결합하여 특정 HTTP 트래픽이 Chute를 우회하도록 합니다.

이 옵션은 시스템 오류 ENOMEM(메모리 할당 불가)을 발생시킬 수 있습니다. iOS 시스템의 버그로 보입니다. 이 옵션을 사용하지 않는 것이 좋습니다.

포함된 경로

tun-included-routes = 192.168.1.12/32

기본적으로 Chute VIF 인터페이스는 자신을 기본 경로로 선언합니다. 그러나 Wi-Fi 인터페이스는 더 작은 경로를 가지므로 일부 트래픽이 Chute VIF 인터페이스를 통과하지 못할 수 있습니다. 이 옵션을 사용하여 더 작은 경로를 추가하세요.

참고: 이 옵션은 VIF(utun) 향상 모드 유형에만 적용되며, PacketTunnel VPN 유형을 사용할 때는 효과가 없습니다.

프로토콜 스니핑

sniffing-enabled = true
sniffing-timeout = 100

Chute는 초기 바이트를 검사하여 연결의 실제 프로토콜을 감지할 수 있습니다. 이를 통해 PROTOCOL,HTTPS,Proxy와 같은 규칙이 비 HTTP 인바운드 연결에서도 올바르게 작동할 수 있습니다.

sniffing-enabled (기본값: false)

sniffing-enabled = true

TCP 연결에 대한 프로토콜 감지를 활성화합니다.

sniffing-timeout (기본값: 100ms)

sniffing-timeout = 200

프로토콜을 결정하기 위해 초기 데이터를 기다리는 최대 시간(밀리초)입니다. 느린 연결에서 프로토콜 감지가 실패할 경우 이 값을 늘리십시오.

TUN 우회

bypass-tun = 192.168.0.0/16, 10.0.0.0/8

skip-proxy와 유사하게 TUN/VIF 라우팅 수준에서 작동합니다. 이러한 IP 범위 연결은 TUN 인터페이스를 완전히 우회하여 시스템 네트워크 스택을 직접 통과합니다.

참고: 이 옵션은 VIF(utun) 향상 모드 유형에만 적용되며, PacketTunnel VPN 유형을 사용할 때는 효과가 없습니다. VIF(utun) 유형의 향상 모드에만 적용됩니다.

거부 시 오류 페이지 표시

show-error-page-for-reject = true

활성화되면 Chute는 거부된 요청에 대해 사용자 친화적인 오류 페이지를 반환합니다. 단순히 연결을 끊는 대신.

낙관적 DNS

optimistic-dns = true

활성화되면 Chute는 캐시된 DNS 결과를 즉시 반환하면서 백그라운드에서 레코드를 새로 고칩니다. 이는 연결 지연 시간을 희생하여 오래된 DNS 레코드를 반환할 수 있습니다.

Wi-Fi 접근 허용

allow-wifi-access = true

셀룰러/종량제 환경에서 활성화되면 Chute가 Wi-Fi 연결을 통해 계속 작동합니다. 이는 macOS 전용입니다.

관리형 설정

Chute는 #!MANAGED-CONFIG 헤더를 통해 설정 파일 상단에서 원격으로 관리되는 구성을 지원합니다:

#!MANAGED-CONFIG https://example.com/config.conf interval=86400 strict=false

Chute는 주기적으로 지정된 URL에서 구성을 다시 가져오며 적용합니다. 로컬 편집은 엄격한 관리 구성에 유지되지 않습니다.

복제 / 트래픽 기록

[Replica] 섹션은 트래픽 기록 동작 및 필터링을 제어합니다:

[Replica]
hide-apple-request = true
hide-udp = true
hide-crashlytics-request = true
use-keyword-filter = false
keyword-filter = example

replica 키는 [General]에서 replica = true로 트래픽 기록을 활성화합니다. [Replica] 섹션을 사용하여 기록되는 내용을 필터링하세요.

HTTP 제어 API 및 웹 UI

[General]
external-http-controller = 127.0.0.1:9090
external-http-secret = your-secret-token
external-http-ui = true
external-http-cors = false

Chute는 Clash 및 Surge 대시보드와 유사한 내장 HTTP 제어 API 및 웹 기반 관리 UI를 제공합니다. API는 REST 엔드포인트를 통해 커널 상태, 트래픽, 연결, DNS, 정책 제어 및 구성 관리를 노출합니다.

external-http-controller (기본값: 비활성화)

external-http-controller = 127.0.0.1:9090

HTTP 제어 서버의 주소 및 포트입니다. 로컬 전용 접근에는 127.0.0.1을 사용하세요. 0.0.0.0 또는 비루프백 주소에 바인딩하면 원격 접근이 가능하며 비어 있지 않은 external-http-secret이 필요합니다.

external-http-secret (기본값: 비어 있음)

external-http-secret = your-secret-token

API 인증에 사용되는 Bearer 토큰입니다. 요청에는 헤더 Authorization: Bearer <secret>이 포함되어야 합니다. 컨트롤러가 비루프백 주소에 바인딩되거나 원격 접근이 필요한 경우 비어 있지 않은 external-http-secret이 필요합니다.

external-http-ui (기본값: true)

external-http-ui = true

활성화되면 Chute는 컨트롤러 주소에서 내장 웹 UI를 제공합니다. 웹 UI는 개요 대시보드, 연결 관리, DNS 검사, 트래픽 모니터링, 정책 제어 및 구성 편집을 제공합니다. false로 설정하면 API는 활성화된 상태에서 UI를 비활성화합니다.

external-http-cors (기본값: false)

external-http-cors = true

CORS(Cross-Origin Resource Sharing) 헤더를 API 응답에서 활성화합니다. 웹 UI 또는 서드파티 도구가 다른 오리진에서 API에 접근해야 할 때 유용합니다.

API 엔드포인트:

참고: 이 기능은 기본적으로 비활성화되어 있습니다. API는 JSON 응답을 {"ok": true, "data": {...}} 형식으로 성공 시, {"ok": false, "error": {"code": "...", "message": "..."}} 형식으로 오류 시 사용합니다.