기타 옵션

[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

false로 설정하면 DNS 응답에서 AAAA 레코드와 IPv6 힌트가 빠지고 fake-IP 풀도 AAAA를 답하지 않습니다. 응답의 나머지 — A 레코드와 그 밖의 레코드 — 는 그대로 유지됩니다.

loglevel (기본값: 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와 tvOS 버전에서는 호스트명 항목이 터널의 프록시 예외 목록에 추가되어, 그 호스트로의 연결을 Chute 프록시 대신 Chute TUN이 처리합니다. IP 주소나 CIDR 항목은 여기에 더해 터널의 제외 라우트가 되므로, 그 범위로 가는 트래픽은 Chute TUN이 처리하는 것이 아니라 터널을 아예 벗어납니다. Chute Android도 VPN 모드에서 같은 일을 합니다: 시스템 HTTP 프록시가 켜져 있는 동안 호스트명, * 와일드카드, IPv4 주소는 VPN이 앱에 넘기는 프록시의 예외 목록에 들어가고, Android 13 이상에서는 모든 IP 주소나 CIDR 항목이 VPN의 제외 라우트가 됩니다 — 단일 주소는 /32 또는 /128 라우트로. 루프백 항목은 빠집니다. 루프백 트래픽은 애초에 터널로 들어오지 않기 때문입니다. macOS 버전에서는 "시스템 프록시로 설정"이 활성화될 때 이러한 설정이 시스템에 적용됩니다. 향상 모드가 켜져 있는 동안에는 두 향상 모드 유형 모두에서 IP 주소와 CIDR 항목이 iOS에서처럼 터널 밖에도 남겨집니다 — 제외 라우트를 참조하세요. PacketTunnel 유형에서는 시스템 프록시가 켜져 있는 동안 같은 예외 목록이 터널이 실어 나르는 HTTP/HTTPS 프록시에도 적용됩니다. 이 옵션은 일부 앱과의 호환성 문제를 해결하는 데 사용됩니다.

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

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


프록시 서버 수신 대기

interface = 127.0.0.1
port = 8118
socks-interface = 127.0.0.1
socks-port = 8119

interface / port는 HTTP 프록시 서버의 수신 주소와 포트를 제어합니다(기본값 127.0.0.1:8118). socks-interface / socks-port는 SOCKS5 프록시 서버를 제어합니다(기본값 127.0.0.1:8119). iOS와 tvOS에서는 두 리스너가 모든 인터페이스에 바인딩될 때만 실행됩니다 — allow-wifi-access = true이거나, interface / socks-interface가 0.0.0.0이거나, iOS에서는 앱의 LAN 연결 허용 스위치가 켜져 있을 때 — 따라서 기본값 127.0.0.1에서는 그곳에서 이 포트를 수신하는 것이 아무것도 없습니다. Chute Mac과 Chute Android는 항상 두 리스너를 시작합니다. 다른 기기에 제공하는 것은 모든 플랫폼에서 Chute Pro입니다: 그것이 없으면 루프백이 아닌 주소는 무시되고 바인드는 127.0.0.1에 머물므로, iOS와 tvOS에서는 리스너가 아예 시작되지 않습니다.

포트가 이미 사용 중이면 서버는 다음 포트로 차례로 넘어가며, 설정한 포트를 포함해 최대 20개까지 시도합니다. 모두 사용 중이면 그 서버는 시작되지 않고, 엔진의 나머지 부분은 그대로 동작합니다. 실제로 쓰이는 포트는 GET /api/status가 알려 주는 http_port, socks_port이며, 웹 콘솔의 Overview(개요) 페이지에도 표시됩니다. SOCKS5의 UDP 릴레이는 별도의 포트에 바인딩되며 TCP 리스너와 함께 옮겨 가지 않습니다. TCP 쪽이 옮겨 간 뒤에도 릴레이는 설정한 포트에 그대로 있을 수도, 전혀 다른 포트에 있을 수도 있습니다. UDP ASSOCIATE 응답에는 항상 릴레이가 실제로 쓰는 포트가 담기므로, RFC 1928대로 응답이 알려 준 주소로 데이터그램을 보내는 클라이언트는 영향을 받지 않습니다.

port와 socks-port에는 1부터 65535 사이의 값을 지정하세요: 구성을 로드할 때 범위를 검사하지 않으므로, 범위를 벗어난 값이면 서버가 시작되지 않거나 다른 포트에서 수신하게 됩니다. http-listen / socks5-listen으로 쓴 경우에는 그런 포트가 구성 오류입니다.

평문 http:// 요청의 경우 HTTP 프록시 서버의 연결 하나는 한 번의 주고받기만 실어 나릅니다: 각 응답은 Connection: close를 달고 나가며 그 뒤 연결이 닫히므로, 클라이언트는 다음 요청을 새 연결로 보냅니다. 첫 요청 뒤에 파이프라인으로 이어진 요청은 버려지며, 클라이언트가 새 연결에서 다시 보냅니다. 같은 연결에서 여러 번 왕복해야 하는 인증 방식(NTLM, Negotiate 등)은 이를 거쳐서는 완료할 수 없습니다. 복호화하지 않는 CONNECT 터널은 영향을 받지 않습니다. WebSocket 업그레이드는 연결을 유지합니다: 101 응답 이후에는 데이터가 양방향으로 그대로 오갑니다.

호환성 별칭: doh-server와 doh-service는 doh의 별칭으로 허용됩니다. http-listen / socks5-listen(예: 0.0.0.0:6152, [::]:6153, 또는 포트 번호만)은 위의 interface/port 설정에 매핑됩니다. 와일드카드 수신 호스트(0.0.0.0, ::, *)를 지정하면 allow-wifi-access = true도 함께 설정됩니다.


인바운드 프록시 인증

http-auth = username:password

클라이언트가 Chute의 HTTP 및 SOCKS5 프록시 서버를 사용하기 전에 인증하도록 요구합니다. 이 줄을 반복하여 여러 자격 증명을 허용할 수 있습니다.

HTTP 프록시는 유효한 자격 증명이 없는 요청 — 일반 요청이든 CONNECT든 — 에 407 Proxy Authentication Required와 Proxy-Authenticate: Basic realm="KLNEKit"로 응답한 뒤 연결을 닫습니다. SOCKS5 서버는 같은 자격 증명을 SOCKS5 사용자 이름/비밀번호 인증으로 받으며, 이 인증을 제시하지 않거나 인증에 실패한 연결은 닫습니다.


시스템 요청 우회

bypass-system = true

활성화되면 Chute는 고정된 Apple 호스트명 18개 — 푸시, iCloud 게이트웨이, 캡티브 포털 확인, OCSP 등 — 를 skip-proxy에 덧붙이고, 사용자의 규칙 뒤, FINAL 바로 앞에 IP-CIDR,17.0.0.0/8,DIRECT,no-resolve를 덧붙입니다 — 따라서 17.0.0.0/8에 먼저 일치하는 사용자 규칙이 여전히 이깁니다. 프로세스를 기준으로 한 일치는 없습니다: 이 옵션은 그 고정된 호스트·주소 목록일 뿐, 어떤 프로세스가 요청을 보냈는지 가리는 필터가 아닙니다.

기본값: true.


항상 실제 IP

always-real-ip = *.example.com, tracker.example.org

Chute가 하이재킹된 DNS 쿼리에 가짜 IP 주소를 제공할 때(hijack-dns 참조), 쉼표로 구분된 이 목록과 일치하는 호스트명은 항상 실제로 해석된 IP 주소로 응답됩니다. 와일드카드가 지원됩니다. always-ip-address(Shadowrocket의 표기)는 이 키로 읽힙니다: 불리언 값(true, yes, on, 1)은 모든 호스트를 뜻하며 always-real-ip = *로 다시 쓰이고, false는 버려지며, 그 밖의 값은 호스트 목록으로 읽힙니다. 구성은 always-real-ip 표기로 저장됩니다.


시스템 hosts 파일 읽기

read-etc-hosts = false

시스템 hosts 파일을 [Host] 표로 읽어 들일지 정합니다. false로 설정하면 그 파일을 무시하며, 변경은 재로드 시 적용됩니다. 로컬 DNS 매핑을 참고하세요.

기본값: true.


기존 연결 중단

interrupt-exist-connections = true

활성화되면 경로가 바뀔 때 이전 경로로 만들어진 기존 연결을 닫아, 연결이 끝날 때까지 이전 경로에 머무르지 않고 즉시 새 경로를 사용하도록 합니다. 다음 변경이 해당됩니다:

  • 정책 그룹이 다른 멤버를 고르는 경우 — 스스로(URL 테스트, 폴백, SSID) 또는 수동 선택으로. 그룹이 떠난 멤버를 쓰던 연결이 닫힙니다. 로드 밸런스 그룹은 연결을 멤버들에 분산하며 결코 전환으로 치지 않습니다.
  • 내장 PROXY가 따르는 글로벌 모드용 선택 정책이 바뀌는 경우: 글로벌 모드가 이전 정책으로 보낸 연결과 PROXY를 거쳐 그 정책에 닿은 연결이 닫힙니다.
  • 아웃바운드 모드를 규칙, 글로벌, 다이렉트 사이에서 전환하는 경우: 모든 연결이 닫힙니다.
  • DNS 서버, [Host], 정책, 정책 그룹이나 프록시 제공자, 규칙이나 규칙 세트를 바꾸는 재로드: 모든 연결이 닫힙니다.

이는 연결이 거치는 모든 정책 그룹에 적용됩니다. 규칙이 지정한 그룹, 그 안에 중첩된 그룹, 체이닝 정책(underlying-proxy)의 상위 그룹, 그리고 릴레이 그룹의 멤버인 그룹입니다.

그룹 전환이나 글로벌 모드 정책 변경 후에는 영향을 받는 각 연결이 3초의 시간 초과 내에 정상 종료를 시도하며, 그 후 강제 종료됩니다; 모드 전환이나 재로드는 연결을 즉시 닫습니다. 일반 UDP 흐름은 이 중 어느 것으로도 닫히지 않습니다. /api/rules/user로 추가한 규칙은 이 옵션의 적용을 받지 않습니다: 기본적으로 이 옵션이 켜져 있든 꺼져 있든, 다른 곳으로 라우팅하게 된 연결을 닫습니다.

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


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

network-framework = true

Apple Network.framework를 활성화하여 아웃바운드 연결에 사용합니다. Network.framework를 사용하면 지원되는 플랫폼에서 더 나은 성능과 최신 TLS 스택 통합을 제공할 수 있습니다.

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


단순 호스트명 제외

exclude-simple-hostnames = true

활성화되면 단순 호스트명(점이 없는 단일 레이블 이름, 예: localhost)에 대한 요청은 프록시 규칙을 우회하여 로컬에서 해석됩니다. 이는 로컬 네트워크 이름에 대한 불필요한 DNS 조회를 방지하는 데 도움이 됩니다. 이는 macOS 시스템 프록시 자체의 "단순 호스트명 제외" 설정입니다. Chute Mac이 시스템 프록시 구성에 기록하므로 시스템 프록시를 따르는 애플리케이션에만 적용됩니다 — 향상 모드나 TUN 트래픽에는 적용되지 않습니다. iOS와 tvOS에서는 같은 방식으로 터널의 프록시 설정에 기록되므로, skip-proxy의 호스트명과 마찬가지로 단순 호스트명은 Chute 프록시 대신 Chute TUN이 처리합니다. Chute Android는 이 옵션을 쓰지 않습니다.

Chute Mac에서는 첫 실행 시 일회성 마이그레이션으로 이 옵션이 기본 활성화됩니다. 사용자가 명시적으로 끈 설정은 그대로 존중됩니다.

기본값: false.


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

disable-db-record = true

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

기본값: false.


menu-bar-show-speed = true

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

현재 엔진에서는 파싱만 되고 효과가 없습니다 — Chute Mac의 어느 부분도 이 키를 읽지 않습니다. 메뉴 막대의 속도 표시는 메뉴 항목 연결 속도 표시로 켜고 끄며, 그 값은 앱 자체 설정에 저장됩니다. 이 키는 구성을 저장할 때 그대로 다시 기록됩니다.


다른 DNS 서버 하이재킹

hijack-dns = 8.8.8.8:53

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

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

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

포트가 없는 항목은 53번 포트를 뜻하므로 hijack-dns = 8.8.8.8은 8.8.8.8:53입니다. 읽을 수 없는 항목은 알림과 함께 건너뛰고, 그 줄의 나머지 항목은 그대로 적용됩니다.

가짜 IP는 Apple TV(tvOS 17 이상)에서도 사용할 수 있습니다. 이전에는 비활성화되어 있었으며, 실기기 검증이 진행 중입니다.


제외 라우트

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

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

주의: 이 옵션은 iOS와 tvOS의 패킷 터널에 적용되며, 그곳에서 이 범위들은 터널 IP 설정의 제외 라우트가 됩니다. Android 13 이상의 Chute Android에도 적용되어 VPN의 제외 라우트가 됩니다 — Android 11과 12에는 제외 라우트를 위한 API가 없으므로 그곳에서는 이 범위들이 무시됩니다. Chute 프록시 서버에서 처리된 요청은 영향을 받지 않습니다. 'skip-proxy'와 'tun-excluded-routes'를 결합하여 특정 HTTP 트래픽이 Chute를 우회하도록 합니다.

macOS에서는 두 향상 모드 유형 모두에 적용되며, 터널 밖에 남겨지는 것은 iOS와 tvOS 터널과 같은 목록입니다. 이 옵션의 범위, bypass-tun의 범위, 그리고 skip-proxy의 IP 주소와 CIDR 항목입니다 — 호스트명 항목은 라우트가 아니므로 관계가 없습니다. PacketTunnel 유형에서는 iOS에서처럼 이 범위들이 터널 IP 설정의 제외 라우트가 됩니다. Helper utun 유형에서는 도우미가 utun으로 향하게 하는 라우트에서 이 범위들을 빼므로, 그곳으로 가는 트래픽은 시스템의 원래 라우트를 따릅니다. IPv6에서 도우미가 utun으로 향하게 하는 것은 2000::/3뿐이므로, 그쪽에서는 2000::/3 안의 IPv6 범위만 영향을 줍니다. IPv6 범위는 터널이 IPv6를 실어 나를 때(ipv6 = true)만 의미가 있습니다. 프리픽스 길이가 0인 항목(0.0.0.0/0, ::/0), 그리고 루프백(127.0.0.0/8, ::1)이나 터널 자신의 서브넷(198.18.0.0/15, fd12:1:1:1::/64)과 겹치는 항목은 건너뛰고 로그에 남깁니다 — 그래서 skip-proxy에 보통 들어 있는 127.0.0.1은 그냥 건너뜁니다. 제외한 범위보다 더 구체적인 tun-included-routes 항목은 여전히 이깁니다. 라우트는 프리픽스 길이로 고르기 때문입니다. 목록을 바꾸면 구성을 재로드할 때 적용됩니다.

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


포함 라우트

tun-included-routes = 192.168.1.12/32

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

기본 라우트만으로는 부족한 이유는 이렇습니다. 시스템은 순서가 아니라 프리픽스 길이로 라우트를 고릅니다. 물리 인터페이스가 가진 온링크 서브넷(이를테면 192.168.1.0/24)은 터널의 0.0.0.0/0보다 더 구체적이라 그 트래픽은 Chute까지 오지 않습니다. 여기에 넣은 항목은 그보다 더 구체적인 라우트를 설치하므로 이깁니다. 이 라우트들은 기본 라우트 위에 더해질 뿐, 터널이 잡는 범위를 좁히지는 않습니다.

참고: 사설 대역(10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16)을 통째로 나열하지 마세요. 보통은 필요 없고 시스템 자체의 라우팅을 어지럽힐 수 있습니다. Chute는 그런 항목도 그대로 적용하지만 경고를 기록합니다 — 단, macOS에서 향상 모드의 네트워크 확장 유형은 경고 없이 적용합니다. 이 옵션을 쓰는 일반적인 이유는 다른 VPN 앱의 터널이 가진 대역에 닿기 위해서입니다.

참고: Chute 자신이 쓰는 경로를 끊어 버릴 항목은 거부되고 그 이유가 로그에 남습니다. 루프백, VIF 자신의 서브넷(198.18.0.0/15과 fd12:1:1:1::/64), 링크 로컬, 멀티캐스트, 브로드캐스트, 그리고 프리픽스 길이 0이 그렇습니다. macOS에서 향상 모드의 도우미 utun 유형은 현재 기본 게이트웨이를 포함하는 항목도 거부합니다. 네트워크 확장 유형에서는 그 이유가 Chute의 로그가 아니라 시스템 로그에 남습니다.

참고: iPhone에서는 로컬 네트워크를 잡을지 여부를 시스템이 따로 결정합니다. 여기에 적은 로컬 서브넷은 앱 설정의 로컬 네트워크 포함도 켜져 있어야 적용되며, 이 스위치는 모든 네트워크 포함이 켜져 있을 때만 켤 수 있습니다. 다른 앱의 터널이 가진 대역에는 그런 스위치가 필요 없습니다. Chute tvOS에도 같은 스위치가 있지만 터널에 적용하지는 않습니다. macOS에서는 라우트가 곧바로 설치되므로 그런 관문이 없습니다.

참고: macOS에서 향상 모드의 도우미 utun 유형은 인터페이스를 붙일 때 이 라우트들을 설치하므로, 목록이 바뀌면 재로드 시 인터페이스를 다시 붙입니다. 이 옵션에는 도우미 버전 0.8.6 이상이 필요합니다 — Chute를 업데이트한 뒤 도우미 재설치 요청을 한 번 승인하세요. 그러지 않으면 도우미 utun 유형은 도우미가 실행 중이 아니라고 보고합니다.


프로토콜 스니핑

sniffing-enabled = true
sniffing-timeout = 100

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

sniffing-enabled (기본값: false)

sniffing-enabled = true

TCP 연결에 대한 프로토콜 감지를 활성화합니다. 향상 모드에서는 같은 스위치로 순수 IP 주소로 향하는 HTTP/3(QUIC) 흐름도 이름으로 일치할 수 있습니다. Chute는 QUIC ClientHello에서 서버 이름을 읽고, DOMAIN 계열 규칙은 주소 대신 그 이름을 보며, 같은 흐름의 이후 패킷은 모두 첫 패킷의 판정을 따릅니다. 한 패킷에 담기지 않는 큰 ClientHello(양자 내성 키 교환에서 흔함)는 이를 실어 나르는 Initial 패킷들로부터 흐름 단위로 재조립되며(재조립된 hello는 최대 16 KiB) 이름도 읽힙니다. hello의 나머지가 아직 오는 동안 그 흐름의 데이터그램은 순수 주소로 보내지 않고 보류되었다가, 이름을 읽은 뒤 그 이름의 정책을 따라 함께 나갑니다 — 그래서 쪼개진 hello의 첫 조각이 나머지와 다른 경로를 타는 일이 더는 없습니다. 안전장치는 1초 대기, 흐름당 데이터그램 8개 또는 16 KiB, 동시에 재조립 중인 흐름 64개입니다. 이 중 하나라도 넘어선 흐름과, Initial 패킷이 끝내 ClientHello를 완성하지 못한 흐름은 예전처럼 주소로 일치합니다.

실제 주소로 향하는 연결에서는 Chute의 DNS 캐시에 그 주소의 이름이 이미 있더라도, 클라이언트가 직접 밝힌 이름(TLS SNI 또는 HTTP Host)을 규칙이 봅니다. 캐시는 주소 하나에 이름 하나, 즉 마지막으로 그 주소로 조회된 이름만 보관하며, 공유 주소에서는 그것이 다른 사이트의 이름일 수 있기 때문입니다. 연결에서 이름을 읽을 수 없을 때만 캐시의 이름을 사용합니다. HTTP 프록시용으로 작성된 요청(CONNECT 또는 요청 대상이 전체 URL인 요청)은 여전히 HTTP로 감지되지만, 거기에 적힌 호스트는 그 프록시가 다음에 갈 곳이지 이 연결의 이름이 아닙니다. 이 연결은 캐시의 이름이나 주소를 그대로 사용합니다. 서버가 먼저 데이터를 보내는 프로토콜에서는 읽을 이름이 없습니다. 포트 21, 22, 23, 25, 110, 119, 143, 587, 2222, 2525, 3306, 5900으로 향하는 연결은 감지를 거치지 않고 바로 연결되며, 그 밖의 포트에서는 이런 프로토콜이 sniffing-timeout이 지난 뒤에 연결됩니다.

sniffing-timeout (기본값: 100ms)

sniffing-timeout = 200

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


QUIC 차단

block-quic = auto

Chute가 감지된 QUIC(HTTP/3 포함) 트래픽을 거부할지 제어합니다. QUIC은 UDP를 사용하므로 Chute의 HTTP MitM으로 복호화할 수 없습니다. QUIC을 거부하면 호환 클라이언트가 TCP로 다시 시도하도록 유도하여 TCP 기반 프록시 처리와, 구성된 경우 HTTPS 복호화를 적용할 수 있습니다.

값 동작
off 전역 QUIC 차단을 적용하지 않습니다(기본값). 감지된 QUIC 트래픽은 일반 라우팅 규칙을 따릅니다.
on DIRECT로 라우팅된 트래픽을 포함하여 감지된 모든 QUIC 흐름을 거부합니다.
auto 최종 아웃바운드 정책이 프록시인 경우에만 감지된 QUIC을 거부합니다. DIRECT로 라우팅된 트래픽은 허용되며, REJECT로 라우팅된 트래픽은 해당 규칙에 따라 계속 거부됩니다.
all Surge에서 on을 쓰는 표기입니다.
all-proxy, per-policy Surge의 표기로, 둘 다 auto로 읽힙니다 — Chute에는 정책별 QUIC 차단이 없으므로 per-policy는 프록시를 거치는 모든 QUIC 흐름을 차단합니다. 프로필을 저장할 때는 쓴 단어가 그대로 유지됩니다.

TUN을 통해 들어오는 트래픽의 경우 Chute는 거부된 QUIC 흐름에 ICMP/ICMPv6 Port Unreachable 메시지로 응답하므로, 호환 클라이언트가 QUIC 시간 초과를 기다리지 않고 TCP로 폴백할 수 있습니다.

거부된 QUIC 흐름은 규칙이 어떤 정책을 골랐든 정책이 REJECT인 것으로 기록됩니다.

block-quic의 QUIC 감지는 자동으로 수행되며 sniffing-enabled가 필요하지 않습니다. sniffing-enabled는 프로토콜 스니핑 — TCP의 TLS와 QUIC 흐름의 서버 이름 — 을 제어합니다. 개별 QUIC 흐름을 규칙으로 처리하려면 PROTOCOL,QUIC,... 규칙을 사용하세요.


터널 안에서 ICMP에 응답

icmp-auto-reply = false

터널로 들어온 ICMP 에코 요청은 — IPv4든 IPv6든 — Chute가 직접 응답합니다. 응답은 로컬에서 생성되며 대상에는 아무것도 보내지 않습니다. 따라서 규칙이 REJECT하는 주소나 다운된 호스트를 포함해 모든 대상이 응답하므로, 터널 안에서 ping이 성공해도 대상에 도달할 수 있는지는 알 수 없습니다. false로 두면 응답을 멈춥니다. 요청은 기기 밖으로 중계되지만 그 응답은 터널을 통해 돌아오지 않으므로, ping은 끝내 응답받지 못합니다.

기본값: true. TUN을 통해 들어온 트래픽에 적용되며, ICMP가 프록시를 거치는 일은 없습니다.


TUN 우회

bypass-tun = 192.168.0.0/16, 10.0.0.0/8

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

참고: 이 옵션은 iOS와 tvOS의 패킷 터널에 적용되며, 그곳에서 이 범위들은 tun-excluded-routes와 함께 터널의 제외 라우트가 됩니다. Android 13 이상의 Chute Android에도 같은 방식으로 적용됩니다(Android 11과 12는 무시합니다). macOS에서는 두 향상 모드 유형 모두에서 이 범위들이 tun-excluded-routes에 합쳐집니다 — 제외 라우트를 참조하세요.


거부 시 오류 페이지 표시

show-error-page-for-reject = true

활성화되면 Chute는 거부된 요청에 대해 사용자 친화적인 오류 페이지를 반환합니다. 이는 HTTP 프록시 인바운드로 들어온 요청에만 해당합니다. 옵션이 꺼져 있으면 그런 요청에는 대신 HTTP/1.1 503 Service Unavailable로 응답합니다. 다른 인바운드에서 거부된 요청은 어느 쪽이든 그냥 버려집니다.

기본값: false.


낙관적 DNS

optimistic-dns = false

활성화되면 TTL이 지난 캐시 레코드도 즉시 반환되며, 동시에 백그라운드에서 다시 조회됩니다. 이는 오래된 DNS 레코드가 반환될 수 있다는 대가로 연결 지연 시간을 줄입니다. 만료된 레코드가 이렇게 반환되는 것은 제한된 시간 동안뿐입니다. 해당 레코드 자체의 TTL과 같은 시간(최소 5분)까지이며, 그 이후에는 질의가 업스트림의 응답을 기다립니다. 끄면 TTL이 지난 레코드는 반환되지 않고 질의가 업스트림으로 갑니다. 그 응답이 캐시를 다시 채우므로 다음 조회는 캐시에서 응답됩니다. 다른 네트워크로 전환되거나 DNS 서버 목록이 바뀌면 캐시된 모든 레코드가 만료된 것으로 처리됩니다. 또한 모든 플랫폼에서 한 이름의 여러 주소로 동시에 연결할지도 이 설정이 결정합니다.

기본값: true. 비활성화하려면 optimistic-dns = false를 설정하세요.


Wi-Fi 접근 허용 PRO

allow-wifi-access = true

같은 네트워크의 다른 기기가 Chute의 HTTP 및 SOCKS5 프록시 포트에 접근할 수 있게 합니다. 두 리스너의 바인드 주소를 0.0.0.0으로 넓히는 동작입니다. Surge 스타일 구성(그리고 sing-box 가져오기의 allow-lan 매핑)은 이 플래그만 담고 interface는 기본값 127.0.0.1로 두기 때문에, 플래그 자체가 바인드 주소를 넓혀야 합니다. 이것은 Chute Pro 기능입니다: 그것이 없으면 플래그와 와일드카드 interface는 무시되고, 두 리스너는 127.0.0.1에 머물며, 따라서 iOS와 tvOS에서는 시작되지 않습니다.

앱에도 이를 위한 스위치 LAN 연결 허용이 있습니다: Chute Mac에서는 메뉴 막대 메뉴에(메뉴 막대 패널에서는 LAN 연결), Chute iOS와 Chute Android에서는 제어판에 있으며, Chute tvOS에는 없습니다. 스위치는 구성이 요구하는 상태로 시작하며, 현재 실행 동안에만 두 리스너를 모든 인터페이스로 옮기거나 127.0.0.1로 되돌립니다. 리스너가 모든 인터페이스에서만 실행되는 iOS에서는 리스너를 시작하고 멈추기도 합니다. 구성에는 아무것도 기록되지 않습니다: 다음 시작이나 받아들여진 재로드는 구성에 적힌 대로 돌아갑니다. 켜려면 Chute Pro가 필요하지만 끌 때는 필요 없습니다.

이 플래그와 명시적인 와일드카드 interface는 같은 의도의 두 가지 표기이며 Chute는 합집합을 취합니다. 이미 0.0.0.0을 적어 둔 구성의 동작은 그대로입니다. 플래그를 바꾸면 두 리스너가 다시 바인딩되므로, 접근을 회수하면 다음 시작이 아니라 재로드 시점에 적용됩니다.

이들은 프록시 포트이며 http-auth를 설정하지 않으면 인증이 없습니다. 통제하지 않는 네트워크에서는 자격 증명도 함께 설정하세요.


관리형 구성

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

첫 줄에 #!MANAGED-CONFIG 헤더가 있는 구성은 해당 URL에서 자동으로 다시 가져옵니다. 헤더 매개변수와 업데이트 동작은 관리형 구성에 문서화되어 있습니다.


복제 / 트래픽 기록 PRO

replica = true

[General]의 replica 키(replica = true)가 트래픽 기록을 활성화합니다. [Replica] 섹션은 Chute Dashboard에 표시되는 내용을 필터링하며, 해당 키는 복제에 문서화되어 있습니다.

유효한 Chute Pro 라이선스가 모든 플랫폼에서 필요합니다: 그것이 없으면 replica = true여도 아무것도 캡처되지 않고, 이전에 라이선스가 있던 실행이 남긴 본문도 다시 읽을 수 없습니다.


외부 컨트롤러 접근 (Chute Dashboard)

external-controller-access = password@0.0.0.0:6155

Chute Dashboard가 사용하는 원격 제어 서버를 시작합니다. 값은 password@host:port 형식이며, 비밀번호 앞에 선택적으로 사용자 이름을 붙일 수 있습니다(user:password@host:port). iOS와 tvOS에서는 보조 USB 채널이 port + 1에서 열립니다(macOS에서는 열리지 않습니다). 연결 방법은 Chute Dashboard 페이지에 있습니다.


HTTP 제어 API 및 웹 콘솔

이 내용은 별도 페이지로 이동했습니다: HTTP 제어 API 및 웹 콘솔.


프록시 테스트 URL

[General]
proxy-test-url = http://cp.cloudflare.com/generate_204
test-timeout = 3

proxy-test-url은 자체 url을 설정하지 않은 모든 url-test, fallback, load-balance 그룹의 측정 URL이고, test-timeout(초)은 timeout이 없는 그런 그룹의 시간 제한입니다. 구성을 저장한 뒤에도 그룹은 이 키들을 계속 따르며, 그룹 줄에 쓴 url이나 timeout만 이를 덮어씁니다. 잘못된 proxy-test-url은 구성 오류입니다. internet-test-url은 웹 콘솔의 직접 인터넷 테스트에서 사용되며 프록시를 거치지 않습니다. 설정하지 않으면 엔진의 내장 성공 확인 URL을 사용합니다.


UDP를 지원하지 않는 정책의 UDP

udp-policy-not-supported-behaviour = DIRECT

정책이 UDP를 중계할 수 없을 때(예: 일반 HTTP 프록시) 그 UDP 데이터그램을 어떻게 처리할지 정합니다. REJECT(기본값)는 버리고, DIRECT는 대신 직접 보냅니다. block-quic은 이보다 먼저, 규칙이 고른 정책을 기준으로 판정됩니다: block-quic = auto이면 UDP를 중계할 수 없는 프록시로 향하는 QUIC은 직접 보내지지 않고 거부됩니다. 그 밖의 UDP는 여전히 DIRECT로 폴백합니다. 상위를 거쳐 UDP를 보낼 수 없는 체이닝 정책의 UDP도 같은 방식으로 처리됩니다. 아웃바운드 모드를 따르는 DoQ나 DoH3 업스트림이 UDP를 나르지 않는 정책에 해당할 때도 마찬가지로, REJECT는 그 업스트림을 건너뛰고 DIRECT는 직접 질의합니다.


프런트 프록시

[General]
global-underlying-proxy = Airport

자신의 underlying-proxy가 없는 모든 프록시 정책을 지정한 정책 또는 그룹을 거쳐 연결하게 합니다. Shadowrocket이 프런트 프록시(前置代理)라고 부르며 앱에서만 설정하는 기능입니다. 프록시 제공자의 정책도 포함됩니다. 다음은 그대로 둡니다: 프런트 정책 자체를 거치는 연결이 지날 수 있는 모든 정책(그 멤버, 그들의 상위, 그 안의 릴레이 홉 — 그래서 프런트 정책이 자기 자신을 거치는 일은 없습니다), 제외를 뜻하는 underlying-proxy=DIRECT를 적은 정책, 멤버가 결정하는 정책 그룹, 그리고 DIRECT, REJECT, TAILSCALE. 키를 적지 않거나 DIRECT를 적으면 꺼집니다. 정의되지 않은 이름이면 적용 대상이 될 모든 정책이 직접 연결되는 대신 거부됩니다.

close-if-proxy-chain-missing(Shadowrocket)은 읽히고 프로필을 저장할 때 다시 기록됩니다. Chute는 언제나 그 값이 true일 때처럼 동작해, 상위가 없는 체이닝 정책을 거부합니다. Shadowrocket의 기본값인 false(없는 홉을 건너뛰고 노드에 직접 연결)는 따르지 않으며, 그렇다는 알림을 한 번 남깁니다.


클라이언트 지문

global-client-fingerprint = chrome

자체 fingerprint를 지정하지 않은 모든 정책에 TLS 클라이언트 지문을 설정합니다. 프록시 제공자가 제공하는 정책도 포함됩니다. 정책 자체의 값이 항상 우선하므로 이것은 덮어쓰기가 아니라 기본값입니다.

사용할 수 있는 값은 chrome, firefox, safari, ios 그리고 edge, 360, qq, android, random이며 뒤의 값들은 모두 Chrome으로 처리됩니다. 그 밖에 fingerprint에 나열한 이름도 쓸 수 있습니다. 인식할 수 없는 값은 경고 Ignoring unsupported global-client-fingerprint '<value>'와 함께 무시되고 플랫폼 TLS 스택이 사용됩니다.

기본값: 비어 있음(플랫폼 TLS 스택). ShadowTLS와 AnyTLS 정책은 항상 이 값을 읽고, Trojan, VMess, VLESS 정책은 tls=true나 reality=true를 설정했을 때, Shadowsocks 정책은 ws=true와 tls=true를 모두 설정했거나 shadow-tls-password를 설정했을 때 읽습니다. REALITY 없이 gRPC 전송을 쓰는 정책도 tls=true를 써야 합니다. ShadowsocksR 정책은 이 값을 읽지 않습니다.

S. Smart Rabbit LLC © All Rights Reserved            updated 2026-11-19 16:07:28

이 페이지는 영어판의 번역본입니다. 내용이 다를 경우 영어판이 우선합니다.

results matching ""

    No results matching ""