Подключение по SSH к приставкам

Подключение по SSH — важный шаг для отладки, администрирования и масштабирования устройств.

Существует два варианта подключения:

через proxy_user (используя сервер OpenBalena как прокси);
напрямую через локальную настройку SSH-туннеля.

Вариант 1. Подключение через `proxy_user`

Этот вариант самый простой — используется заранее настроенный пользователь proxy_user на сервере OpenBalena.

Команда для подключения

ssh -t proxy_user@<open-balena-domain> ssh root@<box-long-uuid>.balena

Где:

<open-balena-domain> — домен вашего сервера OpenBalena;
<box-long-uuid> — полный UUID устройства (можно найти в панели OpenBalena).

После выполнения этой команды вы окажетесь в консоли устройства.

Вариант 2. Подключение без `proxy_user` (через локальную настройку)

Этот вариант подходит, если вы хотите подключаться напрямую, не используя учетную запись на сервере OpenBalena.

Шаг 1. Установка proxytunnel

1. Скачайте proxytunnel с GitHub.
2. Добавьте `proxytunnel.exe` в переменную окружения PATH.

Установите через пакетный менеджер: sudo apt install proxytunnel

Шаг 2. Настройка SSH

Создайте файл ~/.ssh/balena-ssh со следующим содержимым:
proxy_user=root proxy_passwd=<password>
Замените <password> на реальный пароль для доступа к туннелю.
chmod 600 ~/.ssh/balena-ssh
Добавьте в ~/.ssh/config следующую конфигурацию:
Host *.balena ProxyCommand proxytunnel -z -q -E -p tunnel.<open-balena-domain>:443 -d %h:22222 -F ~/.ssh/balena-ssh ServerAliveInterval 30
Эта настройка говорит SSH использовать proxytunnel для подключения через порт 443 и перенаправлять трафик на порт 22222 устройства.

Шаг 3. Подключение к устройству

Теперь можно подключаться напрямую:

ssh root@<box-long-uuid>.balena

После этого вы получите доступ к командной строке устройства Balena.

Как получить ID приставки?

То есть подключение к приставке будет выглядеть вот так:

ssh root@4494fc925e4589dsfvc7c28aba67ddecd.balena

Как настроить `proxy_user` на новом сервере?

Шаг 1. Создание пользователя

Создать пользователя proxy_user

adduser --disabled-password proxy_user

Шаг 2. Установка `proxytunnel`

Установить proxytunnel через apt

apt install proxytunnel -y

Шаг 3. Настройка authorized_keys

Настроить authorized_keys: вписать все публичные ssh ключи людей, которые будут использовать данного пользователя для доступа к приставкам.

Шаг 4. Настройка API-KEY

Вот тут есть вся информация.

То есть надо выдать api-key через balena-cli:

balena api-key generate proxytunnel

PS C:\Users\isupo> balena api-key generate proxytunnel
? Please pick an expiry date for the API key No expiration
Registered api key 'proxytunnel':

siHgh*********************

This key will not be shown again, so please save it now.

Запоминаем этот api-key - это наш proxy_passwd.

Шаг 5. Настройка config и balena-ssh

Действия аналогичны данному пункту.

После этого всё будет готово к использованию

27 October 2025