Статья 63 из 141
Гайды
Частые ошибки Docker на VPS и как их исправить
Установка: Docker на VPS. Несколько сервисов вместе: Docker Compose.
Первое правило: почти любую проблему с контейнером объясняют его логи.
docker ps -a # все контейнеры и их статусdocker logs --tail 100 ИМЯ # последние строки логаdocker compose logs -f # логи всех сервисов проектаpermission denied while trying to connect to the Docker daemon socket
Заголовок раздела «permission denied while trying to connect to the Docker daemon socket»Вы запускаете docker не от root, а пользователь не входит в группу docker.
usermod -aG docker ИМЯ_ПОЛЬЗОВАТЕЛЯПосле этого выйдите из SSH и войдите снова. Учтите: группа docker фактически даёт права root на сервере.
Cannot connect to the Docker daemon
Заголовок раздела «Cannot connect to the Docker daemon»Служба Docker не запущена.
systemctl status dockersystemctl enable --now dockerЕсли служба не стартует, причина в журнале: journalctl -u docker -n 50. Частый случай — ошибка в /etc/docker/daemon.json, например лишняя запятая.
port is already allocated
Заголовок раздела «port is already allocated»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.
no space left on device
Заголовок раздела «no space left on device»Закончилось место на диске. Docker быстро копит старые образы, остановленные контейнеры и кеш сборки.
df -hdocker 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 format error
Заголовок раздела «exec format error»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 .toomanyrequests: You have reached your pull rate limit
Заголовок раздела «toomanyrequests: You have reached your pull rate limit»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 |