UA3F/README.md
2025-12-04 21:27:32 +08:00

6.2 KiB
Raw Permalink Blame History

UA3F

Release CodeQL License GitHub Downloads (all assets, all releases) Telegram group

English | 简体中文

UA3F 是一个 HTTP Header 重写工具,作为一个 HTTP、SOCKS5、TPROXY、REDIRECT、NFQUEUE 服务对 HTTP 请求 Header (例如 User-Agent) 进行透明重写。

  • 应用层服务模式HTTP、SOCKS5
  • 传输层服务模式TPROXY、REDIRECT
  • 网络层服务模式NFQUEUE(UA2F)
  • 高度灵活的重写规则系统,支持多种规则类型与重写策略
  • 实时统计面板,支持流量修改监控与分析
  • 支持 opkg 安装、编译安装、Docker 部署多种方式
  • 兼容 Clash Fake-IP & Redir-Host 多种模式伴生运行
  • 支持 TTLTCP TimestampTCP WindowIPID 伪装
  • 支持 TCP Desync 分片乱序发射用于对抗深度包检测DPI
UA3F
UA3F-LuCI UA3F-Rules

部署

提供 3 种部署方式:

  • 使用 ipk 安装包进行部署:

    Release 页面已经提供常见架构的编译版本,可以根据自己设备的架构下载到 OpenWrt 上使用 opkg install 进行安装。

  • OpenWrt 编译安装:

    git clone https://github.com/openwrt/openwrt.git && cd openwrt
    git checkout openwrt-24.10
    ./scripts/feeds update -a && ./scripts/feeds install -a
    git clone https://github.com/SunBK201/UA3F.git package/UA3F
    make menuconfig # 勾选 Network->Web Servers/Proxies->ua3f
    make download -j$(nproc) V=s
    make -j$(nproc) || make -j1 || make -j1 V=sc # make package/UA3F/openwrt/compile -j1 V=sc # 编译单个包
    
  • Docker 部署:

    docker run -p 1080:1080 sunbk201/ua3f -f FFF
    

使用

UA3F 支持 LuCI Web 页面,可以打开 Services -> UA3F 进行相关配置。

快速使用教程详见:猴子也能看懂的 UA3F 使用教程

设备与系统信息正则表达式参考:

(Apple|iPhone|iPad|Macintosh|Mac OS X|Mac|Darwin|Microsoft|Windows|Linux|Android|OpenHarmony|HUAWEI|OPPO|Vivo|XiaoMi|Mobile|Dalvik)
手动命令行启动
opkg install sudo
sudo -u nobody /usr/bin/ua3f

shellclash/shellcrash 用户建议使用以下命令启动:

sudo -u shellclash /usr/bin/ua3f
# 如果上面命令报错执行下面该命令
sudo -u shellcrash /usr/bin/ua3f

相关命令行启动参数:

  • -m <mode>: 服务模式,支持 HTTP、SOCKS5、TPROXY、REDIRECT默认 SOCKS5
  • -b <bind addr>: 自定义绑定监听地址,默认 127.0.0.1
  • -p <port>: 端口号,默认 1080
  • -l <log level>: 日志等级,默认 info可选debug默认日志位置/var/log/ua3f.log
  • -x: 重写策略,支持 GLOBAL、DIRECT、RULES默认 GLOBAL
  • -f <UA>: 自定义 UA默认 FFF
  • -r <regex>: 自定义正则匹配 User-Agent, 默认为空, 表示所有 User-Agent 都会被重写
  • -s: 部分替换,仅替换正则匹配到的部分
  • -z: 重写规则json string 格式,仅在 RULES 重写策略模式下生效
  • -o ttl,tcpts,ipid: 启用 TTL、TCP Timestamp、IP ID 伪装功能

服务模式说明

UA3F 支持 5 种不同的服务模式,各模式的特点和使用场景如下:

服务模式 工作原理 是否依赖 Clash 等 兼容性 性能 能否与 Clash 等伴生运行
HTTP HTTP 代理
SOCKS5 SOCKS5 代理
TPROXY netfilter TPROXY
REDIRECT netfilter REDIRECT
NFQUEUE netfilter NFQUEUE

重写策略说明

UA3F 支持 3 种不同的重写策略:

重写策略 重写行为 重写 Header 适用服务模式
GLOBAL 所有请求均进行重写 User-Agent 适用于所有服务模式
DIRECT 不进行重写,纯转发 适用于所有服务模式
RULES 根据重写规则进行重写 自定义 适用于 HTTP/SOCKS5/TPROXY/REDIRECT

Clash 配置建议

Clash 配置

References & Thanks