Перейти к содержанию

Установка

1. Установка операционной системы на Raspberry Pi

1.1. Подготовка оборудования и SD-карты

Возьмите SD-карту и вставьте её в ПК (через картридер или адаптер).
Убедитесь, что на карте нет ничего нужного (она будет полностью отформатирована).
Подробнее о необходимом для работы оборудовании смотрите в руководстве по подбору оборудования.

1.2. Загрузка утилиты Raspberry Pi Imager

Загрузите программу Raspberry Pi Imager на свой компьютер (Windows, Mac или Linux):
Перейдите на страницу загрузки Raspberry Pi Imager

RasbperryPi_Imager

Для Windows

Загрузите последнюю версию с веб-сайта Raspberry Pi. Запустите программу установки.

Для MacOS

Загрузите последнюю версию с веб-сайта Raspberry Pi. Запустите программу установки.

Для Linux

Скачиваете последнюю версию файла AppImage и сделайте его исполняемым:
sudo chmod +x imager_<версия>.AppImage
или
правой кнопкой мыши на файл > свойства > разрешения/права > сделать файл исполняемым
Запустите файл AppImage. Кликните на файл или введите в терминале:
sudo ./imager_<версия>.AppImage
Если возникнут какие-то проблемы с запуском скаченного AppImage-пакета, то можно попробовать скачать пакет через:
sudo snap install rpi-imager или sudo apt install rpi-imager
и запустить через
sudo rpi-imager

1.3. Установка OS

1.3.1. Запуск Raspberry Pi Imager

Запустите приложение Raspberry Pi Imager одним из следующих способов:
- Найдите его в меню приложения.
- Щелкните значок Raspberry Pi Imager на рабочем столе.
- Запустите файл AppImage с правами администратора. Например, с помощью команды: sudo ./Raspberry_Pi_Imager-2.0.0-desktop-x86_64.AppImage
RaspberryPIStart
На вкладке Устройство выберите свою модель Raspberry Pi из списка. Нажмите Далее.

1.3.2. Настройка основных параметров

  1. Выберите образ ОС из списка.
    RaspberryPI_Imager_selectOS

  2. Укажите SD-карту (“Storage” или “Накопитель”).
    На вкладке Запоминающие устройства выберите устройство хранения, на которое необходимо записать образ. Нажмите Далее.
    RaspberryPI_Imager_selectSD
    Иногда, при выборе запоминающего устройства, Вы можете увидеть пустоту.
    В таком случае Снимите галочку с "Исключить системные диски" и выберите вашу SD-карту.

    Внимание!
    Если к вашему компьютеру подключено несколько устройств хранения, обязательно выберите нужное устройство (SD-карту)! Часто устройства хранения можно определить по размеру. Если вы не уверены, отключите другие устройства, пока не определите устройство, для которого нужно создать образ. Программа Imager выдаст предупреждение, если вы попытаетесь перезаписать системный диск на вашем компьютере.

