その他オプション
[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)。
- ドメイン上の全てのWebサイトを指定するには、ドメイン名の前にアスタリスクを使用します(例: *apple.com)。
- ドメインの特定の部分を指定するには、各部分を指定します(例: store.apple.com)。
- IPアドレスでホストまたはネットワークを指定するには、192.168.2.11のような特定のIPアドレス、または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では、この2つのリスナーはすべてのインターフェースにバインドされている場合 — 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が示すもので、WebコンソールのOverview(概要)ページにも表示されます。SOCKS5のUDPリレーは独自のポートにバインドされ、TCPリスナーと一緒には移りません。TCP側が移った後も、リレーは設定したポートのままのことも、まったく別のポートのこともあります。UDP ASSOCIATEの応答には常にリレーが実際に使っているポートが入るため、RFC 1928のとおり応答が示す宛先にデータグラムを送るクライアントには影響ありません。
portとsocks-portには1から65535までの値を指定してください: 設定の読み込み時には範囲がチェックされず、範囲外の値ではサーバーが起動しないか、別のポートで待ち受けることになります。http-listen / socks5-listenで書いた場合、そのようなポートは設定エラーになります。
平文のhttp://リクエストでは、HTTPプロキシサーバーの1つの接続が運ぶのは1回のやり取りだけです。各レスポンスは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はプッシュ、iCloudのゲートウェイ、キャプティブポータルの確認、OCSPなど、Appleのホスト名 18 件の固定リストをskip-proxyに追加し、さらにIP-CIDR,17.0.0.0/8,DIRECT,no-resolveをルールの後ろ、FINALの直前に追加します — そのため、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。これはグローバル設定であり、全てのポリシーグループに影響します。
Network Framework(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。
メニューバー速度表示(Macのみ)
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 Speakersは常に8.8.8.8を使用します)。このオプションを使用してクエリをハイジャックし、フェイクIPアドレスを取得できます。
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の拡張モードのNetwork Extension方式は、警告を残さずに受け入れます。このオプションを使う理由として多いのは、別のVPNアプリのトンネルが持つ範囲に到達したい場合です。注意: Chute自身の足元を切り落としてしまうようなエントリは拒否され、理由がログに残ります: ループバック、VIF自身のサブネット(
198.18.0.0/15とfd12:1:1:1::/64)、リンクローカル、マルチキャスト、ブロードキャスト、そしてプレフィックス長0です。macOSの拡張モードのHelper utun方式は、さらに現在のデフォルトゲートウェイを含むエントリも拒否します。Network Extension方式では、理由はChuteのログではなくシステムログに残ります。注意: iPhoneでは、ローカルネットワークを捕捉するかどうかをシステムが別途決めます。ここに挙げたローカルサブネットが効くのは、アプリの設定でローカルネットワークを含むも有効になっているときだけです — このスイッチはすべてのネットワークを含むがオンのときにしかオンにできません。別のアプリのトンネルが持つ範囲には、このスイッチは要りません。Chute tvOSにも同じスイッチがありますが、トンネルには適用されません。macOSではルートが直接インストールされるため、このようなゲートはありません。
注意: macOSでは、拡張モードのHelper utun方式がインターフェースの接続時にこれらのルートをインストールするため、リストを変更すると再読み込み時にインターフェースが接続し直されます。このオプションにはヘルパーのバージョン 0.8.6 以降が必要です — Chuteの更新後、ヘルパーの再インストールを求めるプロンプトを一度承認してください。承認しないと、Helper utun方式はヘルパーが実行されていないと報告します。
プロトコルスニッフィング
sniffing-enabled = true
sniffing-timeout = 100
Chuteは初期バイトを検査することで接続の実際のプロトコルを検出できます。これにより、非HTTPインバウンド接続でもPROTOCOL,TLS,Proxyのようなルールが正しく機能します。
sniffing-enabled(デフォルト: false)
sniffing-enabled = true
TCP接続のプロトコル検出を有効にします。拡張モードでは、同じスイッチにより、素のIPアドレス宛てのHTTP/3(QUIC)フローも名前で照合できます。ChuteはQUICのClientHelloからサーバー名を読み取り、DOMAIN系ルールはアドレスの代わりにその名前を見ます。同じフローの後続パケットはすべて最初のパケットの判定に従います。1 パケットに収まらない大きなClientHello(ポスト量子鍵交換では一般的)は、それを運ぶ各Initialパケットからフロー単位で再構成され(再構成後のhelloは最大 16 KiB)、名前も読み取られます。helloの残りが届くまでの間、そのフローのデータグラムは素のアドレスで送出されずに保留され、名前が読めた時点でその名前のポリシーに従ってまとめて送出されます — 分割されたhelloの最初の断片が残りと別経路をたどることはもうありません。歯止めは、待機 1 秒、1 フローあたり 8 データグラムまたは 16 KiB、同時に再構成中のフロー 64 本です。いずれかを超えたフロー、およびInitialパケットがいつまでもClientHelloを揃えられないフローは、従来どおりアドレスで照合されます。
実アドレス宛ての接続では、ChuteのDNSキャッシュがそのアドレスの名前をすでに持っていても、クライアント自身が示す名前(TLSのSNIまたはHTTPのHost)がルールに渡されます。キャッシュが 1 つのアドレスについて保持する名前は、最後にそのアドレスへ解決された 1 つだけで、共有アドレスでは別のサイトの名前かもしれないからです。接続から名前を読み取れない場合に限り、キャッシュの名前を使います。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
検出されたQUIC(HTTP/3を含む)トラフィックをChuteが拒否するかどうかを制御します。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経由のトラフィックでは、拒否された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サーバーの一覧が変わったときは、キャッシュされたすべてのレコードが期限切れとして扱われます。さらに、すべてのプラットフォームで、1 つの名前の複数アドレスへ同時に接続するかどうかも制御します。
デフォルト:
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とWebコンソール
この内容は独立したページに移動しました:HTTPコントロールAPIとWebコンソール。
プロキシテスト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はWebコンソールの直接インターネットテストで使われ、プロキシを経由しません。未設定の場合は、エンジン内蔵の成功確認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のポリシーは 読み取りません。
本ページは英語版からの翻訳です。内容に相違がある場合は、英語版が優先されます。