Перейти к содержимому

Статья 63 из 141

Гайды

Частые ошибки Docker на VPS и как их исправить

Установка: Docker на VPS. Несколько сервисов вместе: Docker Compose.

Первое правило: почти любую проблему с контейнером объясняют его логи.

Окно терминала
docker ps -a # все контейнеры и их статус
docker logs --tail 100 ИМЯ # последние строки лога
docker compose logs -f # логи всех сервисов проекта

Вы запускаете docker не от root, а пользователь не входит в группу docker.

Окно терминала
usermod -aG docker ИМЯ_ПОЛЬЗОВАТЕЛЯ

После этого выйдите из SSH и войдите снова. Учтите: группа docker фактически даёт права root на сервере.

Служба Docker не запущена.

Окно терминала
systemctl status docker
systemctl enable --now docker

Если служба не стартует, причина в журнале: journalctl -u docker -n 50. Частый случай — ошибка в /etc/docker/daemon.json, например лишняя запятая.

Bind for 0.0.0.0:80 failed: port is already allocated

Порт уже занят другим контейнером или службой на сервере.

Окно терминала
ss -tulpn | grep ':80'
docker ps --format '{{.Names}} {{.Ports}}'

Освободите порт или поменяйте левую часть в ports:, например "8080:80". Частая причина — Nginx, установленный на самом сервере, уже занимает 80 и 443.

Закончилось место на диске. Docker быстро копит старые образы, остановленные контейнеры и кеш сборки.

Окно терминала
df -h
docker system df

Очистка неиспользуемых данных:

Окно терминала
docker system prune

Команда удалит остановленные контейнеры, неиспользуемые сети, образы без тегов и кеш сборки. Добавьте -a, чтобы удалить и все образы, которые не использует ни один контейнер. Тома с данными prune не трогает, если не указать --volumes. С --volumes будьте осторожны: так можно удалить базы данных.

По умолчанию Docker хранит логи контейнеров без ограничения. Ограничьте их в /etc/docker/daemon.json:

{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}
Окно терминала
systemctl restart docker

Настройка действует на контейнеры, созданные после перезапуска. Пересоздайте старые: docker compose up -d --force-recreate.

Подробнее про место на диске: сервер тормозит.

В docker ps статус Restarting. Приложение внутри падает сразу после старта, а политика restart поднимает его снова.

Окно терминала
docker logs --tail 50 ИМЯ

Типичные причины:

  • нет обязательной переменной окружения или файла .env;
  • неверный путь в volumes:, и приложение не находит конфиг;
  • база данных ещё не запустилась, а приложение уже пытается подключиться;
  • не хватает памяти: проверьте dmesg | grep -i oom.
exec /usr/local/bin/docker-entrypoint.sh: exec format error

Образ собран под другую архитектуру процессора, например ARM (Raspberry Pi, Mac на Apple Silicon), а сервер работает на x86-64. Используйте образ для linux/amd64 или соберите его с флагом:

Окно терминала
docker build --platform linux/amd64 -t myapp .

Docker Hub ограничивает количество скачиваний образов без входа в аккаунт. Войдите в бесплатный аккаунт Docker Hub, и лимит вырастет:

Окно терминала
docker login

Контейнер не видит интернет или другие контейнеры

Заголовок раздела «Контейнер не видит интернет или другие контейнеры»
  • Контейнеры в одном docker-compose.yml обращаются друг к другу по имени сервиса, а не по localhost. Например, DB_HOST=postgres.
  • localhost внутри контейнера — это сам контейнер, а не сервер.
  • Если из контейнера не открываются сайты, проверьте DNS: docker run --rm alpine nslookup google.com.

Порт контейнера открыт в интернет, хотя UFW закрыт

Заголовок раздела «Порт контейнера открыт в интернет, хотя UFW закрыт»

Docker публикует порты в обход UFW. Если сервис не должен быть доступен снаружи (база, Redis, панель за Nginx), публикуйте его на локальный адрес:

ports:
- "127.0.0.1:5432:5432"

Подробно: как проверить порт.

Ошибка Первое действие
permission denied ... docker.sock usermod -aG docker, перезайти
Cannot connect to the Docker daemon systemctl enable --now docker
port is already allocated ss -tulpn, сменить порт
no space left on device docker system df, docker system prune
Статус Restarting docker logs
exec format error образ под linux/amd64
toomanyrequests docker login