Installare Docker Engine e Docker Compose
Installa Docker Engine e Docker Compose dal repository ufficiale su Debian o Ubuntu: utenti, log, porte, aggiornamenti, backup e buone pratiche.
In questa pagina
Questa guida ti spiega come installare Docker Engine e il plugin Docker Compose dal repository ufficiale di Docker, poi come preparare il tuo server per un uso in produzione: permessi degli utenti, rotazione dei log, esposizione delle porte, aggiornamenti e backup.
Ordina un server
Per ospitare i tuoi container, HostMyServers offre diverse soluzioni:
Prerequisiti
- Un server a 64 bit con Debian 12/13 o Ubuntu 22.04/24.04
- Un accesso SSH con
rooto con un utentesudo
Porte: Docker non ha bisogno di alcuna porta in ingresso. Apri solo le porte delle applicazioni che pubblichi e non esporre mai l'API di Docker (2375 o 2376) su Internet: accedervi equivale a controllare il server.
Passo 1: rimuovere i pacchetti in conflitto
I pacchetti Docker forniti dalla distribuzione possono entrare in conflitto con quelli ufficiali:
sudo apt update
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc 2>/dev/null | cut -f1)Le eventuali immagini e i volumi in /var/lib/docker non vengono eliminati da questo comando.
Passo 2: aggiungere il repository ufficiale
Questi comandi vanno bene sia per Debian sia per Ubuntu, perché leggono il sistema da /etc/os-release:
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
. /etc/os-release
sudo curl -fsSL "https://download.docker.com/linux/$ID/gpg" -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/$ID
Suites: ${UBUNTU_CODENAME:-$VERSION_CODENAME}
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt updatePasso 3: installare Docker
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker containerdPasso 4: verificare l'installazione
sudo systemctl status docker
docker --version
docker compose version
sudo docker run --rm hello-worldIl messaggio Hello from Docker! conferma che il motore può scaricare un'immagine e avviare un container.
Passo 5: autorizzare un utente
Per usare Docker senza sudo, aggiungi il tuo utente al gruppo docker, poi disconnettiti e riconnettiti:
sudo usermod -aG docker $USERVerifica poi:
docker run --rm hello-worldPasso 6: configurare i log e il demone
Per impostazione predefinita, il driver json-file non limita la dimensione dei log, che possono finire per riempire il disco. Crea /etc/docker/daemon.json:
sudo nano /etc/docker/daemon.json{
"log-driver": "local",
"log-opts": {
"max-size": "10m",
"max-file": "3"
},
"live-restore": true
}| Opzione | Effetto |
|---|---|
log-driver: local |
Formato di log compatto, con rotazione |
max-size, max-file |
Fino a 3 file da 10 MB per container |
live-restore |
I container continuano a funzionare se il demone si ferma |
Convalida il file, poi riavvia Docker. Questo riavvio interrompe i container in esecuzione: fallo preferibilmente prima di distribuire le tue applicazioni.
sudo dockerd --validate --config-file=/etc/docker/daemon.json
sudo systemctl restart docker
docker info --format '{{.LoggingDriver}} {{.LiveRestoreEnabled}}'Il driver dei log si applica solo ai nuovi container. Ricrea i container esistenti per beneficiarne, per esempio con docker compose up -d --force-recreate.
Passo 7: controllare le porte pubblicate
Se sul server è in esecuzione un reverse proxy, pubblica le tue applicazioni solo in locale:
ports:
- "127.0.0.1:8080:80"Puoi anche rendere l'indirizzo locale il comportamento predefinito, aggiungendo queste chiavi in /etc/docker/daemon.json:
{
"ip": "127.0.0.1",
"default-network-opts": {
"bridge": {
"com.docker.network.bridge.host_binding_ipv4": "127.0.0.1"
}
}
}Uniscile al file del passo 6, convalidalo, poi riavvia Docker. Una porta destinata al pubblico dovrà allora essere indicata esplicitamente, per esempio "0.0.0.0:443:443".
Passo 8: avviare un primo progetto Compose
Crea una cartella per il progetto:
sudo mkdir -p /opt/myapp
sudo chown "$USER": /opt/myapp
cd /opt/myapp
nano compose.yamlservices:
web:
image: nginx:1.30-alpine
restart: unless-stopped
ports:
- "127.0.0.1:8080:80"
volumes:
- web-data:/usr/share/nginx/html
healthcheck:
test: ["CMD", "wget", "-qO-", "http://127.0.0.1/"]
interval: 30s
timeout: 5s
retries: 3
volumes:
web-data:Avvia e poi verifica:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=20 web
curl -I http://127.0.0.1:8080Per pubblicare questa applicazione in HTTPS, metti davanti ad essa un reverse proxy. Puoi partire dalla guida Installare Nginx e PHP-FPM e dalla guida Let's Encrypt.
Comandi utili
| Comando | Descrizione |
|---|---|
docker ps -a |
Elencare i container |
docker compose logs -f |
Seguire i log del progetto |
docker compose restart |
Riavviare i servizi |
docker compose down |
Fermare ed eliminare i container, conservando i volumi |
docker system df |
Mostrare lo spazio utilizzato |
Aggiornamenti
Docker Engine
sudo apt update
sudo apt install --only-upgrade docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --versionlive-restore copre solo gli aggiornamenti correttivi. Per una versione maggiore, prevedi un'interruzione dei tuoi container e consulta le note di rilascio di Docker.
Immagini delle applicazioni
Modifica il tag in compose.yaml se lo fissi, poi:
cd /opt/myapp
docker compose pull
docker compose up -d
docker image pruneBackup
Fai il backup almeno dei tuoi file Compose, dei tuoi file .env e dei tuoi volumi. I volumi si trovano in /var/lib/docker/volumes, ma è meglio archiviarli tramite un container temporaneo. Il nome reale del volume si ottiene con docker volume ls:
cd /opt/myapp
mkdir -p backups
docker compose stop web
docker run --rm -v myapp_web-data:/data:ro -v "$PWD/backups":/backup alpine:3 tar czf /backup/web-data.tar.gz -C /data .
docker compose start webPer ripristinare l'archivio in un volume:
docker compose stop web
docker run --rm -v myapp_web-data:/data -v "$PWD/backups":/backup:ro alpine:3 tar xzf /backup/web-data.tar.gz -C /data
docker compose start webPer un database, preferisci un'esportazione con lo strumento del motore (mariadb-dump, pg_dump, ecc.). Copia poi i tuoi backup fuori dal server.
Buone pratiche in produzione
- Fissa una versione precisa dell'immagine anziché
latest - Definisci
restart: unless-stoppede unhealthcheckper i tuoi servizi - Pubblica il minor numero possibile di porte, e in locale dietro un reverse proxy quando possibile
- Conserva i tuoi segreti in un file
.envprotetto (chmod 600 .env), fuori da Git - Non usare
privileged: truee non montare/var/run/docker.socksenza necessità - Tieni sotto controllo lo spazio su disco con
docker system df - Testa regolarmente il ripristino dei tuoi backup
In caso di problemi
permission denied su /var/run/docker.sock
Il tuo utente non è ancora preso in considerazione nel gruppo docker. Verifica con id, poi riconnettiti via SSH.
Conflicting values set for option Signed-By
Resta una vecchia configurazione del repository Docker, spesso /etc/apt/sources.list.d/docker.list. Dopo aver controllato il suo contenuto, eliminala:
sudo rm /etc/apt/sources.list.d/docker.list
sudo apt updateCannot connect to the Docker daemon
sudo systemctl status docker
sudo journalctl -u docker -n 50 --no-pager
sudo dockerd --validate --config-file=/etc/docker/daemon.jsonUn errore di sintassi in daemon.json impedisce l'avvio del servizio.
port is already allocated o address already in use
Un altro container o servizio usa questa porta. Individualo con sudo ss -ltnp | grep ':8080 ' e docker ps, poi cambia la porta lato server.
no space left on device
df -h
docker system df
docker image prune
docker builder pruneUsa docker volume prune solo dopo aver verificato che i volumi interessati non contengano più dati utili.
toomanyrequests durante un download
Il limite di download di Docker Hub è stato raggiunto. Attendi, oppure accedi al tuo account con docker login.
docker-compose: command not found
Il plugin attuale si usa con uno spazio: docker compose.
Una porta resta accessibile nonostante UFW
È il comportamento normale delle porte pubblicate da Docker. Pubblica la porta su 127.0.0.1 oppure applica le restrizioni della guida Configurare UFW.