Установка GSG

1 Выберите устройство и скачайте Armbian

Минимальный CLI-образ Debian 13 (Trixie) с Linux 6.x. Размер ~300 МБ. Без рабочего стола — только то, что нужно для роутера.

Не нашли своё устройство? Проверьте список 339 поддерживаемых плат на armbian.com/download. GSG работает на любом Debian/Ubuntu с Docker.

2 Запишите образ на microSD

Понадобится microSD-карта от 8 ГБ (рекомендуем Samsung PRO Endurance) и кардридер. Распакуйте .img.xz и запишите на карту через одну из утилит:

• balenaEtcher — graphical, кросс-платформа, умеет распаковывать .xz на лету
• Raspberry Pi Imager — graphical, есть пункт «Use custom image»
• dd в Linux/macOS — для тех, кто знает что делает

После записи — вставьте карту в одноплатник, подключите Ethernet к LAN-порту роутера, подключите питание (USB-C или 5В через micro-USB в зависимости от модели).

3 Первичный вход по SSH

После загрузки устройство получит IP по DHCP от вашего роутера. Найдите его в админке роутера (раздел «DHCP / Подключённые устройства»). Войдите по SSH:

ssh root@<IP-устройства>

Пароль по умолчанию: 1234. Armbian при первом входе попросит:

• Задать новый пароль root
• Создать обычного пользователя — можно пропустить (нажать Ctrl+C, для GSG не нужно)
• Выбрать локаль и часовой пояс — Russian / Europe-Moscow

Готово — вы внутри Armbian. Переходите к Шагу 4.

4 Установите GSG одной командой

Выполните на устройстве:

bash <(curl -fsSL https://www.globalshield.ru/install.sh)

Скрипт сделает за вас:

• Установит Docker
• Спросит IP для GSG (рекомендует подходящий), интерфейс LAN и режим DHCP
• Соберёт Docker-образы (Mihomo, web-orchestrator, net-enforcer, dnsmasq)
• Зарегистрирует устройство и сгенерирует пароль для веб-интерфейса
• Запустит сервисы и сохранит сетевую конфигурацию

Занимает ~3 минуты при стабильном интернете.

5 Сделайте GSG шлюзом для устройств

В админке Wi-Fi роутера укажите GSG как Default Gateway для клиентов (или включите режим DHCP-сервера на самом GSG — он раздаст IP с правильным gateway). Откройте веб-интерфейс:

http://<IP-GSG>:8080

Пароль был выведен скриптом установки в Шаге 4 (сохраните!). Введите URL подписки GlobalShield — и трафик ваших устройств пойдёт через VPN.