Repository navigation
Releases
UA3F v3.7.0
- L3 重写支持自定义 TTL,范围为 1–255,默认值为 64,支持通过配置文件、命令行、环境变量和 LuCI 设置
- 修复 Desync 中 reorder-bytes 与 reorder-packets 默认值颠倒的问题,正确默认值分别为 1500 和 8
- 修复 YAML 与 JSON 规则中的 enabled 状态未正确生效的问题,未指定时默认启用
- 修复 REQUEST 方向的 DROP 决定被后续重写阶段覆盖的问题
- 修复 Header 规则处理结束后未继续匹配 URL 重定向规则的问题
- 修复连接转发模式下完成终止重定向后仍向上游发送原请求的问题
- 修复 HTTP 代理模式下 REJECT 动作未正确生效的问题,并修复拒绝响应时的响应体关闭异常
- 修复 SOCKS5 连接在反向转发完成前被提前关闭的问题,以及服务启动时的数据竞态
- 修复 REDIRECT 模式下重载配置导致监听器关闭的问题
- 修复配置重载后 API 仍返回旧配置、鉴权仍使用旧密钥的问题
- 修复 Docker 多架构镜像的基础系统与 UA3F 程序架构不一致的问题
Full Changelog: v3.6.0...v3.7.0
安装注意事项
- 如果 UA3F 设置页面显示异常,请尝试清除浏览器缓存
- OpenWrt 25.12 用户如果在安装完成后进入 Web 页面报错,可尝试执行命令:
apk add libubox-lua - 如需启用 nftables 请先安装好这些依赖:
opkg update
opkg install kmod-nft-queue kmod-nft-tproxyImportant
请注意文件后缀,ipk 与 apk 不同
我该选 ipk 安装还是 apk 安装?
通常来说,ipk 适用于 OpenWrt 24.10 及更老版本,apk 适用于 OpenWrt 25.12 之后的版本。
可以通过命令进一步确认:
which opkg
which apk选择存在输出的包管理器。
我该选哪个 ipk 安装?
opkg print-architecture输出会类似于:
arch all 1
arch noarch 1
arch x86_64 10
每一行表示一种架构(architecture),数字表示优先级,数字越大,优先级越高,可以根据最高优先级的架构信息中的关键字判断。
OpenWrt 固件下载
UA3F v3.6.0
- L3 重写支持 QUIC 阻断
Full Changelog: v3.5.0...v3.6.0
安装注意事项
- 如果 UA3F 设置页面显示异常,请尝试清除浏览器缓存
- OpenWrt 25.12 用户如果在安装完成后进入 Web 页面报错,可尝试执行命令:
apk add libubox-lua - 如需启用 nftables 请先安装好这些依赖:
opkg update
opkg install kmod-nft-queue kmod-nft-tproxyImportant
请注意文件后缀,ipk 与 apk 不同
我该选 ipk 安装还是 apk 安装?
通常来说,ipk 适用于 OpenWrt 24.10 及更老版本,apk 适用于 OpenWrt 25.12 之后的版本。
可以通过命令进一步确认:
which opkg
which apk选择存在输出的包管理器。
我该选哪个 ipk 安装?
opkg print-architecture输出会类似于:
arch all 1
arch noarch 1
arch x86_64 10
每一行表示一种架构(architecture),数字表示优先级,数字越大,优先级越高,可以根据最高优先级的架构信息中的关键字判断。
OpenWrt 固件下载
UA3F v3.5.0
- UA3F 文档网站发布: https://ua3f.sunbk201.site
- 将代码仓库调整为 Go 项目标准布局
Full Changelog: v3.4.0...v3.5.0
安装注意事项
- 如果 UA3F 设置页面显示异常,请尝试清除浏览器缓存
- OpenWrt 25.12 用户如果在安装完成后进入 Web 页面报错,可尝试执行命令:
apk add libubox-lua - 如需启用 nftables 请先安装好这些依赖:
opkg update
opkg install kmod-nft-queue kmod-nft-tproxyImportant
请注意文件后缀,ipk 与 apk 不同
我该选 ipk 安装还是 apk 安装?
通常来说,ipk 适用于 OpenWrt 24.10 及更老版本,apk 适用于 OpenWrt 25.12 之后的版本。
可以通过命令进一步确认:
which opkg
which apk选择存在输出的包管理器。
我该选哪个 ipk 安装?
opkg print-architecture输出会类似于:
arch all 1
arch noarch 1
arch x86_64 10
每一行表示一种架构(architecture),数字表示优先级,数字越大,优先级越高,可以根据最高优先级的架构信息中的关键字判断。
OpenWrt 固件下载
UA3F v3.4.0
- 新增
include-lan-routes参数开关代理局域网目标路由 - 修复 OpenWrt 25.12 下没有使用 nftables 的问题
- 修复在同时开启 Desync 注入与 L3 eBPF 重写下可能导致的 TTL 行为异常
Full Changelog: v3.3.0...v3.4.0
安装注意事项
- 如果 UA3F 设置页面显示异常,请尝试清除浏览器缓存
- OpenWrt 25.12 用户如果在安装完成后进入 Web 页面报错,可尝试执行命令:
apk add libubox-lua - 如需启用 nftables 请先安装好这些依赖:
opkg update
opkg install kmod-nft-queue kmod-nft-tproxyImportant
请注意文件后缀,ipk 与 apk 不同
我该选 ipk 安装还是 apk 安装?
通常来说,ipk 适用于 OpenWrt 24.10 及更老版本,apk 适用于 OpenWrt 25.12 之后的版本。
可以通过命令进一步确认:
which opkg
which apk选择存在输出的包管理器。
我该选哪个 ipk 安装?
opkg print-architecture输出会类似于:
arch all 1
arch noarch 1
arch x86_64 10
每一行表示一种架构(architecture),数字表示优先级,数字越大,优先级越高,可以根据最高优先级的架构信息中的关键字判断。
OpenWrt 固件下载
UA3F v3.3.0
- L3 重写 eBPF 流量卸载支持 PPPoE 网络
Full Changelog: v3.2.0...v3.3.0
安装注意事项
- 如果 UA3F 设置页面显示异常,请尝试清除浏览器缓存
- OpenWrt 25.12 用户如果在安装完成后进入 Web 页面报错,可尝试执行命令:
apk add libubox-lua - 如需启用 nftables 请先安装好这些依赖:
opkg update
opkg install kmod-nft-queue kmod-nft-tproxyImportant
请注意文件后缀,ipk 与 apk 不同
我该选 ipk 安装还是 apk 安装?
通常来说,ipk 适用于 OpenWrt 24.10 及更老版本,apk 适用于 OpenWrt 25.12 之后的版本。
可以通过命令进一步确认:
which opkg
which apk选择存在输出的包管理器。
我该选哪个 ipk 安装?
opkg print-architecture输出会类似于:
arch all 1
arch noarch 1
arch x86_64 10
每一行表示一种架构(architecture),数字表示优先级,数字越大,优先级越高,可以根据最高优先级的架构信息中的关键字判断。
OpenWrt 固件下载
UA3F v3.2.0
- 新增 L3 重写 eBPF 加速,支持使用 TC 将重写逻辑卸载到内核(内核要求 Linux >= 5.15)
- 「其他设置」重命名为 L3 重写
Full Changelog: v3.1.0...v3.2.0
L3 重写 eBPF 加速
对于 TTL、IPID 重写等功能,UA3F <= v3.1.0 基于 netfilter NFQUEUE 将流量从内核态劫持到用户态在 L3 视角进行重写修改,该方法由于涉及到上下文切换与数据拷贝,性能开销较高,UA3F 3.2.0 引入 eBPF 加速能力,基于 TC egress 将重写逻辑下沉到内核态,大幅提高重写与转发性能。目前 UA3F L3 eBPF 加速要求 Linux 内核版本 >= 5.15。
Important
eBPF 对于 Linux 内核以及处理器架构均有要求,eBPF 支持常见处理器架构:x86-64、x86-32、ARM32、ARM64、MIPS 64、riscv,但不支持 MIPS 32
UA3F L3 重写 eBPF 性能测试
性能测试使用 netperf 进行,开启 L3 重写全部功能选项,分别测试 TCP_STREAM、TCP_RR、TCP_CRR,得到优化结果如下:
| 测试类型 | 整体吞吐/QPS | CPU 占用 | 本地时延 |
|---|---|---|---|
| TCP_STREAM | +4.56% | -82.46% | -83.23% |
| TCP_RR | +9.22% | -77.01% | -78.93% |
| TCP_CRR | +1.19% | -52.73% | -53.75% |
相较于 NFQUEUE,eBPF 在三类测试中使整体吞吐平均提升约 5.0%,同时 CPU 使用率平均下降约 70.7%,本地时延平均降低约 72.0%,显著提升了处理效率。
详细测试数据如下:
TCP_STREAM 测试:
| 指标 | NFQUEUE | eBPF | 提升幅度 |
|---|---|---|---|
| Throughput (Mbps) | 409.83 | 428.53 | +4.56% |
| Local CPU (%) | 44.87 | 7.87 | -82.46% |
| Send us/KB | 35.873 | 6.020 | -83.23% |
TCP_RR 测试:
| 指标 | NFQUEUE | eBPF | 提升幅度 |
|---|---|---|---|
| Transactions/s | 252.03 | 275.26 | +9.22% |
| Local CPU (%) | 2.74 | 0.63 | -77.01% |
| Local us/Tr | 435.562 | 91.781 | -78.93% |
TCP_CRR 测试:
| 指标 | NFQUEUE | eBPF | 提升幅度 |
|---|---|---|---|
| Transactions/s | 25.20 | 25.50 | +1.19% |
| Local CPU (%) | 0.55 | 0.26 | -52.73% |
| Local us/Tr | 879.750 | 406.912 | -53.75% |
安装注意事项
- 如果 UA3F 设置页面显示异常,请尝试清除浏览器缓存
- OpenWrt 25.12 用户如果在安装完成后进入 Web 页面报错,可尝试执行命令:
apk add libubox-lua - 如需启用 nftables 请先安装好这些依赖:
opkg update
opkg install kmod-nft-queue kmod-nft-tproxyImportant
请注意文件后缀,ipk 与 apk 不同
我该选 ipk 安装还是 apk 安装?
通常来说,ipk 适用于 OpenWrt 24.10 及更老版本,apk 适用于最新 Snapshot 版本。
可以通过命令进一步确认:
which opkg
which apk选择存在输出的包管理器。
我该选哪个 ipk 安装?
opkg print-architecture输出会类似于:
arch all 1
arch noarch 1
arch x86_64 10
每一行表示一种架构(architecture),数字表示优先级,数字越大,优先级越高,可以根据最高优先级的架构信息中的关键字判断。
OpenWrt 固件下载
UA3F v3.1.0
- 新增 REJECT 重写策略
- 新增 DOMAIN-SET 类型规则集合,兼容 Surge 规则集
- 优化平滑重启过程
Full Changelog: v3.0.0...v3.1.0
安装注意事项
- 如果 UA3F 设置页面显示异常,请尝试清除浏览器缓存
- 如需启用 nftables 请先安装好这些依赖:
opkg update
opkg install kmod-nft-queue kmod-nft-tproxyImportant
请注意文件后缀,ipk 与 apk 不同
我该选 ipk 安装还是 apk 安装?
通常来说,ipk 适用于 OpenWrt 24.10 及更老版本,apk 适用于最新 Snapshot 版本。
可以通过命令进一步确认:
which opkg
which apk选择存在输出的包管理器。
我该选哪个 ipk 安装?
opkg print-architecture输出会类似于:
arch all 1
arch noarch 1
arch x86_64 10
每一行表示一种架构(architecture),数字表示优先级,数字越大,优先级越高,可以根据最高优先级的架构信息中的关键字判断。
OpenWrt 固件下载
UA3F v3.0.0
- 支持 HTTPS MitM,支持对 HTTPS 加密流量进行透明解密重写
- 支持 api-server 控制器,提供运行状态、配置规则等信息查询与控制接口
- 支持通过
HUP信号或 api-server 请求平滑热重启 - 优化 TPROXY 模式连接建立速度
Full Changelog: v2.8.0...v3.0.0
安装注意事项
- 如果 UA3F 设置页面显示异常,请尝试清除浏览器缓存
- 如需启用 nftables 请先安装好这些依赖:
opkg update
opkg install kmod-nft-queue kmod-nft-tproxyImportant
请注意文件后缀,ipk 与 apk 不同
我该选 ipk 安装还是 apk 安装?
通常来说,ipk 适用于 OpenWrt 24.10 及更老版本,apk 适用于最新 Snapshot 版本。
可以通过命令进一步确认:
which opkg
which apk选择存在输出的包管理器。
我该选哪个 ipk 安装?
opkg print-architecture输出会类似于:
arch all 1
arch noarch 1
arch x86_64 10
每一行表示一种架构(architecture),数字表示优先级,数字越大,优先级越高,可以根据最高优先级的架构信息中的关键字判断。
OpenWrt 固件下载
UA3F v2.8.0
- 实时统计信息自动清除超过 24 小时的记录(#82)
- 重构命令行参数、环境变量与配置文件解析
Full Changelog: v2.7.0...v2.8.0
安装注意事项
- 如果 UA3F 设置页面显示异常,请尝试清除浏览器缓存
- 如需启用 nftables 请先安装好这些依赖:
opkg update
opkg install kmod-nft-queue kmod-nft-tproxyImportant
请注意文件后缀,ipk 与 apk 不同
我该选 ipk 安装还是 apk 安装?
通常来说,ipk 适用于 OpenWrt 24.10 及更老版本,apk 适用于最新 Snapshot 版本。
可以通过命令进一步确认:
which opkg
which apk选择存在输出的包管理器。
我该选哪个 ipk 安装?
opkg print-architecture输出会类似于:
arch all 1
arch noarch 1
arch x86_64 10
每一行表示一种架构(architecture),数字表示优先级,数字越大,优先级越高,可以根据最高优先级的架构信息中的关键字判断。
OpenWrt 固件下载
UA3F v2.7.0
- 支持 URL 重定向(302、307、Header)
- Luci 规则页面支持拖拽调整顺序
- 修复 Body 重写造成的潜在异常
Full Changelog: v2.6.0...v2.7.0
安装注意事项
- 如果 UA3F 设置页面显示异常,请尝试清除浏览器缓存
- 如需启用 nftables 请先安装好这些依赖:
opkg update
opkg install kmod-nft-queue kmod-nft-tproxyImportant
请注意文件后缀,ipk 与 apk 不同
我该选 ipk 安装还是 apk 安装?
通常来说,ipk 适用于 OpenWrt 24.10 及更老版本,apk 适用于最新 Snapshot 版本。
可以通过命令进一步确认:
which opkg
which apk选择存在输出的包管理器。
我该选哪个 ipk 安装?
opkg print-architecture输出会类似于:
arch all 1
arch noarch 1
arch x86_64 10
每一行表示一种架构(architecture),数字表示优先级,数字越大,优先级越高,可以根据最高优先级的架构信息中的关键字判断。