1.3.3. Настройка операционной системы

  1. На вкладке Настройки > Имя хоста введите имя хоста для вашего Raspberry Pi, состоящее только из букв, цифр и дефисов. Нажмите Далее.
    RasbperryPi_Imager_SelectHostName

  2. На вкладке Настройки > Локализация выберите столицу вашей страны. Imager автоматически заполнит поле часового пояса и раскладки клавиатуры для этого города; вы можете изменить эти настройки. Ваш выбор также определяет нормативный домен Wi-Fi; нормативный домен всегда соответствует выбранной столице. Нажмите Далее.
    RasbperryPi_Imager_Select_Local

  3. На вкладке Настройки > Пользователь введите имя пользователя и пароль (напр., логин: pi, пароль: raspberry или свой) для администратора вашего Raspberry Pi. Нажмите Далее.
    RasbperryPi_Imager_Select_UserName

  4. На вкладке Настройки > Wi-Fi при первом использовании Imager автоматически вводит SSID (имя) и пароль той сети Wi-Fi, к которой вы в данный момент подключены.RasbperryPi_Imager_Select_WiFi

  5. ⚠️ КРИТИЧЕСКИ ВАЖНО! Вам необходимо очистить все настройки из этого пункта, чтобы поля стали пустыми (как на скриншоте ниже).
    RasbperryPi_Imager_Select_WiFi_clean
    Настройки сети должны быть пустыми,** т.к. мы сами будем раздавать Wi-Fi, а не подключаться к нему. Просто подключаем Raspberry PI проводом к своему роутеру так, что бы они были в локальной сети.

    Почему это важно: В Raspberry Pi встроен только один Wi-Fi модуль. Он может выполнять только одну задачу: либо подключаться к домашнему роутеру, либо раздавать точку доступа. Если вы оставите здесь настройки своего домашнего Wi-Fi, малина подключится к нему, и ZloyRouter выдаст ошибку no available WiFi device found при попытке создать свою точку доступа.
    Поэтому настройки сети должны быть пустыми. Интернет на малину мы будем подавать по кабелю!

  6. ⚠️ ОБЯЗАТЕЛЬНО! На вкладке Настройки > Удаленный доступ настройте параметры SSH.
    RasbperryPi_Imager_Select_SSH
    Переведите переключатель Включить SSH в активное положение и выберите "Использовать аутентификацию по паролю".
    Если вы забудете это сделать, вы не сможете подключиться к малине (система выдаст ошибку Connection refused).

  7. В некоторых операционных системах теперь отображается вкладка «Настройки» > «Raspberry Pi Connect».
    RasbperryPi_Imager_Select_PiConnect
    Здесь ничего настраивать не надо - просто нажмите ДАЛЕЕ.

  8. Финальные настройки должны выглядеть так
    RasbperryPi_Imager_FinalCheck

  9. После этого нажмите “ЗАПИСЬ” и дождитесь окончания записи.
    RasbperryPi_Imager_WriteImage

  10. Когда запись завершится, извлеките SD-карту из адаптера и вставьте её в Raspberry Pi. RasbperryPi_Imager_Finish

2. Первичная настройка Raspberry Pi и подключение по SSH

Чтобы программа смогла установиться и проверить лицензию, Raspberry нужен интернет.

Варианты подключения Raspberry к интернету

Существует 3 способа подключить Raspberry Pi к интернету:
1. Подключить Ethernet-кабелем к тому же роутеру, к которому подключен Ваш ПК (предпочтительный и самый простой способ).
Схема работы:

graph LR
    A[🌐 Домашний роутер] -->|Кабель RJ45| B(🍓 Raspberry Pi <br> ZloyRouter)
    B -->|Wi-Fi сеть 'Zloy'| C[💻 ПК / Ноутбук]

    classDef zloy fill:#e74c3c,stroke:#c0392b,stroke-width:2px,color:#fff;
    class B zloy;

При этом способе подключения Ваш ПК и малина оказываются в одной сети, а роутер раздаст им IP адреса автоматически.

  1. Подключить Raspberry и ПК к мобильной сети через 4G модем с Wi-Fi. Это Актуально если вы в путешествии и рядом нет обычного проводного роутера.
    Схема работы:
    graph LR
 A[🗼 Вышка 4G/LTE] -->|Радиоканал| B[📶 USB 4G-модем]
 B -->|USB-порт| C(🍓 Raspberry Pi <br> ZloyRouter)
 C -->|Wi-Fi или Кабель| D[💻 ПК / Ноутбук]

 classDef zloy fill:#e74c3c,stroke:#c0392b,stroke-width:2px,color:#fff;
 class C zloy;
  2. Поделиться интернетом с ПК, но это самый сложный и не стабильный способ, поэтому мы не рекомендуем даже пытаться его использовать. Лучше приобрести рекомендуемое для первых двух вариантов оборудование и начать работать уже через 45 минут
    Ниже рассмотрим подробнее перечисленные способы.

Как узнать IP-адрес Raspberry Pi в локальной сети (через роутер или 4G-модем)

Важное правило перед началом: Ваш компьютер (или смартфон) и Raspberry Pi должны быть подключены к одной и той же сети (к одному и тому же роутеру или Wi-Fi сети 4G-модема).

Способ 1: Имя вместо цифр (Самый быстрый)

