Инструкция по Advanced SSH
Расширенный SSH addon для HomeAssistant с дополнительными возможностями управления файлами, системой и терминалом.
📖 Обзор
Advanced SSH - это мощное расширение стандартного терминала Home Assistant, которое предоставляет расширенные возможности для управления вашей системой через SSH. Аддон включает в себя удобный файловый менеджер, системный мониторинг и дополнительные инструменты для администрирования.
Ключевые возможности
Терминал
Полноценный терминал с поддержкой всех команд Linux для управления системой Home Assistant.
Файловый менеджер
Удобный веб-интерфейс для управления файлами: просмотр, редактирование, загрузка и удаление.
Системный монитор
Отображение информации о системе: использование CPU, памяти, диска и сетевые подключения.
Безопасность
Защищенное подключение через SSH с поддержкой ключей и настройкой прав доступа.
Установка
-
Добавление репозитория
Откройте Home Assistant, перейдите в Настройки → Аддоны → Магазин и нажмите на меню (три точки) → "Репозитории"
https://github.com/wghaos/addons
-
Поиск аддона
В магазине аддонов найдите "Advanced SSH" или "WGHAOS SSH" в разделе добавленных репозиториев.
-
Установка
Нажмите на аддон и выберите "Установить". Дождитесь завершения загрузки и установки.
-
Конфигурация
Перейдите на вкладку "Конфигурация" и настройте параметры согласно вашим требованиям.
-
Запуск
Перейдите на вкладку "Информация" и нажмите "Запустить". После запуска откройте веб-интерфейс.
Конфигурация
Основные параметры
-
🔑
Пароль
Установите надежный пароль для SSH доступа. Рекомендуется использовать сложный пароль.
-
🌐
Порт
Укажите порт для SSH подключения. По умолчанию используется порт 22.
-
🔐
SSH ключи
Добавьте публичные SSH ключи для безпарольного входа в систему.
-
📂
Доступ к папкам
Настройте доступ к необходимым директориям Home Assistant через поле "map".
Примеры использования
Подключение через SSH клиент
Используйте любой SSH клиент для подключения к Home Assistant:
# Подключение к Home Assistant ssh root@homeassistant.local -p 22 # После подключения введите ваш пароль # Теперь вы можете выполнять любые команды Linux
Полезные команды
# Проверка состояния системы ha core info ha supervisor info # Перезапуск Home Assistant ha core restart # Просмотр логов ha core logs journalctl -f # Работа с файлами ls -la /config cd /config cat configuration.yaml
Файловый менеджер
Возможности
-
👁️
Просмотр файлов
Навигация по директориям и просмотр файлов прямо в браузере с подсветкой синтаксиса.
-
✏️
Редактирование
Редактирование файлов конфигурации YAML, Python скриптов и других текстовых файлов.
-
⬆️
Загрузка файлов
Загрузка файлов с вашего компьютера в файловую систему Home Assistant.
-
⬇️
Скачивание
Скачивание файлов из Home Assistant на локальный компьютер для резервного копирования.
Системный монитор
CPU
Отображение текущей загрузки процессора, количества процессов и температуры CPU.
Память
Информация об использовании оперативной памяти и swap-памяти системы.
Диск
Статистика использования дискового пространства для всех смонтированных разделов.
Сеть
Мониторинг сетевых подключений, трафика и активных интерфейсов.
⚠️ Важные предупреждения
- Всегда делайте резервную копию перед внесением изменений в системные файлы
- Будьте осторожны при выполнении команд с правами root
- Не отключайте критические системные службы без необходимости
- Используйте надежный пароль для SSH доступа
- Ограничьте доступ к SSH только доверенным устройствам в локальной сети
Решение проблем
Частые проблемы
Не удается подключиться по SSH
Проверьте, что аддон запущен, порт правильный и пароль введен верно. Убедитесь, что брандмауэр не блокирует подключение.
Файловый менеджер не загружается
Проверьте логи аддона на наличие ошибок. Возможно, недостаточно прав доступа к некоторым директориям.
Аддон вылетает с ошибкой
Проверьте конфигурацию на наличие синтаксических ошибок. Убедитесь, что все необходимые параметры указаны корректно.