Files
v2rayA/README_ru.md
T
Zakk 3380b03462 docs: the Homebrew service runs as root for tun or as the user for the system proxy
The macOS section told the reader to stop the brew service and run the
binary under sudo by hand to get tun. With v2rayA/homebrew-v2raya#7 the
tap's service is one file for both identities, so the section shows the
two commands and what each gives, plus how a sudo-started service is
stopped and Homebrew's ownership warning. The requirement rows say that
an unprivileged start is lite mode by itself, as #2011 made it.
2026-09-20 16:02:30 +10:00

17 KiB
Raw Permalink Blame History

v2rayA

v2rayA

Веб-клиент для собственного ядра на базе Xray с прозрачным прокси в Linux, Windows и macOS.

English · 简体中文 · Русский

Требования • Установка • Первый запуск • Прозрачный прокси • Данные и обновления • Поддержка

v2rayA работает как служба и управляется из браузера — на самом компьютере, на маршрутизаторе или NAS. Он импортирует подписки и ссылки VMess, VLESS, Shadowsocks, Trojan, Hysteria2, TUIC, Juicity, AnyTLS, WireGuard, SOCKS5 и HTTP(S), объединяет узлы в группы, выбирает узел с наименьшей измеренной задержкой или закреплённый узел и разделяет трафик по правилам RoutingA. ShadowsocksR не поддерживается.

Требования

Компонент Требование
Ядро v2raya_core той же версии, что и v2raya, рядом с ним или в PATH. Пакеты и установщики ниже ставят оба файла; при ручной установке версии должны совпадать
Данные правил geoip.dat и geosite.dat в /usr/share/v2raya или /usr/local/share/v2raya. Пакеты содержат их; при ручной установке они скачиваются с GitHub при первом запуске, и при неудаче служба завершается
Прозрачный прокси в Linux root; iptables или nftables для redirect и tproxy; /dev/net/tun и команда ip из iproute2 для tun
Windows Windows 10 сборки 14393 или новее; права администратора для tun; запущенный без повышения прав, работает в режиме lite и всё же может настроить системный прокси текущего пользователя
macOS root для tun; запущенный от пользователя, работает в режиме lite с системным прокси
Браузер актуальный Chrome, Edge, Firefox или Safari

Установка

Пакеты ниже устанавливают v2raya и v2raya_core вместе с описанием службы. Включите службу командой, указанной для платформы.

Debian, Ubuntu и другие дистрибутивы с APT

Пакеты берутся из репозитория Dae Universe.

sudo apt update
sudo apt install curl

APT 3.0 и новее:

sudo curl -fsSL -o /etc/apt/sources.list.d/daeuniverse.sources https://daeuniverse.pages.dev/daeuniverse.sources

APT версии ниже 3.0:

sudo curl -fsSL -o /etc/apt/sources.list.d/daeuniverse.list https://daeuniverse.pages.dev/daeuniverse.list

Затем ключ и пакет:

sudo curl -fsSL -o /usr/share/keyrings/daeuniverse-archive-goose.gpg https://daeuniverse.pages.dev/daeuniverse-archive-goose.gpg
sudo apt update
sudo apt install v2raya
sudo systemctl enable --now v2raya

Юнит меняйте через sudo systemctl edit --full v2raya.service: правку установленного файла перезапишет следующее обновление.

Fedora, RHEL, openSUSE и другие дистрибутивы с RPM

Fedora, RHEL и производные:

sudo curl -fsSL -o /etc/yum.repos.d/daeuniverse.repo https://daeuniverse.pages.dev/daeuniverse.repo
sudo dnf install v2raya

openSUSE:

sudo curl -fsSL -o /etc/zypp/repos.d/daeuniverse.repo https://daeuniverse.pages.dev/daeuniverse.repo
sudo zypper install v2raya

Затем:

sudo systemctl enable --now v2raya
Arch Linux

В AUR v2raya собирается из исходников, v2raya-bin использует готовые бинарные файлы. На странице выпусков есть и installer_archlinux_<arch>_<version>.pkg.tar.zst для pacman -U.

paru -S v2raya-bin
sudo systemctl enable --now v2raya
Gentoo, Alpine и другие системы с OpenRC

В Gentoo установите пакет из оверлея gentoo-zh и включите службу:

sudo emerge net-proxy/v2rayA
sudo rc-update add v2raya default
sudo rc-service v2raya start

В остальных системах скачайте оба бинарных файла для своей архитектуры со страницы выпусков и возьмите файлы OpenRC из install/universal/. Команды выполняются из клона репозитория; VERSION — номер выпуска без ведущей v; пример для x64:

sudo install -m755 "v2raya_linux_x64_${VERSION}" /usr/bin/v2raya
sudo install -m755 "v2raya_core_linux_x64_${VERSION}" /usr/bin/v2raya_core
sudo install -m755 install/universal/v2raya.initd /etc/init.d/v2raya
sudo install -m644 install/universal/v2raya.confd /etc/conf.d/v2raya
sudo rc-update add v2raya default
sudo rc-service v2raya start
Docker

Образ — ghcr.io/v2raya/v2raya (на Docker Hub — mzz2017/v2raya). Пример для хоста Linux: контейнер получает сеть хоста и привилегии, без которых прозрачный прокси не работает:

docker run -d --restart=always --privileged --network=host --name v2raya \
  -e V2RAYA_LOG_FILE=/tmp/v2raya.log \
  -v /lib/modules:/lib/modules:ro \
  -v /etc/resolv.conf:/etc/resolv.conf \
  -v /etc/v2raya:/etc/v2raya \
  ghcr.io/v2raya/v2raya

При сети bridge опубликуйте порт 2017 и используемые входящие порты и включите общий доступ к портам в настройках, иначе входящие подключения принимаются только на loopback контейнера. Прозрачный прокси в такой схеме недоступен.

Windows

