docker login на Ubuntu 24.04: вход в registry и проверка
Команда docker login сохраняет учётные данные для registry, из которого Docker будет тянуть и куда будет пушить образы. На Ubuntu 24.04 вход выполняется из терминала, а результат проверяется командой docker pull или docker push. Для Docker Hub вместо пароля аккаунта нужен personal access token.
01Проверьте, что Docker установлен
На сервере уже должен работать Docker Engine. Убедитесь в этом одной командой: она печатает версию клиента и сервера. Если вывод содержит command not found, установите Docker по отдельной инструкции и вернитесь к этому шагу.
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 на сервере, поэтому не добавляйте в неё посторонних.
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.
docker login
05Войдите в приватный registry
Если образы хранятся не в Docker Hub, передайте адрес registry первым аргументом. Адрес указывают без схемы https://, например registry.example.com. Docker попробует подключиться по HTTPS и сохранит учётные данные для этого хоста отдельно от Docker Hub.
docker login registry.example.com
06Передайте токен без интерактивного ввода
В скриптах и CI пароль или токен передают через стандартный ввод с флагом --password-stdin. Так токен не попадает в историю команд и в список процессов. Флаг --password в открытом виде использовать не нужно: Docker предупреждает о небезопасности такого способа.
echo "$DOCKER_TOKEN" | docker login --username example --password-stdin
07Проверьте, что вход выполнен
Команда docker login при успехе печатает Login Succeeded. Учётные данные сохраняются в файле ~/.docker/config.json для текущего пользователя. Проверить вход надёжнее всего попыткой скачать приватный образ: если доступ есть, docker pull завершится без ошибки авторизации.
docker pull example/app:latest
08Выйдите из registry при необходимости
Команда docker logout удаляет сохранённые учётные данные для указанного registry. Без аргументов она выходит из Docker Hub. После выхода docker pull приватного образа вернёт ошибку unauthorized: authentication required.
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 docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
- Руководство · Docker Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы