Быстрый старт
Основной сценарий: один администратор подключает уже работающий Samba-сервер по SSH. Панель устанавливается из готового Docker-образа, Nginx предоставляет HTTPS.
Что подготовить
- Машину с Docker Engine, Docker Compose и Git для получения файлов поставки.
- DNS-имя панели и TLS-сертификат с полной цепочкой и приватным ключом. Браузер должен доверять сертификату; имя в URL должно входить в сертификат.
- SSH-адрес и порт Samba-сервера, доступные из контейнера панели, и SSH-реквизиты администратора по инструкции подготовки сервера.
- Публичный SSH-ключ сервера и SHA-256 отпечаток, сверенные через независимый доверенный административный канал по инструкции доверия.
JDK, Maven и npm на машине установки не нужны. Установка панели не устанавливает Samba на удалённом сервере и не меняет его SSH-настройки.
Установка и первое подключение
- Получите файлы поставки и подготовьте
.env, TLS иknown_hostsпо разделу настройки production Compose. Выберите конкретный опубликованный тег образа или digest вместоlatest. - Запустите панель для существующего сервера
и проверьте готовность контейнеров. По умолчанию HTTPS слушает только Docker-хост
на
127.0.0.1:8443; доступ с другой машины требует явно выбранного адреса и разрешённого сетевого доступа, описанных там же. - Откройте HTTPS-адрес панели с
/ui/. В форме «Подключение к серверу» укажите SSH-хост, порт (кнопка «Порт: 22»), пользователя и пароль либо содержимое приватного ключа. Это реквизиты Linux/SSH, а не пароль Samba/SMB и не новая учётная запись панели. Для ключа используйте поддерживаемый формой ключ без passphrase и защитите его на машине оператора. - Нажмите «Подключиться». Успешный вход открывает панель с обзором сервера. Проверьте статус Samba и раздел общих папок; пустой список допустим, если ресурсы ещё не созданы. Создание первого ресурса выполняйте только после проверки, что подключён нужный сервер.
Адрес браузера и SSH-хост различаются: localhost в форме означает контейнер панели,
а не компьютер с браузером. Таблица адресов и разбор отказов находятся в
production-инструкции.
Неизвестный или изменённый ключ блокирует вход; не принимайте показанный отпечаток без
независимого подтверждения.
Если отдельного Samba-сервера ещё нет, используйте дополнительный полный стек с Samba. Для разработки из исходников см. сборку и поставки и Docker Sandbox.
После первого подключения
- Создайте локальных пользователя и группу, если нужных записей ещё нет.
- Настройте отдельный ресурс и ознакомьтесь с изменениями прав при сохранении.
- Проверьте доступ с SMB-клиента для разрешённого и постороннего пользователя.
- Перед изменением конфигурации убедитесь, что есть нужные резервные копии.