Как подключиться к терминалу контейнера Docker в Synology

Если вам нужно подключиться к консоли контейнера Docker на Synology, то для этого есть два способа, которые я опишу в этой заметке.

Частенько меня спрашивали в комментариях к видео роликам или статьям как получить доступ root в консоли контейнера Docker на Synology. Особенно часто такие вопросы были после статьи Установка и настройка ProxMox Backup Server на Synology в Docker.

Через графический интерфейс Synology

1. Откройте Container Manager.
2. Перейдите на вкладку “Контейнер”.
3. Выберите нужный контейнер и нажмите “Действие”.
4. Перейдите на вкладку “Открыть терминал”.
5. Нажмите “Создать”, чтобы запустить терминал (обычно sh или bash).
6. Теперь вы можете вводить команды внутри контейнера.

Хочу отметить, что такой способ дает доступ к командной строке контейнера из под пользователя root без знания пароля от этого root пользователя.

Через SSH (командная строка)

Как подключиться по ssh к Synology подробно описано тут: Как включить ssh на Synology NAS

Если вам нужен более гибкий доступ (например, через docker exec), подключитесь к Synology по SSH:

1. Включите SSH в DSM:
   Панель управления → Терминал и SNMP → Включить службу SSH.
2. Подключитесь к Synology через SSH (используйте admin или пользователя с правами sudo):

Откройте Power Shell на Windows или терминал на MacOs или Linux и подключитесь к Synology:

ssh username@ip_адрес_synology

Перейдите в режим sudo -i (или используйте sudo перед командами):

sudo -i

Проверьте список запущенных контейнеров:

docker ps

Подключитесь к контейнеру с помощью docker exec:

docker exec -it имя_контейнера /bin/sh

или (если доступен bash):

docker exec -it имя_контейнера /bin/bash

Например, для контейнера pbs команда будет выглядеть так: docker exec -it pbs /bin/bash

Примечания

• В некоторых контейнерах может не быть /bin/bash (используйте /bin/sh).
• Если Docker требует sudo, убедитесь, что ваш пользователь входит в группу administratorsили docker.

Если у вас нет доступа к SSH, используйте графический интерфейс Docker в DSM описанный выше.

Теперь вы знаете как подключиться к терминалу контейнера Docker в Synology

Ограничения и последствия

Контейнеры Docker не предназначены для ручного изменения (например, через apt upgrade, apt update или yum update) внутри запущенного контейнера.

Если вы вносите изменения в контейнер Docker через терминал (docker exec -it или через интерфейс Synology DSM), важно понимать последствия:

1. Когда изменения сохраняются, а когда нет?

• Изменения внутри контейнера временны.
  • Если контейнер перезапустится (docker restart или перезагрузка системы), все изменения, сделанные вручную, исчезнут (если том или файлы не примонтированы извне).
  • Исключение: если изменения записаны в томы (volumes) (например, /config, /data), они сохранятся.

2. Возможные проблемы из-за изменений в терминале

• Сбой работы контейнера:
  • Если вы измените/удалите критичные файлы (например, конфиги в /etc или бинарные зависимости), контейнер может перестать запускаться.
  • Пример: удаление пакета python в контейнере с Python-приложением.
• Потеря данных:
  • Если данные хранятся внутри контейнера (а не в volume), они пропадут при пересоздании контейнера.
• Несоответствие состоянию образа:
  • Контейнер может начать вести себя нестабильно, если его состояние расходится с ожидаемым в образе (например, ручное изменение переменных окружения или прав файлов).
• Проблемы с обновлениями:
  • Если вы вручную обновили пакеты (например, apt-get upgrade), при следующем обновлении образа изменения могут быть перезаписаны.

3. Как безопасно вносить изменения?

• Для тестирования: Используйте docker exec, но помните, что изменения не сохранятся.
• Для постоянных изменений:
  • Монтируйте нужные директории как volumes (чтобы файлы сохранялись на хосте).
  • Измените конфигурацию через переменные окружения (если приложение их поддерживает).

Итог

• Изменения в терминале контейнера — быстрый способ отладки, но ненадежный для постоянных изменений.
• Для долговечных изменений: используйте volumes  или настройки контейнера в Synology DSM.
• Риски: поломка контейнера, потеря данных при перезапуске, конфликты при обновлении.