amnezia-client/README_RU.md

Amnezia VPN

Лучший клиент для создания VPN на собственном сервере

English | Русский

AmneziaVPN — это open source VPN-клиент, ключевая особенность которого заключается в возможности развернуть собственный VPN на вашем сервере.

Сайт | Зеркало сайта | Документация | Решение проблем

Tip

Если сайт Amnezia заблокирован в вашем регионе, вы можете воспользоваться ссылкой на зеркало.

Все релизы

Особенности

• Простой в использовании — введите IP-адрес, SSH-логин и пароль, и Amnezia автоматически установит VPN-контейнеры Docker на ваш сервер и подключится к VPN.
• Классические VPN-протоколы: OpenVPN, WireGuard и IKEv2.
• Протоколы с маскировкой трафика (обфускацией): OpenVPN с плагином Cloak, Shadowsocks (OpenVPN over Shadowsocks), AmneziaWG and XRay.
• Поддержка Split Tunneling — добавляйте любые сайты или приложения в список, чтобы включить VPN только для них.
• Поддерживает платформы: Windows, macOS, Linux, Android, iOS.
• Поддержка конфигурации протокола AmneziaWG на бета-прошивке Keenetic.

Ссылки

• https://amnezia.org - Веб-сайт проекта | Альтернативная ссылка (зеркало)
• https://docs.amnezia.org - Документация
• https://www.reddit.com/r/AmneziaVPN - Reddit
• https://t.me/amnezia_vpn_en - Канал поддержки в Telegram (Английский)
• https://t.me/amnezia_vpn_ir - Канал поддержки в Telegram (Фарси)
• https://t.me/amnezia_vpn_mm - Канал поддержки в Telegram (Мьянма)
• https://t.me/amnezia_vpn - Канал поддержки в Telegram (Русский)
• https://vpnpay.io/en/amnezia-premium/ - Amnezia Premium | [Зеркало](https://storage.googleapis.com/kldscp/vpnpay.io/ru/amnezia-premium)

Технологии

AmneziaVPN использует несколько проектов с открытым исходным кодом:

• OpenSSL
• OpenVPN
• Qt
• LibSsh
• WireGuard
• Xray-core
• Conan
• и другие...

Помощь с переводами

Загрузите самые актуальные файлы перевода.

Перейдите на вкладку "Actions", нажмите на первую строку. Затем прокрутите вниз до раздела "Artifacts" и скачайте "AmneziaVPN_translations".

Распакуйте этот файл. Каждый файл с расширением *.ts содержит строки для соответствующего языка.

Переведите или исправьте строки в одном или нескольких файлах *.ts и загрузите их обратно в этот репозиторий в папку client/translations. Это можно сделать через веб-интерфейс или любым другим знакомым вам способом.

Проверка исходного кода

После клонирования репозитория обязательно загрузите все подмодули.

git submodule update --init --recursive

Руководство по разработке

Хотите внести свой вклад? Добро пожаловать!

Требования для сборки

• CMake
• Компилятор и система сборки, в зависимости от таргета:
  • [Linux] Любые make и gcc
  • [Apple] Xcode или Xcode command line tools
  • [Windows] Visual Studio 2022 или VS 2022 Build Tools
  • [Android] Android SDK и Ninja
• Qt 6.10+ со следующими модулями:
  • Основные модули для таргета (Desktop/Android/iOS)
  • Qt 5 Compatibility module
  • Qt Remote Objects
• Пакетный менеджер Conan
  • На MacOS достаточно использовать homebrew или установить в .venv в корень проекта
  • Для остальных систем необходимо прописать пути в PATH
• (Необязательно) Заивисимости для установщиков:
  • [Windows/Linux] Qt Installer Framework
  • [Windows] WIX toolset

Сборка проекта через скрипты

• Запустите скрипты, находящиеся в папке deploy
• Если все зависимости установлены в стандартных локациях, скрипт найдёт их самостоятельно
• Если пути отличаются, их нужно явно указать используя:
  • QT_INSTALL_DIR - корневая папка установки Qt
  • QT_ROOT_PATH - корневая папка Qt Framework
  • QIF_ROOT_PATH - корневая папка Qt Installer Framework
  • ANDROID_HOME - путь к Android SDK
  • и другие. Их можно получить из вышеуказанных скриптов

Unix-like:

# Build executables for the host platform
deploy/build.sh

# Or just
deploy/build.sh

# Build executables and installers for the host platform
deploy/build.sh --installer all

# Build Android APK and AAB
deploy/build.sh -t android --aab

# Call for help
deploy/build.sh -h

Windows:

:: Build executables for Windows
deploy/build.bat

:: Build executables with IFW installer for Windows
deploy/build.bat --installer ifw

:: Build executables with IFW and WIX installer for Windows
deploy/build.bat --installer ifw --installer wix

:: Or just
deploy/build.bat --installer all

Разработка в IDE

• Можно использовать любые IDE которые умеют работать с CMake и находить Qt Kits. Например:

  • Qt Creator
  • Visual Studio Code with Qt Extension Pack
  • и так далее

• Для использования Xcode нужно сконфигурировать проект с помощью cmake. Самый простой способ это сделать - использовать Qt Creator для конфигурации. Затем, нужно открыть файл AmneziaVPN.xcodeproj из папки сборки с помощью Xcode. Учтите, что никакие файлы фактически не сохраняются - они сохраняются в директории сборки. Если требуется, скопируйте файлы вручную

• Android studio может быть использована подобным вышеуказанному способу - нужно использовать cmake вручную или через Qt Creator для конфигурации. Далее, откройте <build-dir>/client/android-build в Android studio. Не забудьте скопировать изменённые файлы в папку с исходным кодом - все файлы, изменённые в IDE, сохраняются фактически в папке сборки.

Установка Android SDK

• Android SDK может быть установлен следующими способами:
  • Используя Qt Creator, через настройки в пунктах Preferences->SDKs
  • Используя Android studio. По умолчанию необходимые SDK устанавливаются автоматически.
  • Вручную, используя sdk-manager. Подробности можно найти здесь

Лицензия

GPL v3.0

Донаты

Patreon: https://www.patreon.com/amneziavpn

Bitcoin: bc1qmhtgcf9637rl3kqyy22r2a8wa8laka4t9rx2mf
USDT BEP20: 0x6abD576765a826f87D1D95183438f9408C901bE4
USDT TRC20: TELAitazF1MZGmiNjTcnxDjEiH5oe7LC9d
XMR: 48spms39jt1L2L5vyw2RQW6CXD6odUd4jFu19GZcDyKKQV9U88wsJVjSbL4CfRys37jVMdoaWVPSvezCQPhHXUW5UKLqUp3
TON: UQDpU1CyKRmg7L8mNScKk9FRc2SlESuI7N-Hby4nX-CcVmns

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

Этот проект тестируется с помощью BrowserStack. Мы выражаем благодарность BrowserStack за поддержку нашего проекта.