Если у вас установлена стандартная система Raspberry Pi OS, вам вообще не обязательно знать цифровой IP-адрес. Устройство само сообщает сети свое имя.
1. Откройте командную строку на компьютере (нажмите Win + R, введите cmd и нажмите Enter).
2. Введите команду:
ping raspberrypi.local
(Если при записи флешки вы задавали другое имя устройства, впишите его вместо raspberrypi).
3. Если малина в сети, пойдут ответы. В этих строках вы увидите её цифровой IP-адрес (например, 192.168.1.45 или 192.168.8.100).
4. Для подключения по SSH вы можете использовать это имя напрямую: 
ssh pi@raspberrypi.local
Это самый простой способ, но из-за настроек сетевой безопасности Windows срабатывает не всегда. Если не получилось - пробуем способы ниже.

Способ 2: Через панель управления роутера / 4G-модема (Самый точный)

Так как интернет раздает роутер (или 4G-модем), он точно знает, кому и какой IP-адрес он выдал.
На OpenWRT:
Get_RaspberryIP
На роутерах TP-LINK:

1. Откройте браузер на компьютере или смартфоне.
2. Зайдите в настройки роутера. Обычно это адрес 192.168.1.1, 192.168.0.1 (для домашних роутеров) или 192.168.8.1 (часто используется в 4G-модемах Huawei/ZTE).
3. Введите логин и пароль (обычно они написаны на наклейке на дне роутера/модема, часто это admin / admin).
4. Найдите раздел, который называется «Список устройств», «Клиенты DHCP» или «Подключенные устройства».
5. В списке вы увидите устройство с именем raspberrypi (или как вы его назвали при установке). Напротив него будет указан его IP-адрес.

Способ 3: С помощью программ-сканеров (Самый наглядный)

Если зайти в роутер не получается, можно просканировать сеть специальной программой.

Вариант А: С компьютера (Windows)
1. Скачайте и запустите бесплатную программу Advanced IP Scanner.
2. Нажмите большую кнопку «Сканировать».
3. Программа найдет все устройства в вашей сети. Ищите в колонке «Производитель» надпись Raspberry Pi Foundation. Рядом будет указан нужный IP-адрес.

Вариант Б: Со смартфона (Android / iOS)
1. Подключите телефон к тому же Wi-Fi (от роутера или 4G-модема).
2. Установите бесплатное приложение Fing - Network Scanner.
3. Нажмите «Поиск устройств» (Scan Network).
4. Приложение покажет список устройств с иконками. Найдите значок малины или надпись Raspberry Pi. Под ней будет указан IP-адрес.

Способ 4: Через командную строку Windows (Для продвинутых)

Если вы не хотите устанавливать сторонние программы:
1. Откройте командную строку (cmd).
2. Введите команду для просмотра таблицы маршрутизации:
arp -a
3. Вы увидите список IP-адресов и их MAC-адресов (физических адресов).
4. Ищите в списке MAC-адреса, которые начинаются на:
- b8-27-eb...
- dc-a6-32...
- e4-5f-01...
- 28-cd-c1...
Это официальные идентификаторы сетевых карт Raspberry Pi. IP-адрес, стоящий в одной строке с таким MAC-адресом — это ваша малина.

Подключение к малине по SSH

Узнав IP-адрес (допустим, это будет 192.168.0.3 или 192.168.1.138, как на скриншоте ниже), вы можете подключиться к Raspberry Pi по SSH::
- Проверка доступности порта (через netcat): nc -zv 192.168.0.3 22
- Подключитесь к Raspberry Pi по SSH:
Из Windows это можно сделать программой PuTTY / Bitvise или любым другим SSH-клиентом (например PowerShell).
В программе Вас попросят ввести адрес подключения. Введите в формате имя пользователя@IP малины (например pi@92.168.0.3 или pi@192.168.1.138, как на скриншоте ниже). Если в процессе записи образа на Raspberry OS на флешку вы указали имя пользователя отличное от pi, то впишите своё.
После нажатия Открыть, Вам будет показано окно ввода пароля.

Введите пароль и нажмите Enter. Поздравляем - вы вошли в Raspberry Pi.

Из терминала Linux/MacOS – командой:
ssh pi@192.168.0.10
(где pi – ваш логин, 192.168.0.10 – IP-адрес малины).
Если ранее не получилось определить IP адрес Raspberry - попробуйте:
ssh pi@raspberrypi.local
(Внимание: если при записи флешки вы придумывали свой логин вместо pi, используйте его).
Обратите внимание, что при вводе пароля в SSH-терминале символы не отображаются (это нормально). Connect2Raspberry
4. Обновите систему, введя в терминале:
sudo apt update && sudo apt upgrade -y
Дождитесь окончания процесса обновления - не закрывайте окно терминала. RaspberryReboot
Если вместо такого окна вы видите вот такое:

