เอเจนต์ AI (MCP) PRO PREVIEW
PREVIEW หมายเหตุ: เซิร์ฟเวอร์ MCP อยู่ระหว่างการทดสอบภายในและยังไม่เผยแพร่ หน้านี้อธิบายบิลด์ที่อยู่ระหว่างการทดสอบ: คีย์ เส้นทาง ชื่อเครื่องมือ และหน้าจอของแอปอาจยังเปลี่ยนแปลงได้ก่อนเปิดตัว
[General]
external-mcp-server = 127.0.0.1:6180
เอนจินของ Chute Mac, Chute iOS และ Chute tvOS มีเซิร์ฟเวอร์ MCP (Model Context Protocol) ของตัวเอง เอเจนต์ AI — Claude Code, Codex หรือไคลเอนต์อื่นที่รองรับ MCP — เชื่อมต่อเข้ามาเพื่ออ่านว่าเอนจินกำลังทำอะไร (สถานะ นโยบาย กฎ การเชื่อมต่อ DNS บันทึก การกำหนดค่า) และเปลี่ยนแปลงได้ เช่น เลือกนโยบาย ลองกฎ เขียนส่วนหนึ่งของการกำหนดค่าใหม่ วัดสมาชิกของกลุ่ม
เซิร์ฟเวอร์นี้สร้างอยู่บนเส้นทางของ HTTP Control API และยืนยันตัวตนด้วยรหัสลับเดียวกัน แต่เป็นตัวรอรับการเชื่อมต่อแยกต่างหาก ที่ /mcp บนพอร์ตของตัวเอง จึงไม่ต้องใช้ทั้ง external-http-controller และคอนโซลเว็บ ค่าเริ่มต้นคือปิด
PRO หมายเหตุ: เซิร์ฟเวอร์ MCP เป็นส่วนหนึ่งของ Chute Pro หากไม่มีใบอนุญาต เอนจินจะไม่เริ่มเซิร์ฟเวอร์นี้
external-mcp-serverจะไม่เปิดพอร์ตใด และยังแก้ไขการกำหนดค่าได้ตามปกติ เมื่อใบอนุญาตมีผล เซิร์ฟเวอร์จะเริ่มทำงานโดยไม่ต้องเริ่ม Chute ใหม่ และจะหยุดเมื่อใบอนุญาตหมดไป ช่วงทดลองใช้ฟรีของ Chute Mac นับเป็นการมีใบอนุญาต ตัว HTTP Control API เองไม่ได้รับผลกระทบ สิ่งที่แอปแสดงในระหว่างนั้นดูได้ที่เมื่อไม่มี Chute Pro และดูใบอนุญาตและการเปิดใช้งานประกอบ
ใช้ทำอะไร
เอเจนต์เป็นผู้อ่าน คุณจึงถามด้วยคำพูดของตัวเองได้ ตัวอย่างเช่น:
- "ทำไม
api.example.comถึงออกทาง HK-01?" — เอเจนต์ถามmatch_ruleซึ่งบอกกฎและนโยบาย แล้วลองแก้ด้วยedit_user_rulesและเมื่อได้ผลก็เขียนลง[Rule]ด้วยreplace_profile_section - "โหนดไหนใน Auto ยังใช้ได้?" —
test_policyกับกลุ่มจะวัดสมาชิกทีละตัวและรายงานแต่ละตัวทันทีที่เสร็จ - "แอปนี้ต่อเซิร์ฟเวอร์ไม่ได้ตั้งแต่เช้า" —
list_connectionsพร้อมตัวกรองfailed,get_logsพร้อมคำค้น และrun_diagnosticsสำหรับตัวเครือข่ายเอง - "บล็อกโฆษณาในเว็บนี้" — ใช้
add_rewriteและadd_mitm_hostลองในเอนจินที่กำลังทำงาน แล้วจึงเขียนบรรทัดที่ต้องการเก็บไว้ลงในการกำหนดค่า
การเปิดใช้งาน
external-mcp-server (ค่าเริ่มต้น: ปิดใช้งาน)
external-mcp-server = 127.0.0.1:6180
ที่อยู่และพอร์ตของเซิร์ฟเวอร์ MCP คีย์นี้เป็นของ Chute เอง: Surge และ Clash ไม่มีสิ่งที่เทียบเท่า และการนำเข้าการกำหนดค่าของทั้งสองจะไม่เพิ่มคีย์นี้ ที่อยู่เขียนแบบเดียวกับ external-http-controller: 127.0.0.1:6180 สำหรับอุปกรณ์นี้เท่านั้น, 0.0.0.0:6180 หรือ *:6180 สำหรับทุกอินเทอร์เฟซ, [::]:6180 สำหรับ IPv6 และทั้ง 127.0.0.0/8, ::1 และ localhost นับเป็นลูปแบ็ก ที่อยู่ที่แยกวิเคราะห์ไม่ได้ถือเป็นข้อผิดพลาดของการกำหนดค่า แอปใช้พอร์ต 6180 เมื่อเปิดใช้งาน
การยืนยันตัวตน เอเจนต์ส่ง Authorization: Bearer <token> และโทเคนคือโทเคนของ HTTP Control API:
external-http-secretเมื่อการกำหนดค่ามีค่านี้- มิฉะนั้นคือโทเคนที่ Chute สร้างและเก็บไว้ในไฟล์
control-tokenในโฟลเดอร์แชร์ — สร้างขึ้นแม้external-http-controllerจะปิดอยู่ และแสดงในแอป external-http-secret = noneหมายถึงไม่ยืนยันตัวตนเลย และยอมรับเฉพาะบนที่อยู่ลูปแบ็ก
นอกลูปแบ็ก เซิร์ฟเวอร์ MCP ต้องมี external-http-secret ที่ระบุไว้ชัดเจน: โทเคนที่สร้างขึ้นหรือ none ไม่เพียงพอ หากไม่มี เซิร์ฟเวอร์จะไม่เริ่มทำงาน และแอปจะแสดงเหตุผล
ทำงานไปพร้อมกับเอนจิน เริ่มเมื่อ Chute เริ่มและหยุดเมื่อ Chute หยุด เอเจนต์จึงเริ่มหรือหยุด Chute ไม่ได้ และสั่งให้แอปสลับไปใช้การกำหนดค่าอื่นไม่ได้ การโหลดใหม่จะเริ่มตัวรอรับการเชื่อมต่อใหม่ก็ต่อเมื่อที่อยู่หรือรหัสลับเปลี่ยน และหลังจากเขียนคำตอบที่กำลังส่งอยู่เสร็จแล้วเท่านั้น — เอเจนต์ที่เปลี่ยนที่อยู่ของเซิร์ฟเวอร์ MCP เองก็ยังได้รับคำตอบของตน
external-mcp-mask-secrets (ค่าเริ่มต้น: true)
external-mcp-mask-secrets = false
กำหนดว่ารหัสผ่าน คีย์ และโทเคนจะไปถึงเอเจนต์ในรูปของแฮนเดิลหรือไม่ — ดู การปิดบังข้อมูลลับ นี่เป็นคีย์ของ Chute เองเช่นกัน และจะเขียนลงการกำหนดค่าเฉพาะเมื่อเป็น false
ในแอป
- Chute iOS: ในตัวแก้ไขการกำหนดค่า ตัวควบคุมภายนอก → เซิร์ฟเวอร์ MCP: สวิตช์, พอร์ต, อนุญาตการเข้าถึงจาก Wi-Fi (รอรับที่
0.0.0.0และแถว รหัสลับ ที่ต้องใช้คือรหัสลับของ HTTP Control API) และ ปิดบังข้อมูลลับ แถว เอเจนต์ AI (MCP) ในแผงควบคุม ใต้คอนโซลเว็บ แสดง กำลังทำงาน, ยังไม่เริ่มทำงาน หรือ ยังไม่ได้ตั้งค่า และเปิดหน้าที่มีเหตุผลที่เซิร์ฟเวอร์ไม่รอรับ ที่อยู่สำหรับ อุปกรณ์นี้ และ (นอกลูปแบ็ก) สำหรับ อุปกรณ์อื่น โทเคน (ซ่อนไว้จนกด แสดงโทเค็น แตะแถวเพื่อคัดลอก) การตั้งค่าไคลเอนต์ พร้อมคำสั่งclaude mcp addและ JSON ที่ใช้ได้ทันที และ การทำงานด่วน เซิร์ฟเวอร์ MCP ทำงานอยู่ใน VPN: เมื่อปิด VPN หน้านี้จะบอกว่าการกำหนดค่าปัจจุบันจะทำอะไร - Chute Mac: แท็บ การกำหนดค่า ของหน้าต่างหลัก → ทั่วไป → เซิร์ฟเวอร์ MCP: เปิดใช้งานเซิร์ฟเวอร์ MCP, ที่อยู่และพอร์ต, รหัสลับที่ใช้ร่วมกับ HTTP Control API, ปิดบังข้อมูลลับ และ สถานะและการตั้งค่าไคลเอนต์… ขณะ Chute ทำงาน เอเจนต์ AI (MCP)… ในเมนูของแถบเมนู (และในเมนู … ของแผงแถบเมนู) จะเปิดหน้าต่างที่แสดงสถานะ ที่อยู่ โทเคน (แสดง, คัดลอก) การปิดบังข้อมูลลับ และ เชื่อมต่อเอเจนต์: การตั้งค่าสำหรับ Claude Code ผ่าน HTTP สำหรับ Claude Code ผ่านคำสั่ง
chuteและ JSON สำหรับไคลเอนต์อื่น - Chute tvOS: แก้ไขการกำหนดค่า → ทั่วไป → เซิร์ฟเวอร์ MCP: เปิดหรือปิด, ที่อยู่สำหรับรอรับการเชื่อมต่อ (
127.0.0.1หรือ0.0.0.0), พอร์ต และ ปิดบังข้อมูลลับ หน้าเดียวกันนี้ใช้ตั้งรหัสลับด้วย ซึ่งก็คือexternal-http-secretของ HTTP Control API ค่าจะแสดงแบบปิดบังไว้จนกว่าคุณจะเลือกให้แสดง หากเว้นว่างจะใช้โทเค็นที่ Chute สร้างขึ้น และnoneคือไม่ยืนยันตัวตน ซึ่งจะมีคำเตือนถึงอันตรายก่อน รหัสลับต้องไม่มีช่องว่างหรือการขึ้นบรรทัดใหม่ เมื่อเปลี่ยนรหัสลับ การยืนยันตัวตนของคอนโซลเว็บและคำสั่งchuteก็จะเปลี่ยนตามไปด้วย หากใช้0.0.0.0แต่ไม่มีรหัสลับ หน้านี้จะแจ้งว่าเซิร์ฟเวอร์จะไม่เริ่มทำงาน และให้คุณตั้งรหัสลับได้ทันทีตรงนั้น แถว เอเจนต์ AI (MCP) ในแผงควบคุมแสดงสถานะ, ที่อยู่, ที่อยู่ LAN และ โทเค็น ซึ่งซ่อนไว้จนกว่าจะเลือก บนทีวีไม่มีการคัดลอก
สวิตช์ด่วน — การทำงานด่วน บน iOS, เปิด MCP / ปิด MCP และ ปิดบังข้อมูลลับ ในหน้าต่างของ Mac, เซิร์ฟเวอร์ MCP และ ปิดบังข้อมูลลับ บนหน้าของทีวี — จะเปลี่ยนสองคีย์นี้ในไฟล์การกำหนดค่าปัจจุบันและนำไปใช้ทันที เมื่อเปิดจากตรงนี้ เซิร์ฟเวอร์จะรอรับที่ 127.0.0.1:6180 บน iOS สวิตช์เหล่านี้ใช้ไม่ได้กับการสมัครรับ เพราะการอัปเดตครั้งถัดไปจะลบล้างการเปลี่ยนแปลง
เมื่อไม่มี Chute Pro
เมื่อไม่มีใบอนุญาต แอปจะบอกว่าเซิร์ฟเวอร์ต้องใช้ Chute Pro แทนที่จะรายงานว่ายังไม่รอรับการเชื่อมต่อ:
- Chute Mac: เอเจนต์ AI (MCP)… ในเมนูของแถบเมนูและในเมนู … ของแผงแถบเมนู รวมถึง เปิดใช้งานเซิร์ฟเวอร์ MCP ในหน้า ทั่วไป มีแคปซูล PRO หน้าต่าง เอเจนต์ AI (MCP) จะขึ้นต้นด้วยหมายเหตุเรื่อง Chute Pro และปุ่ม รับ Chute Pro สถานะแสดงเป็น ต้องใช้ Chute Pro โดยไม่แสดงที่อยู่และโทเค็น เปิด MCP จะเปิดหน้าต่าง Chute Pro แทนการเปิดเซิร์ฟเวอร์ ส่วนการปิดและ ปิดบังข้อมูลลับ ใช้ได้ตามปกติ หน้าต่าง Chute Pro มี เอเจนต์ AI (MCP) อยู่ในรายการคุณสมบัติ
- Chute iOS และ Chute tvOS: แถว เอเจนต์ AI (MCP) ในแผงควบคุมและสวิตช์ MCP ในตัวแก้ไขการกำหนดค่ามีแคปซูล PRO หน้าสถานะแสดง ต้องใช้ Chute Pro และแสดงทางไปสู่ Chute Pro แทนที่อยู่และโทเค็น การเปิดเซิร์ฟเวอร์ด้วยสวิตช์ด่วนในหน้านั้นจะขอ Chute Pro ก่อน เหมือนสวิตช์ Chute Pro อื่น ๆ ของแอป
- ในทั้งสามแอป ช่องต่าง ๆ ในตัวแก้ไขการกำหนดค่ายังแก้ไขได้ และข้อความที่แจ้งรายการคุณสมบัติ Chute Pro ที่ไม่ได้ทำงานในรอบนี้จะระบุเซิร์ฟเวอร์ MCP ด้วย
การเชื่อมต่อเอเจนต์
ผ่าน HTTP
ไคลเอนต์ที่รองรับ Streamable HTTP เชื่อมต่อได้โดยตรง:
- ที่อยู่:
http://<host>:<port>/mcp— สำหรับเอเจนต์บนอุปกรณ์เดียวกันคือhttp://127.0.0.1:6180/mcp - ส่วนหัว:
Authorization: Bearer <token>โดยใช้โทเคนที่แอปแสดง
สำหรับ Claude Code:
claude mcp add --transport http chute http://127.0.0.1:6180/mcp --header "Authorization: Bearer <token>"
สำหรับไคลเอนต์ที่ตั้งค่าด้วย JSON:
{"mcpServers": {"chute": {"type": "http", "url": "http://127.0.0.1:6180/mcp", "headers": {"Authorization": "Bearer <token>"}}}}
Chute iOS และ Chute Mac จะคัดลอกทั้งสองแบบโดยใส่ที่อยู่และโทเคนไว้ให้แล้ว บน iPhone แอปเอเจนต์บน iPhone เครื่องเดียวกันก็เชื่อมต่อผ่าน 127.0.0.1 ได้เช่นกัน
เซิร์ฟเวอร์ใช้ MCP 2026-07-28 และยอมรับไคลเอนต์ของ 2025-11-25, 2025-06-18 และ 2025-03-26 ไม่เก็บเซสชัน: ข้อความ JSON-RPC แต่ละข้อความคือ POST หนึ่งครั้งไปยัง /mcp ตอบกลับด้วย JSON — หรือสำหรับเครื่องมือที่ใช้เวลานาน ด้วยสตรีมเหตุการณ์ — แล้วปิดการเชื่อมต่อ GET, DELETE และ OPTIONS ได้รับ 405 คำขอแบบกลุ่ม (อาร์เรย์ JSON) ถูกปฏิเสธ เนื้อหาคำขอจำกัดที่ 1 MB และให้บริการพร้อมกันได้สูงสุด 8 การเชื่อมต่อ
ผ่าน chute mcp
ไคลเอนต์ที่เริ่มเซิร์ฟเวอร์ MCP ได้เฉพาะในรูปของโปรแกรมที่ตนเปิดเอง — หรือไคลเอนต์ที่ไม่ควรมีโทเคนอยู่ในการกำหนดค่า — ใช้เครื่องมือบรรทัดคำสั่ง chute เป็นตัวส่งต่อ: chute mcp ส่งแต่ละบรรทัดที่อ่านได้ไปยังเซิร์ฟเวอร์ MCP และเขียนแต่ละคำตอบกลับเป็นหนึ่งบรรทัด
claude mcp add chute -- chute mcp
{"mcpServers": {"chute": {"command": "chute", "args": ["mcp"]}}}
บน Mac ที่กำลังรัน Chute แค่นี้ก็พอ: chute mcp อ่านที่อยู่และโทเคนจากไฟล์ปลายทางทุกครั้งที่มีข้อความ จึงพบ Chute ที่เริ่มหลังไคลเอนต์ได้ด้วย โทเคนมาจากแหล่งแรกที่พบในลำดับนี้:
--token-file <path>- ตัวแปรสภาพแวดล้อม
CHUTE_MCP_TOKEN - เฉพาะเซิร์ฟเวอร์บน Mac เครื่องนี้: ไฟล์ปลายทาง แล้วจึง
control-tokenในโฟลเดอร์แชร์
--url http://<host>:<port>/mcp ชี้ไปยังอุปกรณ์อื่น CHUTE_MCP_ENDPOINT ระบุไฟล์ปลายทางที่จะอ่านแทน --token และ --token-stdin จะถูกปฏิเสธ เพราะอินพุตมาตรฐานคือช่องทาง MCP เอง และโทเคนในบรรทัดคำสั่งจะไปอยู่ในการกำหนดค่าของไคลเอนต์และรายการโปรเซส เมื่อติดต่อเซิร์ฟเวอร์ไม่ได้ เอเจนต์จะได้รับข้อผิดพลาดที่บอกเหตุผล — พอร์ตที่ปิดอยู่ชี้ไปที่ external-mcp-server ส่วน 401 ชี้ไปที่โทเคน
จากคอมพิวเตอร์ไปยัง iPhone หรือ Apple TV
บนอุปกรณ์ ให้รอรับบนเครือข่ายและตั้งรหัสลับ:
[General] external-mcp-server = 0.0.0.0:6180 external-http-secret = a-long-random-secretบน iOS คือ อนุญาตการเข้าถึงจาก Wi-Fi และแถว รหัสลับ บน tvOS คือ ที่อยู่สำหรับรอรับการเชื่อมต่อ
0.0.0.0และรหัสลับ ในหน้าเดียวกัน- เชื่อมต่อ VPN แล้วอ่านที่อยู่ใต้ อุปกรณ์อื่น (iOS) หรือ ที่อยู่ LAN (tvOS) — เช่น
http://192.168.1.20:6180/mcp บนคอมพิวเตอร์ในเครือข่ายเดียวกัน:
claude mcp add --transport http chute-phone http://192.168.1.20:6180/mcp --header "Authorization: Bearer a-long-random-secret"หรือเก็บรหัสลับไว้ในไฟล์:
chute mcp --url http://192.168.1.20:6180/mcp --token-file ~/.config/chute/phone.token
ที่อยู่นี้คือที่อยู่ของอุปกรณ์บนเครือข่าย จึงเปลี่ยนเมื่อเครือข่ายให้ที่อยู่อื่นแก่อุปกรณ์
ไฟล์ปลายทาง
ขณะเซิร์ฟเวอร์ MCP รอรับการเชื่อมต่อ เอนจินจะเขียน mcp-endpoint ลงในโฟลเดอร์แชร์ โดยอ่านได้เฉพาะเจ้าของ และลบเมื่อเซิร์ฟเวอร์หยุด ไฟล์นี้เป็นออบเจกต์ JSON ที่ค่าเป็นสตริงทั้งหมด: running, configured, url, lan_url (นอกลูปแบ็ก), bind, port, loopback, token, anonymous และ mask_secrets — สิ่งเดียวกับที่แอปแสดง บน Mac อยู่ที่ ~/Library/Application Support/com.R3Studio.Chute-Mac/Share/mcp-endpoint (ดู ตำแหน่งไฟล์) ไคลเอนต์ในเครื่องจึงไม่ต้องรู้พอร์ตและโทเคน บน iPhone และ Apple TV ไฟล์นี้อยู่ในคอนเทนเนอร์ของแอป: ให้ดูที่อยู่จากแอป
การปิดบังข้อมูลลับ
สิ่งที่เอเจนต์อ่านจะถูกส่งไปยังผู้ให้บริการโมเดลของเอเจนต์ ดังนั้นโดยค่าเริ่มต้น ข้อมูลลับในการกำหนดค่าจะไม่ไปถึงเอเจนต์เลย: ข้อมูลลับแต่ละรายการจะถูกแทนด้วยแฮนเดิล เช่น <secret:password:3f9c0a1b2e> — ประเภทและตัวระบุ — ทุกที่ที่ปรากฏ ทั้งในการกำหนดค่าและในผลลัพธ์อื่นทุกอย่าง รวมถึงบันทึก ที่อยู่เซิร์ฟเวอร์ยังมองเห็นได้ เอเจนต์จึงยังรู้ว่าโหนดหรือการดาวน์โหลดชี้ไปที่เซิร์ฟเวอร์ใด
[Proxy]
HK-01 = trojan, hk.example.com, 443, password=<secret:password:3f9c0a1b2e>, sni=hk.example.com
[Proxy Group]
Sub = select, policy-path=https://sub.example.com<secret:url_secret:8d2e4f6a1c>
สิ่งที่ถูกปิดบัง: รหัสผ่านของพร็อกซี, UUID, คีย์ที่แชร์ล่วงหน้า, คีย์ส่วนตัว, รหัสผ่าน obfs และ shadow-tls และโทเคนอย่างของ MASQUE — รวมถึงของส่วน WireGuard และ AmneziaWG และของโหนดจากผู้ให้บริการพร็อกซี; รหัสผ่านของ http-auth, external-http-secret และรหัสผ่านของ external-controller-access; ca-p12 และ ca-passphrase; auth key ของ Tailscale; argument= ของสคริปต์; ส่วนพาธ คิวรี และข้อมูลผู้ใช้ของ URL การสมัครรับ, policy-path, ชุดกฎ, โมดูล และ #!MANAGED-CONFIG (สคีม โฮสต์ และพอร์ตยังคงอยู่); และค่าของส่วนหัวใน [Header Rewrite] ที่ชื่อ Authorization, Proxy-Authorization หรือมี token, key, secret, auth, password หรือ cookie อยู่ในชื่อ ข้อมูลลับที่สั้นกว่า 8 อักขระจะถูกแทนในตำแหน่งที่เป็นค่าของฟิลด์ แต่ไม่ถูกแทนในข้อความอิสระอย่างบรรทัดบันทึก ซึ่งแยกไม่ออกจากคำธรรมดา
การเขียนกลับ เมื่อเอเจนต์เขียนข้อความการกำหนดค่ากลับ แฮนเดิลที่ปล่อยไว้ตามเดิมจะกลับเป็นค่าที่มันแทน เอเจนต์จึงเปลี่ยนพอร์ตหรือชื่อของโหนด หรือจัดลำดับส่วนใหม่ได้โดยไม่ต้องรู้รหัสผ่าน แฮนเดิลยังย้ายหรือคัดลอกได้ แต่มีข้อจำกัดสองข้อ:
- กลับไปได้เฉพาะฟิลด์ประเภทเดียวกัน — แฮนเดิลรหัสผ่านไปที่ฟิลด์รหัสผ่าน
- บรรทัดนั้นต้องไปถึงเซิร์ฟเวอร์เดียวกับที่ข้อมูลลับมา: เซิร์ฟเวอร์ของพร็อกซี, โฮสต์ของ URL หรือคีย์
[General]เดียวกัน
แฮนเดิลที่อยู่ที่อื่น — บนบรรทัดของเซิร์ฟเวอร์อื่น ในกฎ ที่แต่งขึ้น หรือที่หมดอายุแล้ว (ดูด้านล่าง) — จะถูกปฏิเสธพร้อมหมายเลขบรรทัดและเหตุผล และไม่มีสิ่งใดถูกนำไปใช้: ค่านั้นคุณต้องพิมพ์เอง ข้อมูลลับใหม่ที่เอเจนต์เขียนออกมาเต็ม ๆ จะรับไว้ตามนั้น และแน่นอนว่ามันอยู่ในบริบทของเอเจนต์แล้ว
ค่าเดียวกันจะได้แฮนเดิลเดียวกันเสมอ เอเจนต์จึงเห็นได้ว่าสองโหนดใช้รหัสผ่านร่วมกัน แฮนเดิลใช้ได้เฉพาะขณะที่โปรเซสที่ออกแฮนเดิลนั้นยังทำงานอยู่ — จนกว่า Chute Mac จะปิด หรือจนกว่า VPN ของ Chute iOS หรือ Chute tvOS จะตัดการเชื่อมต่อ หลังจากนั้นจะถูกปฏิเสธ ให้เอเจนต์อ่านการกำหนดค่าอีกครั้ง
การปิดบังครอบคลุมข้อมูลลับของการกำหนดค่า ข้อมูลรับรองในทราฟฟิกของคุณเอง — คุกกี้ของเว็บไซต์ ส่วนหัว Authorization ที่แอปส่ง — ไม่ใช่ข้อมูลลับของการกำหนดค่าและจะไม่ถูกปิดบัง ซึ่งเป็นอีกเหตุผลที่ข้อมูลเหล่านี้จะให้เฉพาะเมื่อขออย่างชัดเจน (ดูด้านล่าง)
การปิด external-mcp-mask-secrets = false — หรือสวิตช์ ปิดบังข้อมูลลับ ในแอป — จะส่งข้อมูลลับทุกรายการตามที่เขียนไว้ให้เอเจนต์ และแจ้งเอเจนต์ด้วย ทำเช่นนี้เฉพาะเมื่อคุณยอมรับให้ข้อมูลรับรองเหล่านั้นเข้าไปอยู่ในบริบทของผู้ให้บริการโมเดลของเอเจนต์
เนื้อหาจากบุคคลที่สาม
ส่วนหัวและเนื้อหาของคำขอและคำตอบ บรรทัดบันทึก เอาต์พุตของสคริปต์ และข้อความของโมดูลที่ดาวน์โหลดจาก URL ล้วนเขียนโดยผู้อื่น — เว็บไซต์ แอป ผู้ดูแลเซิร์ฟเวอร์ หน้าเว็บอาจมีข้อความที่เขียนให้ดูเหมือนคำสั่งถึงเอเจนต์ ดังนั้น:
- โดยค่าเริ่มต้น เครื่องมือจะส่งคืนเฉพาะเมตาดาตา: โฮสต์ URL พอร์ต นโยบาย กฎ ชื่อโปรเซส จำนวนไบต์ เวลา และสถานะ
- เนื้อหาจะมาเฉพาะเมื่อเอเจนต์ขอ —
get_connectionพร้อมinclude,get_logs,run_script,get_module— และอยู่ใต้คีย์untrustedซึ่งเอเจนต์ได้รับแจ้งให้อ่านเป็นข้อมูล ไม่ใช่คำสั่ง
สิ่งนี้ช่วยให้บริบทของเอเจนต์สะอาดและประหยัดโทเคน แต่ไม่ใช่การควบคุมการเข้าถึง เอเจนต์ที่ถือโทเคนเรียก HTTP Control API โดยตรงและอ่านได้ทุกอย่าง
เครื่องมือ
เครื่องมือแต่ละตัวถูกระบุเป็นหนึ่งในสี่ประเภท ซึ่งไคลเอนต์ใช้ตัดสินว่าจะถามคุณก่อนเรียกหรือไม่
อ่านอย่างเดียว
| เครื่องมือ | ทำอะไร |
|---|---|
get_status |
เอนจินทำงานอยู่หรือไม่และอย่างไร: โหมดขาออก สวิตช์ TUN ตัวรอรับการเชื่อมต่อ หน่วยความจำ การเชื่อมต่อ การสิ้นสุดของรอบก่อน |
get_network_summary |
เครือข่ายที่อุปกรณ์อยู่ — ประเภท ชื่อ Wi-Fi เราเตอร์ — การตั้งค่า SSID ทำให้ Chute หยุดชั่วคราวที่นั่นหรือไม่ และที่อยู่ของอุปกรณ์ |
get_traffic |
ไบต์ขาขึ้นและขาลง และความเร็วปัจจุบัน |
list_policies |
กลุ่มพร้อมตัวเลือกปัจจุบัน โหนดปลายทางและเวลาแฝง; group สำหรับกลุ่มเดียวแบบเต็ม, detail สำหรับสมาชิกทั้งหมด |
get_policy |
บรรทัดการกำหนดค่าของนโยบายหนึ่งและสิ่งที่เอนจินรู้ตอนนี้: เซิร์ฟเวอร์ พอร์ต UDP เวลาแฝง ปลายทาง |
list_rules |
กฎตามลำดับการจับคู่และที่มาของแต่ละกฎ; filter ช่วยกรอง |
match_rule |
คำขอจะตรงกับกฎและนโยบายใด ทั้งก่อนและหลังแปลงชื่อ โดยไม่ส่งคำขอจริง |
list_user_rules |
กฎที่เพิ่มขณะเอนจินทำงาน |
list_connections |
การเชื่อมต่อที่เปิดอยู่หรือที่บันทึกไว้ เฉพาะเมตาดาตา; กรองตามโฮสต์ โปรเซส นโยบาย หรือที่ล้มเหลว |
get_connection |
การเชื่อมต่อหนึ่งรายการ; ส่วนหัวและเนื้อหาเฉพาะเมื่อระบุใน include |
get_logs |
บรรทัดของบันทึกเอนจิน ตามระดับขั้นต่ำและคำค้น |
get_events |
เหตุการณ์สำคัญของรอบนี้; after สำหรับเฉพาะรายการใหม่ |
list_dns_cache |
ระเบียน DNS และเซิร์ฟเวอร์ที่ตอบแต่ละรายการ |
query_dns |
แปลงชื่อด้วยตัวแปลงชื่อของเอนจินเองและบอกว่าตัวใดตอบ |
geoip_lookup |
ประเทศและ ASN ของที่อยู่หรือชื่อ |
get_profile |
การกำหนดค่าที่กำลังทำงาน ทีละหน้า พร้อม revision |
list_profile_sections |
ส่วนต่าง ๆ ของการกำหนดค่า แต่ละส่วนพร้อม revision และว่าเขียนได้หรือไม่ |
get_profile_section |
ข้อความและ revision ของส่วนหนึ่ง |
validate_profile |
แยกวิเคราะห์การกำหนดค่าแบบเดียวกับการโหลดใหม่ โดยไม่นำไปใช้ |
get_log_level |
ระดับบันทึกและส่วนที่กำลังบันทึก |
list_scripts |
สคริปต์ generic ที่ run_script รันได้ |
list_rewrites |
กฎการเขียนใหม่และการตอบกลับจำลองที่มีผลอยู่ และรายการโฮสต์ MitM |
list_mitm_hosts |
โฮสต์ที่กำลังถอดรหัส |
list_modules |
โมดูลที่โหลดอยู่ id ของแต่ละโมดูล และเปิดอยู่หรือไม่ |
get_module |
ข้อความของโมดูลหนึ่ง |
list_external_resources |
ชุดกฎ ผู้ให้บริการกฎ ผู้ให้บริการพร็อกซี และโมดูลที่ดึงมาจากที่อื่น: เวลาอัปเดต จำนวนรายการ ข้อผิดพลาดล่าสุด |
get_tailscale |
โหนด Tailscale: ตัวตน โหนดทางออก DERP และเพียร์เมื่อใช้ detail |
watch_events |
เฝ้าดูเหตุการณ์ของเอนจิน 1 ถึง 60 วินาทีแล้วส่งคืนทั้งหมด |
การทดสอบ
เครื่องมือเหล่านี้ส่งทราฟฟิกของตัวเอง
| เครื่องมือ | ทำอะไร |
|---|---|
test_policy |
คำขอ HTTPS หนึ่งครั้งผ่านนโยบาย พร้อมรหัสสถานะและเวลา; สำหรับกลุ่มคือสมาชิกทุกตัว รายงานทีละตัว |
test_policies |
หลายนโยบายหรือทั้งหมด รายงานทีละตัว |
ping |
ICMP หรือเวลาที่ใช้เปิดการเชื่อมต่อ TCP จากอุปกรณ์โดยตรง |
egress_probe |
ที่อยู่ของอุปกรณ์นี้เองบนเครือข่ายจริง |
internet_test |
คำขอหนึ่งครั้งไปยัง internet-test-url โดยไม่ผ่านพร็อกซี: มีอินเทอร์เน็ตอยู่หรือไม่ |
run_diagnostics |
สุขภาพของเอนจิน การทดสอบอินเทอร์เน็ต ที่อยู่ขาออก และการค้นหา DNS ทีละขั้น แล้วจึงสรุปเป็นรายงาน |
เวลาที่ test_policy รายงานสำหรับสมาชิกของกลุ่มเป็นเวลาไป-กลับของ HTTPS ส่วนการทดสอบของกลุ่มเองมักดึง URL แบบ HTTP ธรรมดา ตัวเลขจึงต่างจากที่กลุ่มใช้เลือก การทดสอบของกลุ่มเองจะรันหลังจากนั้นและเลือกตามปกติ
การตั้งค่า
| เครื่องมือ | ทำอะไร |
|---|---|
set_outbound_mode |
ตามกฎ สากล หรือตรง |
select_policy |
สมาชิกของกลุ่ม select หรือการเลือกระดับสากล (GLOBAL); กลุ่มอัตโนมัติเลือกเองและจะปฏิเสธ |
set_feature |
เปิดหรือปิด MitM หรือการบันทึกทราฟฟิก |
set_log_level |
ระดับบันทึกและส่วนที่บันทึก โดยไม่ต้องโหลดใหม่ |
edit_user_rules |
แทนที่ เพิ่ม หรือล้างกฎขณะทำงาน; หากมีบรรทัดที่ไม่ใช่กฎ การเปลี่ยนแปลงทั้งหมดจะถูกปฏิเสธ |
add_mitm_host, remove_mitm_host |
รายการโฮสต์ MitM |
add_rewrite, remove_rewrite |
กฎการเขียน URL ส่วนหัว หรือเนื้อหาใหม่ หรือกฎการตอบกลับจำลอง เขียนแบบบรรทัดการกำหนดค่า |
set_modules_enabled |
เปิดหรือปิดโมดูล |
update_external_resource |
ดึงชุดกฎ ผู้ให้บริการกฎ หรือผู้ให้บริการพร็อกซีทันที |
replace_profile_section |
แทนที่ส่วนหนึ่งของการกำหนดค่า (หรือเพิ่ม) แล้วโหลดใหม่ |
replace_profile |
แทนที่การกำหนดค่าทั้งหมดแล้วโหลดใหม่ |
ทำลายล้าง
| เครื่องมือ | ทำอะไร |
|---|---|
reload_profile |
ยกเลิกการเปลี่ยนแปลงขณะทำงาน: การเขียนใหม่ โฮสต์ MitM และสวิตช์โมดูลกลับไปตามการกำหนดค่า |
kill_connection |
ปิดการเชื่อมต่อที่เปิดอยู่หนึ่งรายการ; แอปอีกฝั่งจะเห็นการเชื่อมต่อหลุด |
flush_dns |
ล้างแคช DNS หรือระเบียนของชื่อหนึ่ง |
run_script |
รันสคริปต์ generic หนึ่งตัวในการกำหนดค่าและส่งคืนเอาต์พุต |
เครื่องมือตอบกลับอย่างไร
- สรุปเป็นค่าเริ่มต้น เครื่องมือแบบรายการให้เฉพาะฟิลด์หลักของแต่ละรายการ;
detail: trueให้ทุกฟิลด์ แลกกับโทเคนที่มากขึ้น - แบ่งหน้า รายการและข้อความยาวรับ
offsetและlimitและส่งคืนnext_offsetตราบที่ยังมีต่อ - ไม่เกิน 256 KB ผลลัพธ์ที่ใหญ่กว่าจะถูกตัดตามรายการหรือบรรทัด ไม่ตัดกลางรายการ และระบุ
truncated: trueพร้อมnext_offsetสำหรับอ่านต่อ — สิ่งที่ได้รับเป็น JSON ที่ถูกต้องเสมอ - ข้อผิดพลาดเป็นถ้อยคำ เครื่องมือที่ล้มเหลวจะบอกเหตุผลเป็นประโยคที่เอเจนต์นำไปแก้ไขได้ แทนรหัสสถานะเปล่า ๆ
การเปลี่ยนแปลงคงอยู่นานเท่าใด
บน Chute iOS และ Chute tvOS การเปลี่ยนแปลงทุกอย่างเกิดขึ้นเฉพาะในเอนจินที่กำลังทำงาน ไม่มีสิ่งใดถูกเขียนลงไฟล์การกำหนดค่าหรือการตั้งค่าของแอปเอง การเริ่มใหม่จึงนำค่าตามนั้นกลับมา เหมือนกับคอนโซลเว็บ
บน Chute Mac แอปจะเก็บการเปลี่ยนแปลงต่อไปนี้ไว้ เช่นเดียวกับที่เก็บการเปลี่ยนแปลงแบบเดียวกันจากเมนูของแอปเอง จึงยังคงอยู่หลังการเริ่มใหม่ — ไม่ว่าเอเจนต์จะเป็นผู้เปลี่ยน หรือเปลี่ยนผ่านคอนโซลเว็บ คำสั่ง chute หรือ HTTP Control API:
- โหมดขาออกและการเลือกนโยบาย รวมถึงการเลือกแบบ Global (
set_outbound_mode,select_policy): แอปจะจดจำไว้ - MitM และการบันทึกทราฟฟิก (
set_feature): เขียนลงไฟล์การกำหนดค่าปัจจุบัน - ตัวการกำหนดค่าเอง (
replace_profile,replace_profile_section): เขียนลงไฟล์การกำหนดค่าปัจจุบัน แล้วนำไปใช้แบบเดียวกับ บันทึกและนำไปใช้ ของแอป
ผลลัพธ์ของเครื่องมือเหล่านี้จะมี persisted: true และคำอธิบายที่เอเจนต์อ่านก็บอกเรื่องนี้ไว้ล่วงหน้า การเขียนการกำหนดค่าจะถูกปฏิเสธและไม่มีอะไรถูกเขียนในกรณีต่อไปนี้:
| สถานการณ์ | รหัส | สิ่งที่ควรทำ |
|---|---|---|
| หน้าต่างหลักมีการแก้ไขที่ยังไม่บันทึก | user_editing |
บันทึกหรือยกเลิกการแก้ไขในแอปก่อน |
| ไฟล์การกำหนดค่าถูกแก้ไขนอก Chute | file_changed |
โหลดไฟล์ใหม่ใน Chute ก่อน |
| การกำหนดค่าปัจจุบันไม่ใช่ไฟล์ในเครื่อง | profile_missing |
— |
| แอปกำลังแสดงกล่องโต้ตอบ | needs_user_action |
ตอบกล่องโต้ตอบแล้วลองใหม่ |
การกำหนดค่าที่เอนจินปฏิเสธก็จะไม่ถูกเขียนลงไฟล์เช่นกัน หากแอปทำไม่เสร็จภายใน 10 วินาที เอเจนต์จะได้รับ host_busy การเปลี่ยนแปลงอาจยังมีผลได้ เอเจนต์จึงอ่านสถานะใหม่ก่อนจะลองอีกครั้ง สิ่งที่ควรรู้: set_feature สลับ MitM หรือการบันทึกทราฟฟิกทันทีและเขียนสวิตช์ลงไฟล์ แต่ไม่โหลดการกำหนดค่าใหม่ ข้อความการกำหนดค่าและ revision ที่ get_profile ส่งกลับมาทันทีหลังจากนั้นจึงยังเป็นของเดิมจนกว่าจะโหลดใหม่ครั้งถัดไป
บนทุกแพลตฟอร์ม ระดับบันทึก การเขียนใหม่ โฮสต์ MitM สวิตช์โมดูล และกฎขณะทำงานมีผลเฉพาะการทำงานรอบนี้ และการโหลดการกำหนดค่าใหม่จากแอปก็ยกเลิกการเขียนใหม่ โฮสต์ MitM และสวิตช์โมดูลด้วย reload_profile ยกเลิกการเขียนใหม่ โฮสต์ MitM และสวิตช์โมดูลโดยไม่โหลดใหม่ ส่วนระดับบันทึก สวิตช์การเชื่อมต่อ LAN ของแอป โหมดขาออก และการเลือกนโยบายยังคงเดิม กฎขณะทำงานของ edit_user_rules อยู่รอดหลังการโหลดใหม่และหายไปเมื่อเอนจินหยุด
การแก้ไขการกำหนดค่า
ให้เอเจนต์เปลี่ยนการกำหนดค่าทีละส่วน: get_profile_section อ่านส่วนหนึ่งพร้อม revision และ replace_profile_section เขียนกลับพร้อม revision นั้น หากส่วนนั้นเปลี่ยนไปในระหว่างนั้น การเขียนจะถูกปฏิเสธและเอเจนต์จะได้รับแจ้งให้อ่านใหม่ การเปลี่ยนส่วนอื่นไม่เป็นอุปสรรค เอเจนต์สองตัวจึงแก้ไขคนละส่วนได้ คู่เครื่องมือสำหรับทั้งไฟล์ get_profile และ replace_profile ทำงานแบบเดียวกันด้วย revision ของการกำหนดค่า แต่การกำหนดค่าขนาดใหญ่ไม่พอดีในคำตอบเดียว และ replace_profile รับได้ไม่เกิน 1 MB
- ส่วนที่มีบรรทัด
#!includeทุกส่วนหลังจากนั้น และส่วนที่มี#!MANAGED-CONFIGเขียนด้วยวิธีนี้ไม่ได้ - ส่วนที่เขียนแล้วจะถูกอ่านกลับจากการกำหนดค่าที่โหลดใหม่: ค่าของ
[General]และ[MITM]ถูกเขียนตามแบบของ Chute และคีย์ของ[WireGuard …]ถูกจัดเรียงใหม่ ข้อความจึงอาจต่างจากที่ส่งไป คำตอบมี revision ใหม่สำหรับครั้งถัดไป - การกำหนดค่าที่ Chute ปฏิเสธจะไม่ถูกนำไปใช้ และเอเจนต์จะได้รับเหตุผล สำหรับการกำหนดค่าแบบจัดการ การอัปเดตแบบจัดการครั้งถัดไปจะแทนที่การเปลี่ยนแปลง
ความคืบหน้าของเครื่องมือที่ใช้เวลานาน
test_policy กับกลุ่ม, test_policies, run_diagnostics และ watch_events รายงานระหว่างทำงาน ไคลเอนต์ที่ขอความคืบหน้า (progressToken) และรับสตรีมเหตุการณ์ได้ จะได้รับ notifications/progress หนึ่งรายการต่อสมาชิก นโยบาย ขั้นตอน หรือเหตุการณ์ แล้วจึงได้ผลลัพธ์และสตรีมปิด ไคลเอนต์อื่นจะได้รับผลลัพธ์อย่างเดียวเมื่อเครื่องมือเสร็จ เครื่องมือที่ใช้เวลานานทำงานได้สูงสุด 60 วินาทีแล้วส่งคืนสิ่งที่มี และสตรีมพร้อมกันได้สูงสุดสี่รายการ ไคลเอนต์ที่ปิดสตรีมถือว่ายกเลิกการเรียก ส่วนการวัดที่ส่งออกไปแล้วยังคงทำจนเสร็จและยังอัปเดตกลุ่ม
ความปลอดภัย
- โทเคนคือการควบคุมทั้งหมด ผู้ที่ถือโทเคนอ่านการกำหนดค่า ประวัติการเชื่อมต่อ และบันทึกของคุณได้ เปลี่ยนการกำหนดเส้นทาง และรันสคริปต์ของคุณได้ — และยังเป็นโทเคนของ HTTP Control API ด้วย อย่าใส่ไว้ในไฟล์ที่แชร์หรือภาพหน้าจอ หากจะเปลี่ยน ให้ตั้งค่าใหม่ให้
external-http-secret - การรอรับบนเครือข่าย เปิดให้ทุกอุปกรณ์ในเครือข่ายนั้นลองเชื่อมต่อได้ การเชื่อมต่อเป็น HTTP ธรรมดา โทเคนจึงผ่านเครือข่ายโดยไม่เข้ารหัส และการลองที่ล้มเหลวจะไม่ถูกบล็อก: ใช้
external-http-secretแบบสุ่มที่ยาว ใช้เฉพาะบนเครือข่ายที่ไว้ใจ และกลับไปใช้127.0.0.1เมื่อเสร็จ run_scriptรันโค้ด รันได้เฉพาะสคริปต์ generic ที่การกำหนดค่ากำหนดไว้ แต่สิ่งที่สคริปต์ทำ — คำขอ ค่าที่เก็บ การแจ้งเตือน — จะเกิดขึ้นเมื่อเอเจนต์ขอ เอเจนต์ที่ได้รับอนุญาตให้เขียนการกำหนดค่ายังเพิ่มสคริปต์แล้วรันได้ด้วย ตรวจดูสิ่งที่มันเปลี่ยน- หน้าเว็บถูกกันไว้ข้างนอก คำขอที่มี
Originของหน้าเว็บอื่นที่ไม่ใช่ตัวเซิร์ฟเวอร์เองจะถูกปฏิเสธด้วย403และไม่มีการส่งส่วนหัวข้ามต้นทาง เว็บไซต์ที่คุณเข้าชมจึงเข้าถึงเซิร์ฟเวอร์ผ่านเบราว์เซอร์ของคุณไม่ได้
หน้านี้เป็นฉบับแปลจากเวอร์ชันภาษาอังกฤษ หากเนื้อหาไม่ตรงกัน ให้ยึดเวอร์ชันภาษาอังกฤษเป็นหลัก