No KYC VPS
Инструкции12 окт. 20267 мин чтенияАвтор: команда No KYC VPS

Как установить Docker и Docker Compose на VPS с Ubuntu

Установите Docker Engine из официального репозитория, запускайте его без sudo, запустите первый сервис Compose и избегайте ловушки брандмауэра, из-за которой открываются порты.

Docker позволяет запускать базы данных, веб-приложения и инструменты в изолированных контейнерах, поэтому установка чего-то нового никогда не нарушит работу остального сервера. Это руководство устанавливает Docker Engine и Docker Compose на Ubuntu и запускает первый настоящий сервис.

Окно терминала на VPS с командами для установки Docker на VPS с Ubuntu, начиная с «sudo apt update»
Примерно такие команды вы будете выполнять на своём сервере в этом руководстве.

1. Установка из репозитория Docker

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Проверьте установку командой sudo docker run hello-world.

2. Запуск Docker без sudo

sudo usermod -aG docker $USER
newgrp docker

Участники группы docker фактически обладают правами root на машине, поэтому добавляйте только тех пользователей, которым доверяете.

3. Ваш первый файл Compose

Создайте папку и файл compose.yaml, который запускает инструмент мониторинга Uptime Kuma:

mkdir -p ~/kuma && cd ~/kuma
cat > compose.yaml <<'EOF'
services:
  kuma:
    image: louislam/uptime-kuma:1
    restart: unless-stopped
    ports:
      - "127.0.0.1:3001:3001"
    volumes:
      - ./data:/app/data
EOF
docker compose up -d

Привязка к 127.0.0.1 не выставляет порт в публичный интернет. Поставьте перед ним обратный прокси, например Nginx или Caddy, когда захотите обращаться к нему извне.

Повседневные команды

  • docker ps показывает список запущенных контейнеров.
  • docker compose logs -f следит за логами.
  • docker compose pull && docker compose up -d обновляет до более новых образов.
  • docker system prune удаляет неиспользуемые образы и остановленные контейнеры.
The steps of this guide in order: 1. 1. Install from Docker's repository; 2. 2. Run Docker without sudo; 3. 3. Your first Compose file; 4. Everyday commands; 5. A security warning about firewalls; 6. What to run next
Шаги этого руководства по порядку.

Предупреждение о безопасности брандмауэров

Docker записывает собственные правила iptables. Порт, опубликованный как "8080:80", может быть доступен из интернета, даже если UFW сообщает, что он заблокирован. Публикуйте только то, что должно быть общедоступным, привязывайте приватные сервисы к 127.0.0.1 и проверяйте снаружи сканером портов.

Следите за логами и диском

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

{
  "log-driver": "json-file",
  "log-opts": { "max-size": "10m", "max-file": "3" }
}

Перезапустите Docker командой sudo systemctl restart docker. Настройка действует для контейнеров, созданных после этого. Расход диска можно в любой момент проверить командой docker system df.

Устранение неполадок

  • Permission denied на сокете Docker. Ваш пользователь ещё не в группе docker, либо вы не входили заново после добавления.
  • Контейнер постоянно перезапускается. Прочитайте его логи командой docker logs имя-контейнера. Обычно причина — неверная настройка или отсутствующий файл.
  • Порт уже занят. Его использует другая программа. Найдите её командой sudo ss -tlnp и выберите другой порт.
  • Закончилось место. Выполните docker system df, затем удалите неиспользуемые данные командой docker system prune.

Убедитесь, что Docker запускается при загрузке

В Ubuntu служба включается автоматически. Проверьте командой systemctl is-enabled docker и при необходимости включите через sudo systemctl enable --now docker. Контейнеры с restart: unless-stopped вернутся после перезагрузки.

Что запускать дальше

Среди популярных приложений для самостоятельного хостинга Nextcloud, Vaultwarden, Gitea, Plausible, n8n и Jellyfin. Полный пример смотрите в нашем руководстве по самостоятельному хостингу Nextcloud.

Частые вопросы

Нужно ли отдельно устанавливать Docker Compose?

Нет. Пакет docker-compose-plugin, установленный выше, добавляет команду docker compose.

Безопасно ли добавлять пользователя в группу docker?

Только доверенных пользователей, потому что члены группы могут получить root-доступ к машине.

Как обновить контейнер?

В папке с файлом compose выполните docker compose pull, а затем docker compose up -d.