Skip to content

README.ru.md

Latest commit

 

History

History
73 lines (44 loc) · 7.19 KB

README.ru.md

File metadata and controls

73 lines (44 loc) · 7.19 KB

VPN Deck

English

Плагин для Decky Loader, позволяющий управлять VPN соединением через AmneziaWG на Steam Deck.

Screenshot

Дисклеймер

Ограничение ответственности: плагин — технический инструмент для управления сетевыми конфигурациями (конфиги AmneziaWG/WireGuard). Использование — на ваш страх и риск. Вы самостоятельно отвечаете за соблюдение законодательства вашей страны или региона. Разработчик не призывает к нарушению законов и не несёт ответственности за способ и цели использования плагина.

Плагин разрабатывался чисто на энтузиазме, в свободное время. При проблемах заводите детальный issue на GitHub: опишите шаги воспроизведения, версию плагина и системы, приложите логи при необходимости.

📋 Описание

VPN Deck — плагин для Decky Loader, который даёт управлять VPN через AmneziaWG прямо из игрового режима Steam Deck:

  • Импорт конфигов — добавление VPN из файла .conf через интерфейс плагина
  • Несколько конфигов — можно хранить и переключать несколько VPN-подключений
  • Включение и выключение каждого конфига одним переключателем
  • Статус подключений в реальном времени
  • История ошибок и возможность её очистки

Плагин требует root-доступ для работы с awg-quick и сетевыми интерфейсами.

⚠️ Важно: Ограничения

В версии 2 плагин не управляет интерфейсом awg0. Управляются только конфиги, добавленные через плагин (интерфейсы вида vd-<имя>).

Конфиги, импортированные через плагин, хранятся в ~/.local/share/vpn-deck/configs; симлинки создаются в /etc/amnezia/amneziawg/. Бинарники AmneziaWG входят в релиз плагина, отдельная установка не нужна.

Изменения между v1 и v2

v1 v2
Интерфейс Управлял только одним интерфейсом awg0 через systemctl Интерфейсом awg0 не управляет. Только конфиги, добавленные через плагин (интерфейсы vd-*)
Настройка Конфиг нужно было настраивать вручную в Desktop Mode (сборка amneziawg-go/awg-quick, создание awg0.conf, симлинки) Конфиги импортируются из UI (файл .conf). Бинарники входят в релиз
Конфиги Один конфиг (awg0) Несколько конфигов с именами vd-<имя>

Если вы использовали v1 с awg0, после обновления на v2 этот интерфейс плагин больше не поднимает и не останавливает. Чтобы управлять VPN через плагин, импортируйте конфиг заново через «Импортировать конфиг».

📥 Установка плагина

Устанавливайте плагин только из официальных релизов на GitHub.

Important

Конфиг должен быть в нативном формате AmneziaWG (.conf-файл в стиле WireGuard с полями Jc, Jmin, Jmax и т.д.). В приложении AmneziaVPN при экспорте нужно явно выбрать «AmneziaWG native format» — по умолчанию он не выбран.

Перед удалением плагина или установкой новой версии выключите VPN в самом плагине (переключатель у активного конфига поставьте в «выкл»). Иначе обновление или удаление могут завершиться с ошибкой.

  1. Откройте Releases и скачайте последний релиз (файл vpn-deck-v*.zip).
  2. Скопируйте ZIP на Steam Deck, откройте Decky Loader → настройки плагинов → «Установить плагин» → укажите путь к файлу.

После установки: откройте плагин в игровом режиме → «Импортировать конфиг» → выберите файл .conf (например, из папки «Загрузки»). После импорта конфиг появится в списке и его можно включать/выключать.

Как переслать конфиг на Steam Deck

Файл .conf нужно каким-то способом перенести на Deck, чтобы выбрать его в плагине:

  • LocalSend — установите приложение на телефон/ПК и на Deck (из Discover в Desktop Mode). Отправьте файл .conf на Deck; он окажется, например, в «Загрузки».
  • Desktop Mode + браузер — переключитесь в режим рабочего стола, откройте браузер, скачайте конфиг (или сохраните из почты/мессенджера) в папку «Загрузки». В игровом режиме в плагине укажите путь к этому файлу (например, /home/deck/Downloads/имя.conf).

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

  • Импорт конфига — кнопка «Импортировать конфиг», выбор файла .conf. Имя конфига — до 12 символов (буквы, цифры, _, =, +, ., -).
  • Включение/выключение — переключатель рядом с именем конфига.
  • Удаление конфига — «Удалить конфиг» под нужным конфигом (интерфейс будет остановлен).
  • Ошибки — раздел «Ошибки»: просмотр истории и кнопка «Очистить историю ошибок».

Поддержка и лицензия

При проблемах или вопросах — Issue на GitHub. Лицензия: BSD-3-Clause.