快速开始

UA3F 是一个 HTTP(S) 重写代理，可用于透明改写请求/响应 Header、Body，也可按规则执行 URL 重定向、拒绝或丢弃请求。除 HTTP 重写外，UA3F 还支持 L3 重写与 Desync：L3 重写可调整 TTL、IPID、TCP Timestamp、TCP 初始窗口，并可阻断 QUIC 等网络层特征，还可通过 TC eBPF 加速；Desync 可通过 TCP 分片乱序发射和低 TTL 混淆注入干扰部分 DPI 设备的流重组行为。

安装

使用 Release 包

前往 GitHub Releases 下载适合目标平台的二进制文件、opkg 包或 apk 包。

使用 Docker

以 SOCKS5 代理模式启动：

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

从源码构建

git clone https://github.com/SunBK201/UA3F.git
cd UA3F
go build -o ua3f main.go

第一次运行

使用默认配置启动：

ua3f

默认监听 127.0.0.1:1080，服务模式为 SOCKS5，重写策略为 GLOBAL。

指定配置文件启动：

ua3f -c /path/to/config.yaml

生成模板配置文件：

ua3f -g

常见部署路径

场景	推荐方式
只需要本机或上游代理接入	SOCKS5 或 HTTP
OpenWrt 透明代理	TPROXY 或 REDIRECT
需要网络层队列处理	NFQUEUE
与 Clash 共存	UA3F 使用 SOCKS5，Clash 将 HTTP/TCP 流量转发到 UA3F
需要 HTTPS Header/Body 重写	启用 mitm 并配置目标主机名
需要网络层特征重写	启用 L3 重写，按需配置 TTL、IPID、TCP Timestamp、TCP 初始窗口或 QUIC 阻断
需要 DPI 流重组干扰	启用 Desync，按需配置 TCP 分片乱序发射或 TCP 混淆注入

下一步

• 阅读 核心概念 了解模式、策略与规则。
• 阅读 配置说明 编写 YAML 配置。
• 阅读 HTTP 重写、L3 重写 与 Desync 了解完整功能。
• 查看 API 文档 接入状态查询与日志读取。