UA3F

English | 简体中文

UA3F — это прокси-сервер для перезаписи HTTP(S), который работает как служба HTTP, SOCKS5, TPROXY, REDIRECT, NFQUEUE и обеспечивает эффективную прозрачную перезапись трафика HTTP(S) (например, User-Agent).

• Поддержка двусторонней перезаписи заголовков (Header) и тела (Body) HTTP(S) запросов и ответов
• Поддержка перенаправления URL HTTP(S): 302, 307, Header
• Поддержка расшифровки и перезаписи трафика HTTPS MitM
• Режимы службы на прикладном уровне: HTTP, SOCKS5
• Режимы службы на транспортном уровне: TPROXY, REDIRECT
• Режим службы на сетевом уровне: NFQUEUE(UA2F)
• Высокогибкая система правил перезаписи с поддержкой множества типов правил и стратегий перезаписи
• Панель статистики в реальном времени с поддержкой мониторинга и анализа изменений трафика
• Поддержка установки через opkg, сборки из исходников и развёртывания в Docker
• Совместимость с режимами Clash Fake-IP и Redir-Host при совместной работе
• Поддержка перезаписи L3: TTL, IPID, временные метки TCP, начальное окно TCP
• Поддержка Desync — фрагментированной неупорядоченной отправки и обфускации для обхода систем глубокого анализа пакетов (DPI)
• Поддержка разгрузки трафика через eBPF для ускорения пересылки

Установка

UA3F поддерживает несколько способов установки:

• Бинарные файлы и установочные пакеты

  На странице Release уже доступны бинарные файлы и установочные пакеты opkg/apk для распространённых архитектур — достаточно скачать пакет для соответствующей платформы и установить его вручную.

• Развёртывание в Docker:

  Запуск в качестве SOCKS5-прокси:

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

• Сборка из исходного кода:

  Компиляция и сборка бинарного файла UA3F:

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

  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 # 单独编译 UA3F 安装包
  

Использование

Подробная документация доступна в UA3F

Использование из командной строки

Запуск UA3F с конфигурацией по умолчанию:

ua3f

Запуск с указанным файлом конфигурации:

ua3f -c /path/to/config.yaml

Создание файла конфигурации шаблона:

ua3f -g

Подробное описание параметров командной строки см. в разделе 配置说明, примеры файлов конфигурации см. в разделе 配置示例

Веб-интерфейс OpenWrt LuCI

UA3F поддерживает веб-интерфейс OpenWrt LuCI: откройте Services -> UA3F для настройки.

Краткое руководство см. здесь: 猴子也能看懂的 UA3F 使用教程

opkg install sudo
sudo -u nobody /usr/bin/ua3f

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

API Server

UA3F имеет встроенный контроллер API Server, предоставляющий интерфейсы запроса и управления информацией о состоянии работы UA3F, правилах конфигурации и т. д., который можно включить с помощью параметра --api-server:

ua3f --api-server <addr:port>

Документация API см. в Документации API UA3F

Описание режимов работы

UA3F поддерживает 5 различных режимов работы; особенности и сценарии использования каждого режима приведены ниже:

Описание стратегий перезаписи

UA3F поддерживает 3 различные стратегии перезаписи:

Типы правил: