Files
v2rayA/README_ru.md
T
Markson GuGa Beyond 3c32891eb3 docs: document the Alpine apk package
The release page now carries installer_alpine_<arch>_<version>.apk. It is
built without a key from Alpine's trust store, so apk needs
--allow-untrusted.
2026-11-02 11:58:34 +08:00

18 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

В Alpine возьмите installer_alpine_linux_x64_${VERSION}.apk со страницы выпусков, заменив часть имени с архитектурой на подходящую. В архиве лежат скрипт OpenRC и /etc/conf.d/v2raya; он не подписан ключом из доверенного хранилища Alpine, поэтому нужен --allow-untrusted:

sudo apk add --allow-untrusted ./installer_alpine_linux_x64_${VERSION}.apk
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, проверки новой версии на GitHub при запуске и раз в неделю, а также запроса NTP (ntp.aliyun.com) при сбое узла VMess, чтобы отличить неверные часы от неисправного узла.

Перед обновлением остановите службу и сделайте резервную копию каталога конфигурации. При обновлении с версии ниже 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).