Инструкция по Filebrowser

Что такое Filebrowser?

Filebrowser — это мощный аддон для HomeAssistant, который предоставляет веб-интерфейс для управления файлами в вашей системе. С его помощью вы можете просматривать, загружать, скачивать, редактировать и удалять файлы прямо из браузера, не используя SSH или другие сложные инструменты.

Установка Filebrowser

1Установка через репозиторий аддонов

Перед установкой Filebrowser необходимо добавить репозиторий Home Assistant WGHAOS в Home Assistant:

1. Откройте Home Assistant
2. Перейдите в Настройки → Аддоны → Магазин
3. Нажмите на меню (три точки) в правом верхнем углу
4. Выберите Репозитории
5. Добавьте репозиторий: https://github.com/wghaos/wghaos-addons
6. Подождите, пока аддоны загрузятся

2Установка аддона

1. В магазине аддонов найдите FileBrowser
2. Нажмите на него
3. Нажмите кнопку Установить
4. Дождитесь завершения установки

3Настройка перед запуском

После установки перед запуском необходимо настроить несколько параметров:

• Путь к корневой директории: Укажите путь к папке, которую вы хотите управлять (например, /share)
• База данных: Оставьте значение по умолчанию /data/filebrowser.db
• Порт: Укажите порт для доступа к веб-интерфейсу (по умолчанию 8080)

4Запуск аддона

1. После настройки нажмите Запустить
2. Откройте веб-интерфейс аддона
3. Вы будете перенаправлены на страницу входа

Конфигурация Filebrowser

Основные параметры

В конфигурации аддона доступны следующие параметры:

• Root: Корневая директория для управления файлами
• Database: Путь к файлу базы данных пользователей
• Port: Порт для веб-интерфейса
• Base URL: Базовый URL (если используется через Ingress)
• Log Level: Уровень логирования (info, warning, error, debug)

Доступ через Ingress

Для доступа к Filebrowser через интерфейс Home Assistant:

1. В настройках аддона включите Show in sidebar
2. Filebrowser появится в боковом меню Home Assistant
3. Вы можете настроить Base URL для работы через Ingress

Управление пользователями

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

1. Войдите в Filebrowser под учётной записью администратора
2. Нажмите на иконку пользователя в правом верхнем углу
3. Выберите Пользователи → Новый пользователь
4. Заполните поля:
   • Имя пользователя: Уникальное имя для входа
   • Пароль: Надёжный пароль
   • Область видимости: Путь к директории (например, / для полного доступа)
5. Настройте права доступа пользователя
6. Нажмите Сохранить

Права доступа

Для каждого пользователя можно настроить следующие разрешения:

• Администратор: Полный доступ ко всем функциям
• Создание: Разрешает создавать новые файлы и папки
• Удаление: Разрешает удалять файлы и папки
• Загрузка: Разрешает загружать файлы
• Скачивание: Разрешает скачивать файлы
• Редактирование: Разрешает редактировать файлы

Изменение пароля

1. Откройте настройки пользователя
2. Нажмите Изменить пароль
3. Введите новый пароль дважды для подтверждения
4. Нажмите Сохранить

Использование Filebrowser

Навигация по файлам

Интерфейс Filebrowser интуитивно понятен:

• Левая панель: Дерево директорий для быстрой навигации
• Центральная область: Содержимое текущей директории
• Верхняя панель: Текущий путь и кнопки управления
• Правая панель: Информация о выбранном файле

Загрузка файлов

Для загрузки файлов в систему:

1. Перейдите в нужную директорию
2. Нажмите кнопку Загрузить (иконка облака со стрелкой вверх)
3. Выберите файлы на вашем компьютере
4. Дождитесь завершения загрузки

Скачивание файлов

Для скачивания файлов:

• Для одного файла: нажмите на иконку скачивания рядом с файлом
• Для нескольких файлов: выделите файлы и нажмите Скачать
• Для папки: нажмите на иконку скачивания рядом с папкой (будет создан ZIP-архив)

Редактирование файлов

Filebrowser включает встроенный текстовый редактор:

1. Нажмите на файл, который хотите отредактировать
2. Выберите Редактировать (иконка карандаша)
3. Внесите необходимые изменения
4. Нажмите Сохранить

Предпросмотр файлов

Некоторые типы файлов можно просматривать непосредственно в браузере:

• Изображения: JPG, PNG, GIF, SVG
• Аудио: MP3, WAV, OGG
• Видео: MP4, WebM
• Документы: PDF, Markdown

Продвинутое использование

Совместное использование файлов

Filebrowser позволяет создавать публичные ссылки для совместного доступа:

1. Выберите файл или папку
2. Нажмите Поделиться
3. Настройте параметры доступа:
   • Срок действия ссылки
   • Пароль для доступа
   • Разрешения (только просмотр или скачивание)
4. Скопируйте сгенерированную ссылку

Поиск файлов

Filebrowser включает функцию поиска для быстрого нахождения файлов:

• Используйте строку поиска в верхней части интерфейса
• Введите имя файла или часть названия
• Результаты будут отображены в реальном времени

Сортировка и фильтрация

Управляйте отображением файлов с помощью сортировки:

• По имени: Алфавитный порядок
• По размеру: От большего к меньшему
• По дате изменения: Последние изменения

Горячие клавиши

Filebrowser поддерживает клавиатурные сокращения:

• Ctrl + N — Создать новую папку
• Ctrl + U — Загрузить файлы
• Delete — Удалить выбранные файлы
• F2 — Переименовать файл
• Ctrl + F — Поиск

Решение проблем

Аддон не запускается

Возможные причины:

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

Решение:

• Проверьте логи аддона в настройках
• Убедитесь, что указанный путь существует
• Измените порт, если он занят

Не удаётся загрузить файлы

Возможные причины:

• Недостаточно места на диске
• Отсутствуют права записи в директорию
• Файл превышает лимит размера

Решение:

• Проверьте свободное место на диске
• Убедитесь, что у пользователя есть права на загрузку
• Разбейте большие файлы на части

Забыли пароль администратора

Если вы забыли пароль администратора:

1. Остановите аддон Filebrowser
2. Удалите файл базы данных /data/filebrowser.db
3. Запустите аддон снова
4. Войдите с учётными данными по умолчанию (admin/admin)
5. Срочно измените пароль!

Рекомендации по использованию

Краткий справочник

Параметры по умолчанию

• Порт: 8080
• Пользователь: admin
• Пароль: admin
• База данных: /data/filebrowser.db

Полезные пути

• Шары: /share
• Конфигурации: /config
• Аддоны: /addons
• Резервные копии: /backup
• Media: /media

Документация

Более подробную информацию о Filebrowser можно найти на официальном сайте:

• Официальная документация Filebrowser
• Репозиторий на GitHub