mirror of
https://github.com/SunBK201/UA3F.git
synced 2025-12-15 00:01:37 +00:00
6.2 KiB
6.2 KiB
UA3F
English | 简体中文
UA3F 是一个 HTTP Header 重写工具,作为一个 HTTP、SOCKS5、TPROXY、REDIRECT、NFQUEUE 服务对 HTTP 请求 Header (例如 User-Agent) 进行透明重写。
|
|
![]() |
![]() |
部署
提供 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 配置

