Как подключиться к Algo VPN

TL;DR

Algo VPN использует WireGuard и генерирует конфиги и сертификаты на вашем VPS. Чтобы подключиться с телефона — просканируйте QR-код в официальном приложении WireGuard. Чтобы подключиться с компьютера — скопируйте .conf файл с VPS и импортируйте его в клиент WireGuard.

Algo VPN — набор скриптов для быстрого развёртывания личной VPN на арендованном VPS. Он создаёт настройки и закрытые ключи для каждого устройства. В этом руководстве показано, как получить эти конфиги на VPS и использовать их на мобильных и настольных устройствах.

Важно: Algo использует модель “один профиль — одно устройство”. Каждый девайс должен иметь отдельный пользовательский профиль и соответствующий конфиг.

Коротко о WireGuard

WireGuard — современный, лёгкий VPN-протокол. Он работает быстрее и проще в настройке, чем классические решения. В одну строку: WireGuard защищает трафик с помощью асимметричных ключей и компактных конфигураций.

Подготовка: вход на VPS и где искать конфиги

1. Подключитесь к VPS по SSH:

ssh -Y username@vps.ip.address

Флаг -Y нужен, если вы хотите просматривать изображения в терминале на локальной машине через перенаправлённый X11.

2. В каталоге algo-master расположена папка configs, где Algo сохраняет конфигурации и PNG-файлы с QR-кодами:

ls algo-master/configs/

3. В подкаталоге с IP вашего VPS найдите папку wireguard:

ls algo-master/configs/your.vps.ip.address/wireguard/

Там будут файлы с расширениями .conf и PNG с QR-кодами, по одному для каждого пользователя/устройства.

Если вы хотите просматривать PNG прямо в терминале, установите ImageMagick (на Debian/Ubuntu):

sudo apt install imagemagick

Затем отобразите QR-код командой display:

display algo-master/configs/your.vps.ip.address/wireguard/laptop.png

Подключение на iPhone и Android

1. Установите официальное приложение WireGuard из App Store, Google Play или F‑Droid.
2. Откройте приложение.
3. Нажмите синий плюс (+) и выберите Scan from QR Code.
4. На VPS выполните команду display (см. выше) и наведите камеру телефона на QR‑код.
5. Дайте туннелю понятное имя и включите переключатель для активации.

Примечание: если телефон и VPS не видят один другого (например, вы используете удалённый рабочий стол), можно вывести PNG на локальную машину и просканировать с экрана.

Подключение на macOS, Windows и Linux (десктоп)

Сканировать QR неудобно на ПК. Копируйте .conf файл с VPS на локальную машину:

scp username@vps.ip.address:algo-master/configs/your.vps.ip.address/wireguard/laptop.conf .

Затем установите клиент WireGuard для вашей ОС (страница загрузки WireGuard). Откройте клиент, выберите Import tunnel from file и укажите скачанный .conf файл.

macOS: WireGuard поддерживается на Mojave и новее. Windows: клиент есть в виде приложения. Linux: используйте GUI вашей дистрибуции или wg-quick в терминале:

sudo wg-quick up laptop.conf

Мини‑методология — шаги в порядке выполнения

1. Развернуть Algo на VPS согласно инструкции развертывания.
2. Проверить наличие каталога algo-master/configs и подкаталога wireguard.
3. Определить имя пользователя (используйте описательные имена: work-laptop, personal-phone).
4. Для мобильных: отобразить PNG, сканировать QR в приложении WireGuard.
5. Для десктопа: scp .conf, импортировать в клиент WireGuard или запустить wg-quick.
6. Проверить подключение: открыть браузер и убедиться, что IP изменился на IP VPS.

Критерии приёмки

• Профиль импортируется и активируется в приложении WireGuard.
• Все запросы идут через VPN (проверить через сервис проверки IP).
• Трафик шифруется (видны интерфейсы WireGuard при проверке сети).

Проверка и тестовые сценарии

• Тест 1: импортировать .conf и подключиться — ожидаемый результат: туннель активен, IP изменён.
• Тест 2: импортировать QR на телефон и подключиться с мобильной сети — ожидаемый: соединение установлено, пинг к внешнему IP успешен.
• Тест 3: отключение и повторное подключение — ожидаемый: туннель восстанавливается без ошибок.

Чек‑лист по ролям

Администратор VPS

• Установить Algo и подтвердить наличие configs.
• Добавить пользователей с понятными именами.
• Настроить брандмауэр на VPS (разрешить WireGuard порт).

Пользователь устройства

• Получить .conf или PNG с QR-кодом.
• Импортировать в WireGuard.
• Проверить работу туннеля.

Безопасность и рекомендации по ужесточению

• Храните .conf и PNG в защищённом месте. Они содержат ключи.
• Используйте уникальные имена профилей для отслеживания устройств.
• Ограничьте доступ к консоли VPS и используйте SSH-ключи вместо паролей.
• Регулярно обновляйте систему VPS и сам Algo.
• Включите отказоустойчивые правила iptables/nftables только для WireGuard-интерфейса, чтобы случайный трафик не утекал вне туннеля.

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

Когда Algo VPN не лучший выбор (контрпример)

• Вам нужна корпоративная VPN с централизованной аутентификацией LDAP/AD — Algo не даёт готовой интеграции.
• Нужно детальное логирование и мониторинг с множеством политик доступа — лучше рассмотреть коммерческие решения.
• Вы хотите множества серверов с автоматическим балансированием — Algo рассчитан на простую персональную установку.

Альтернативные подходы

• OpenVPN: более универсален и совместим со старым ПО, но сложнее в настройке.
• Tailscale/ZeroTier: сетевые оверлейные решения без работы с публичным VPS, проще для пэр‑то‑пэр.
• Коммерческие VPN‑сервисы: простая настройка для конечного пользователя, но теряется полный контроль над сервером и логами.

Инцидентный план и откат

• Потеря ключа: удалите профиль на VPS и создайте новый.
• Некорректный маршрут: проверьте правила iptables/nftables и /etc/sysctl.conf на предмет включённого IP forwarding.
• Ошибка при подключении: проверьте системные логи WireGuard (journalctl -u wg-quick@имя).

Согласованность с конфиденциальностью (GDPR)

Algo не собирает телеметрию. Если вы используете VPS у провайдера, провайдер может логировать соединения. Для соответствия требованиям конфиденциальности выберите хостинг в нужной юрисдикции и уточните политику логирования у провайдера.

Частые ошибки и как их исправить

• Неправильное имя файла при scp — проверьте путь и права доступа.
• Невключённый IP forwarding на VPS — включите net.ipv4.ip_forward = 1.
• Брандмауэр блокирует порт WireGuard — откройте на VPS UDP‑порт, указанный в конфиге.

Краткий глоссарий

• VPS — виртуальный приватный сервер.
• .conf — конфигурационный файл WireGuard.
• QR‑код — быстрый способ импортировать профиль в мобильный клиент.
• wg-quick — утилита для быстрого поднятия интерфейса WireGuard.

Резюме

Algo VPN позволяет быстро развернуть личный VPN и с гибкостью подключать отдельные устройства через WireGuard. Для мобильных устройств удобнее использовать QR‑коды, для десктопов — импорт .conf файлов. Следуйте безопасности: храните ключи в безопасности, контролируйте доступ к VPS и держите софт в актуальном состоянии.

Важно: каждый профиль — отдельное устройство. Удаляйте неиспользуемые профили на VPS.