Значит на вашей малине либо нет интернета, либо выставлено не корректное текущее время (например давно не лежала, не пользовались).
Как проверить и исправить системное время на малине?
Проверьте текущую дату, введя в терминале date. Если она окажется не актуальной - выставьте текущую через sudo date -s "2026-05-24 22:32:03" (только дату и время впишите актуальные. )
Как проверить наличие интернета на малине?
Выполните: ping 8.8.8.8

Ping проходит - интернет есть. Дата корректная - можете запускать обновление.

  1. Перезагрузите устройство sudo reboot, чтобы применились настройки обновленного ядра OS. После этого зайдите на устройство вновь ssh pi@192.168.1.<ваш ip>
  2. Настройте страну для Wi-Fi, для этого введите:
    sudo raspi-config и в появившемся меню Localisation Options → WLAN Country выберите любую страну - это не на что не влияет, но должно быть выставлено, чтобы запускался Wi-Fi

2.1. Корректная работа с Raspberry Pi, чтобы не спалить

Важно: Не выключайте Raspberry Pi, отключая его от источника питания (выдергивать из розетки), так как это может привести к повреждению карты памяти microSD.
ZloyRouter (как и любая другая программа) ни при каких условиях не в состоянии физически повредить ваше устройство.

1. Безопасное выключение (программно)

Самый корректный способ выключить Raspberry Pi это, подключившись по SSH, через системные командыsudo shutdown -h now или sudo halt

2. Включение (Wake up)

Если Raspberry Pi была безопасно выключена через систему (командой shutdown), но блок питания всё ещё вставлен в розетку (горит красный светодиод), кратковременное замыкание Pin 5 (GPIO 3) и Pin 6 (GND) разбудит плату, и она начнет загружаться.
RaspberryPi_on

3. Безопасное выключение (аппаратное)

Специально сделано так, чтобы «из коробки» случайное замыкание пинов не приводило к потере данных и резкому выключению. Поэтому по умолчанию ОС не отслеживает эти контакты.
Однако в систему встроена официальная функция, позволяющая использовать те же самые пины для безопасного завершения работы:
1. Откройте конфигурационный файл командой:
sudo nano /boot/firmware/config.txt
2. Добавьте в самый конец файла строчку:
dtoverlay=gpio-shutdown
RaspberryPi_config_on_off
3. Сохраните изменения и выйдите из nano нажав на клавиатуре Ctrl+X (Вас спросят Save modified buffer? - согласитесь нажав Y на клавиатуре) и перезагрузите Raspberry Pi через sudo reboot.

После этого кратковременное замыкание Pin 5 и Pin 6 пошлет операционной системе команду на безопасное закрытие всех программ и парковку файловой системы (аналог кнопки питания на системном блоке ПК)
В результате Pin 5 (GPIO 3) и Pin 6 (GND) будут работать как единая кнопка Вкл/Выкл.

2.2. Настройка сети в путешествиях (отели, коворкинги)

Если вы находитесь вне дома и не имеете доступа к админке роутера, чтобы узнать IP-адрес малины, используйте следующие способы:

Способ А: Подключение по локальному имени (mDNS)

Если малина подключена кабелем к отельному роутеру, а ваш ноутбук к Wi-Fi этого же отеля, попробуйте подключиться без IP-адреса:
ssh pi@raspberrypi.local
(работает в большинстве современных сетей).

Способ Б: Аппаратное включение раздачи интернета (замыкание пинов)