installer_windows_inno_x64_<version>.exe (или arm64) со страницы выпусков устанавливает оба бинарных файла и регистрирует службу. Тот же установщик стоит за winget install --id v2rayA.v2rayA и за scoop bucket (scoop bucket add v2raya https://github.com/v2rayA/v2raya-scoop && scoop install v2raya-np).

macOS

Tap устанавливает оба бинарных файла. Запущенная от root служба даёт прозрачный прокси tun; запущенная от вас — работает в режиме lite с системным прокси:

brew tap v2raya/v2raya
brew install v2raya/v2raya/v2raya
sudo brew services start v2raya   # root: tun
brew services start v2raya        # вы: системный прокси

Службу, запущенную через sudo, останавливают командой sudo brew services stop v2raya; Homebrew предупреждает, что обновление или удаление formula, запускавшейся от root, требует sudo rm перечисленных им путей.

OpenWrt

Репозиторий v2raya-openwrt и официальный репозиторий packages сейчас содержат 2.2.7.x с отдельным xray-core, а не описанный здесь выпуск. Пока они не обновлены, установите бинарные файлы выпуска для mips32, mips32le, arm64 или x64 вручную, как в следующем разделе, с собственным init-скриптом.

Другой Linux, без пакета

Скачайте v2raya_linux_<arch>_<version> и v2raya_core_linux_<arch>_<version> со страницы выпусков (x86, x64, arm64, armv7, riscv64, loongarch64, mips32, mips32le, mips64, mips64le), сверьте их с соседним .sha256.txt и установите оба в /usr/bin. Для systemd:

sudo install -m644 install/universal/v2raya.service /etc/systemd/system/v2raya.service
sudo systemctl daemon-reload
sudo systemctl enable --now v2raya

Для OpenRC используйте файлы из раздела выше. Есть и отдельно поддерживаемый snap.

Первый запуск

Служба слушает 0.0.0.0:2017, поэтому на маршрутизаторе или NAS интерфейс доступен по адресу http://<адрес-устройства>:2017. Первая зарегистрированная учётная запись становится администратором, а регистрация не требует входа, поэтому в общей сети сначала ограничьте доступ, либо для локального использования запустите службу с --address 127.0.0.1:2017.

Откройте интерфейс и создайте администратора. Затем мастер проведёт через импорт подписки или ссылки, добавление узлов в группу и выбор правил маршрутизации; ядро запускается кнопкой запуска на панели или кнопкой состояния вверху страницы.

Когда ядро работает, укажите приложению SOCKS5 127.0.0.1:20170 или HTTP 127.0.0.1:20171 (20172 применяет к HTTP правила маршрутизации) либо включите прозрачный прокси на панели и выберите режим из таблицы ниже. Группа с несколькими подключёнными узлами использует узел с наименьшей измеренной задержкой; после закрепления узла весь трафик группы направляется через него. Подписки обновляются со страницы подписок или с интервалом, заданным в настройках.

Панель управления в светлой и тёмной темах

Прозрачный прокси

Платформа Режимы
Linux redirect, tproxy, tun; с --lite — системный прокси в GNOME и KDE
macOS tun; с --lite — системный прокси
Windows tun, системный прокси

Режимы системного прокси меняют настройки прокси рабочего стола и охватывают только приложения, которые их соблюдают. Остальные режимы перехватывают трафик.

В режиме tun ядро открывает устройство TUN и назначает ему адрес; при включённой автоматической маршрутизации (по умолчанию) маршруты и настройку DNS устанавливает v2rayA, иначе — ваш собственный скрипт. Собственные соединения ядра, прямой исходящий трафик и запросы DNS-модуля к вышестоящим серверам не попадают в TUN (в Linux — метки сокетов, в Windows и macOS — привязка к физическому интерфейсу). На незашифрованные DNS-запросы на порт 53, попавшие в TUN, отвечает DNS-модуль ядра; зашифрованный DNS не перехватывается. v2rayA и ядро исключаются всегда; другие процессы можно исключить в настройках по имени исполняемого файла. Более специфичные маршруты подключённых сетей и статические маршруты обходят TUN.

Известное ограничение: в Windows и macOS приложение, которое обращается напрямую к DNS-серверу в локальной сети, по-прежнему обходит TUN. Системный резолвер охвачен: Windows направляет его на шлюз TUN, macOS — на слушатель ядра на 127.0.0.1, для которого порт 53 должен быть свободен.

Правила маршрутизации

Редактор RoutingA в светлой и тёмной темах

У RoutingA два режима: список с формой для каждого правила и текст с номерами строк, подсветкой и построчной проверкой. Справка по синтаксису находится рядом с редактором. Правила можно импортировать из файла и экспортировать в файл.

Данные и обновления

База SQLite v2raya.db и сгенерированная конфигурация ядра лежат в каталоге конфигурации: /etc/v2raya в Linux и macOS, %ProgramData%\SYSTEM\v2rayA для службы Windows, каталог конфигурации пользователя при --lite или путь из --config. Журналы пишутся в /var/log/v2raya/v2raya.log юнитами systemd и OpenRC либо в --log-file / V2RAYA_LOG_FILE. Сетевые запросы выполняются только для обновления подписок, загрузки данных правил, измерения задержки и DNS.

Перед обновлением остановите службу и сделайте резервную копию каталога конфигурации. При обновлении с версии ниже 2.4 база BoltDB переносится при первом запуске; старый файл сохраняется как bolt.db.bak (bolt.db.bak.1 и далее, если это имя занято), учётные записи нужно зарегистрировать заново. Обновляйте v2raya и v2raya_core вместе: панель показывает версию ядра, а о несовпадении сообщает баннер.

Поддержка

Задавайте вопросы в Discussions и сообщайте об ошибках в Issues.

Не используйте этот проект в противоправных целях.

Благодарности

Основан @mzz2017. Интерфейс на Material Design 3, встроенный в ядро TUN и переработка службы в 2.5 — @Zakkaus. Файлы OpenRC предоставлены сообществом gentoo-zh. Данные маршрутизации — v2fly/domain-list-community и v2fly/geoip, для режима GFWList — Loyalsoldier/v2ray-rules-dat; правила прозрачного прокси основаны на опыте zfl9/ss-tproxy и hq450/fancyss.

Лицензия

AGPL-3.0-only. Ядро — форк Xray-core (MPL-2.0).