Brook GUI 文档

https://www.txthinking.com/talks/
Updated at: 2023-01-01
cloud@txthinking.com

Table of Contents

• 本文适用的软件
• Intel Mac GUI proxy 模式, Windows GUI proxy 模式, Linux GUI proxy 模式
• iOS/M1 Mac GUI, Android GUI, Intel Mac GUI tun 模式, Windows GUI tun 模式, Linux GUI tun 模式
• 配置介绍
• Programmable
  • 传入变量介绍
  • in_guiconfig
  • in_dnsquery
  • in_address
  • in_httprequest
  • in_httpresponse
  • 如何写 Tengo 脚本
  • 如何调试脚本
• 为什么以及如何关闭系统和浏览器安全 DNS
• 安装 CA
  • iOS
  • Android
  • macOS
  • Windows
• Apple 推送问题
• 其他资源

本文适用的软件

• Brook
• Brook Plus
• Shiliew
• tun2brook

Intel Mac GUI proxy 模式, Windows GUI proxy 模式, Linux GUI proxy 模式

这个模式比较简单，会创建:

• Socks5 代理: socks5://[::1]:1080 或 socks5://127.0.0.1:1080
• HTTP 代理: http://[::1]:8010 或 http://127.0.0.1:8010
• PAC: http://127.0.0.1:1093/proxy.pac 或 http://[::1]:1093/proxy.pac 基于 Bypass Domain 列表
• Intel Mac GUI, Windows GUI 同时会配置 PAC 到系统代理。Linux GUI 可以配合 Socks5 Configurator

参考文章:

• 一口气搞明白有点奇怪的 Socks 5 协议以及 HTTP 代理

参考视频:

• 一口气搞明白有点奇怪的 Socks 5 协议以及 HTTP 代理

iOS/M1 Mac GUI, Android GUI, Intel Mac GUI tun 模式, Windows GUI tun 模式, Linux GUI tun 模式

所谓的互联网连接，是 IP 连接 IP，不是连接域名。所以域名会被先解析成IP再决定怎么去连接。

配置介绍

Programmable

Brook GUI 会在不同时机向脚本传入不同的全局变量，脚本只需要将处理结果赋值到全局变量 out 即可

完全掌控你自己的网络

• 比如通过阻断 AAAA 来关闭 IPv6
• 阻断系统浏览器内置安全 DNS
• 重写 DST
• 分流
• 直接 Bypass 域名而无视是否解析出来的 IP 是否在 Bypass 里
• MITM 解密 HTTPS
• 抓包
• 修改包
• 禁用 HTTP3
• 等等等...

传入变量介绍

in_guiconfig

out, 如果是 error 类型会被记录在日志。如果不是 map 类型则会被忽略, 如果是map那么明确指定每一个配置项

in_dnsquery

out, 如果是 error 类型会被记录在日志。如果不是 map 类型则会被忽略

in_address

out, 如果是 error 类型会被记录在日志。如果不是 map 类型则会被忽略

in_httprequest

out, 必须设置为一个 request 或 response

in_httpresponse

out, 必须设置为一个 response

如何写 Tengo 脚本

Tengo Language Syntax

Library

• text: regular expressions, string conversion, and manipulation
• math: mathematical constants and functions
• times: time-related functions
• rand: random functions
• fmt: formatting functions
• json: JSON functions
• enum: Enumeration functions
• hex: hex encoding and decoding functions
• base64: base64 encoding and decoding functions

• brook: brook module

  Constants
  
  * os: string, linux/darwin/windows/ios/android. If ios app run on mac, it is ios
  * iosapponmac: bool, ios app run on mac
  
  Functions
  
  * splithostport(address string) => map/error: splits a network address of the form "host:port" to { "host": "xxx", "port": "xxx" }
  * country(ip string) => string/error: get country code from ip
  * cidrcontainsip(cidr string, ip string) => bool/error: reports whether the network includes ip
  * parseurl(url string) => map/error: parses a raw url into a map, keys: scheme/host/path/rawpath/rawquery
  * parsequery(query string) => map/error: parses a raw query into a kv map
  * map2query(kv map) => string/error: convert map{string:string} into a query string
  * bytes2ints(b bytes) => array/error: convert bytes into [int]
  * ints2bytes(ints array) => bytes/error: convert [int] into bytes
  * bytescompare(a bytes, b bytes) => int/error: returns an integer comparing two bytes lexicographically. The result will be 0 if a == b, -1 if a < b, and +1 if a > b
  * bytescontains(b bytes, sub bytes) => bool/error: reports whether sub is within b
  * byteshasprefix(s bytes, prefix bytes) => bool/error: tests whether the bytes s begins with prefix
  * byteshassuffix(s bytes, suffix bytes) => bool/error: tests whether the bytes s ends with suffix
  * bytesindex(s bytes, sep bytes) => int/error: returns the index of the first instance of sep in s, or -1 if sep is not present in s
  * byteslastindex(s bytes, sep bytes) => int/error: returns the index of the last instance of sep in s, or -1 if sep is not present in s
  * bytesreplace(s bytes, old bytes, new bytes, n int) => bytes/error: returns a copy of the s with the first n non-overlapping instances of old replaced by new. If n < 0, there is no limit on the number of replacements
  * pathescape(s string) => string/error: escapes the string so it can be safely placed inside a URL path segment, replacing special characters (including /) with %XX sequences as needed
  * pathunescape(s string) => string/error: does the inverse transformation of pathescape
  * queryescape(s string) => string/error: escapes the string so it can be safely placed inside a URL query
  * queryunescape(s string) => string/error: does the inverse transformation of queryescape
  * hexdecode(s string) => bytes/error: returns the bytes represented by the hexadecimal string s
  * hexencode(s string) => string/error: returns the hexadecimal encoding of src
  

示例

https://github.com/txthinking/bypass/blob/master/example_script.tengo

如何调试脚本

• 建议使用 tun2brook 在电脑上打印调试
• 可以使用 mitmproxy helper 和 Wireshark Helper 抓包来确定要修改什么

为什么以及如何关闭系统和浏览器安全 DNS

因为开启后，FakeDNS 就拿不到域名了. 所以我们要关闭它:

• Android: Settings -> Network & internet -> Private DNS -> Off
• Chrome on Mobile: Settings -> Privacy and security -> Use secure DNS -> Off
• Chrome on Desktop: Settings -> Privacy and security -> Security -> Use secure DNS -> Off
• Windows: Windows Settings -> Network & Internet -> Your Network -> DNS settings -> Edit -> Preferred DNS -> Unencrypted only -> 8.8.8.8

其他系统和软件，请自行查找是否存在以及如何关闭

安装 CA

https://txthinking.github.io/ca/ca.pem

iOS

https://www.youtube.com/watch?v=HSGPC2vpDGk

Android

Android 分系统 CA 和用户 CA，必须要 ROOT 后安装到系统 CA 里

macOS

nami install mad ca.txthinking
sudo mad install --ca ~/.nami/bin/ca.pem

Windows

打开 GitBash

nami install mad ca.txthinking

然后用管理员打开 GitBash

mad install --ca ~/.nami/bin/ca.pem

注意 GitBash 或 Firefox 等软件可能不读取系统 CA，安装后可以用系统 Edge 浏览器测试

Apple 推送问题

要接收推送，Apple Server 只允许 Ethernet, cellular data, Wi-Fi 连接. 所以你需要 Bypass 掉相关域名和 IP. 参考链接

其他资源

• Brook 文档
• Brook GitHub
• TxThinking Talks
• TxThinking YouTube
• TxThinking News
• Telegram