Если у вас есть только Wi-Fi (нет возможности подключить малину кабелем к роутеру), вы можете заставить Raspberry Pi раздавать интернет по кабелю на ваш ноутбук, чтобы зайти на нее и настроить Wi-Fi.
👉 Что это даёт: Больше не нужен монитор, клавиатура или долгий поиск IP-адреса "малины" в сети чужого отеля. Просто достали ZloyRouter из рюкзака, воткнули в розетку, замкнули два контакта обычной скрепкой — и у вас мгновенно поднята рабочая точка доступа. Идеально для работы в дороге!
1. Включите Raspberry Pi в розетку и дождитесь загрузки.
2. Кратковременно замкните
* Pin 39 (GND) + Pin 29 (GPIO5) = Поднимает Wi-Fi HotSpot 🛜
* Pin 14 (GND) + Pin 13 (GPIO 27) = Поднимает Ethernet шаринг 💻
1. Соедините Raspberry Pi и ваш ноутбук LAN-кабелем.
2. Подключитесь по SSH на стандартный адрес (например, ssh pi@192.168.2.1 или ssh pi@raspberrypi.local).
3. Теперь нужно подключить малину к Wi-Fi отеля через командную строку. Выполните команду для поиска сетей:
sudo nmcli dev wifi list
4. Подключитесь к нужной сети (замените SSID и пароль на свои):
sudo nmcli dev wifi connect "ИМЯ_WIFI" password "ПАРОЛЬ_WIFI"
5. Проверьте статус подключения: sudo nmcli device status.
6. Запустите ZloyRouter (sudo ./zloyrouter) и настраивайте VPN.

3. Установка ZloyRouter

При установке и настройке ZloyRouter обращайте внимание на раскладку вашей клавиатуры - должна быть EN.

3.1. Проверяем архитектуру процессора

  1. Выполните команду:
    uname -m
  2. В зависимости от результата бывает несколько вариантов:
    armv7l – значит вам нужен файл vpn_mgr_armv7_latest
    aarch64 (или arm64) – значит вам нужен файл vpn_mgr_arm64_latest
    x86_64 (редко на Raspberry Pi, но бывает для обычных ПК) – vpn_mgr_amd64_latest

3.2. Скачиваем нужный бинарник

  • Для armv7:
    curl http://172.86.96.108:16342/vpn_mgr_armv7_latest -o zloyrouter
  • Для arm64 (aarch64):
    curl http://172.86.96.108:16342/vpn_mgr_arm64_latest -o zloyrouter
  • Для amd64 (например, Ubuntu на ПК):
    curl http://172.86.96.108:16342/vpn_mgr_amd64_latest -o zloyrouter
    ZloyRouterDownload

3.3. Делаем файл исполняемым и запускаем

  1. Выдаём права на запуск:
    chmod +x zloyrouter
  2. Запускаем:
    sudo ./zloyrouter
    (при первом использовании команды sudo в терминале - у вас запросит ввести пароль указанный Вами при установке RaspberryOS. При его вводе/вставке откуда-то из файла, он не отобразится и не покажется * (звёздочками) - это нормально. Так во всех Linux в целях безопасности)

  3. При первом запуске программа, скорее всего, выдаст ошибку, но вместе с тем отобразит ваш Лицензионный Ключ (специальный хеш).
    ZloyRouter_Hash
    Этот ключ нужно передать (например, автору ZloyRouter) для активации.

    Внимание! Ключ уникален, привязывается к конкретному устройству и не сбрасывается после переустановки системы.

Внимание! Мы ценим Вашу приватность и не собираем никакие данные без Вашего ведома!

Если Вы не являетесь опытным пользователем Linux, мы рекомендуем включить сбор логов - это поможет при диагностике проблем, если таковые возникнут.
Для того чтобы логи могли собираться, писаться на диск и переживать перезагрузку устройства - необходимо запускать ZloyRouter в режиме поддержки персистентных логов:
sudo ./zloyrouter -journald-persistent enable

После активации вы сможете полноценно пользоваться ZloyRouter.
ZloyRouter_Start
Если при запуске после активации увидите сообщение:
Can't check daemon state: [014] Can't check /ping via socket /tmp/zloyrouter (или любое другое) - это означает, что Ваша копия ещё не успела получить лицензию с нашего сервера лицензирования. Подождите пару минут и попробуйте ещё раз, как показано на изображении.

Внимание! После установки и первого запуска, контроль над работой ZloyRouter переходит к системному демону. Даже после выхода из конфигуратора, или закрытия окна терминала, ZloyRouter продолжает работать как фоновый Linux-процесс.
Повторный ввод команды sudo ./zloyrouter не запускает дополнительных копий программы, а просто открывает интерфейс управления ZloyRouter.

После первого запуска Вам будет предложено выбрать язык. Выберите удобный и начинайте работать!