К содержимому

docker login на Ubuntu 24.04: вход в registry и проверка

Команда docker login сохраняет учётные данные для registry, из которого Docker будет тянуть и куда будет пушить образы. На Ubuntu 24.04 вход выполняется из терминала, а результат проверяется командой docker pull или docker push. Для Docker Hub вместо пароля аккаунта нужен personal access token.

Руководство Docker 3 мин чтения

01Проверьте, что Docker установлен

На сервере уже должен работать Docker Engine. Убедитесь в этом одной командой: она печатает версию клиента и сервера. Если вывод содержит command not found, установите Docker по отдельной инструкции и вернитесь к этому шагу.

bash
docker version

02Проверьте права на сокет Docker

Пользователь, от имени которого вы выполняете вход, должен иметь доступ к /var/run/docker.sock. Если docker version завершается ошибкой permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock, добавьте пользователя в группу docker и войдите в систему заново. Группа docker даёт права root на сервере, поэтому не добавляйте в неё посторонних.

bash
sudo usermod -aG docker $USER
newgrp docker

03Создайте токен доступа в Docker Hub

С 2023 года Docker Hub не принимает пароль аккаунта в docker login: нужен personal access token. Откройте в браузере Account settings, раздел Security, и создайте новый токен с правами на чтение и запись. Скопируйте токен сразу: второй раз он не показывается. Для приватного registry токен выдаёт его администратор, а логин и адрес registry уточняются у него же.

04Выполните docker login

Запустите команду без аргументов: Docker спросит имя пользователя и пароль или токен. В поле пароля вставьте personal access token. Для Docker Hub адрес registry можно не указывать, по умолчанию используется docker.io.

bash
docker login

05Войдите в приватный registry

Если образы хранятся не в Docker Hub, передайте адрес registry первым аргументом. Адрес указывают без схемы https://, например registry.example.com. Docker попробует подключиться по HTTPS и сохранит учётные данные для этого хоста отдельно от Docker Hub.

bash
docker login registry.example.com

06Передайте токен без интерактивного ввода

В скриптах и CI пароль или токен передают через стандартный ввод с флагом --password-stdin. Так токен не попадает в историю команд и в список процессов. Флаг --password в открытом виде использовать не нужно: Docker предупреждает о небезопасности такого способа.

bash
echo "$DOCKER_TOKEN" | docker login --username example --password-stdin

07Проверьте, что вход выполнен

Команда docker login при успехе печатает Login Succeeded. Учётные данные сохраняются в файле ~/.docker/config.json для текущего пользователя. Проверить вход надёжнее всего попыткой скачать приватный образ: если доступ есть, docker pull завершится без ошибки авторизации.

bash
docker pull example/app:latest

08Выйдите из registry при необходимости

Команда docker logout удаляет сохранённые учётные данные для указанного registry. Без аргументов она выходит из Docker Hub. После выхода docker pull приватного образа вернёт ошибку unauthorized: authentication required.

bash
docker logout
docker logout registry.example.com

Частые ошибки

  • В docker login вводят пароль от аккаунта Docker Hub и получают ошибку авторизации.

    Docker Hub принимает только personal access token. Создайте токен в разделе Security настроек аккаунта и вставьте его в поле пароля.

  • После sudo usermod -aG docker $USER команда docker login всё равно падает с permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.

    Новая группа применяется только после повторного входа. Выйдите из сессии и зайдите снова либо выполните newgrp docker в текущем терминале.

  • Токен передан флагом --password и остался в истории shell и в выводе ps.

    Передавайте токен через стандартный ввод: echo "$DOCKER_TOKEN" | docker login --username example --password-stdin. Удалите старую строку из истории команд.

  • Вход выполнен под одним пользователем, а docker pull запускают под другим или через sudo, и Docker не находит учётные данные.

    Файл ~/.docker/config.json хранится в домашнем каталоге пользователя. Выполняйте docker login и docker pull от одного и того же пользователя.

Deploykin

Как это делается в Deploykin

В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Где Docker хранит учётные данные после docker login?

В файле ~/.docker/config.json текущего пользователя. Если настроен credential helper, там хранится только имя помощника, а сам токен лежит в его хранилище.

Почему docker login не принимает пароль Docker Hub?

Docker Hub отключил вход по паролю аккаунта. Нужен personal access token, созданный в разделе Security настроек аккаунта.

Как выполнить docker login в скрипте без ввода с клавиатуры?

Передайте токен через стандартный ввод: echo "$DOCKER_TOKEN" | docker login --username example --password-stdin. Флаг --password для этого не подходит.

Что делать при ошибке permission denied while trying to connect to the Docker daemon socket?

Добавьте пользователя в группу docker командой sudo usermod -aG docker $USER и войдите в систему заново. Проверьте доступ командой docker version.

Ещё по теме

Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.