Du har en Debian-server redo för en webbplats eller testmiljö, men Docker finns inte på plats ännu. Den smidigaste vägen är vanligtvis Dockers eget APT-arkiv, men först behöver du kontrollera Debian-versionen och om en annan Docker-installation redan finns.
Installera från Dockers APT-arkiv och kontrollera behörigheterna
- Stödda versioner: Debian 13 Trixie och Debian 12 Bookworm.
- Installationspaket: Docker Engine, CLI, containerd, Buildx och Compose-plugin.
- Kontroll: kör
sudo docker run hello-worldefter installationen. - Säkerhet: medlemskap i gruppen
dockerger root-liknande behörighet.
Kontrollera Debian-versionen innan du lägger till arkivet
En felaktig distributionskod ger ofta ett APT-fel som ser ut som ett nyckelproblem. Börja därför med . /etc/os-release && echo "$VERSION_CODENAME" och kontrollera arkitekturen med dpkg --print-architecture.
Dockers installationsanvisning anger stöd för Debian 13 Trixie och Debian 12 Bookworm. Arkitekturerna som listas är amd64, armhf, arm64 och ppc64el. Använder du Kali eller Debian Testing kan du behöva ange motsvarande Debian-kodnamn manuellt i arkivkonfigurationen. Följ Dockers installationsanvisning för Debian för detaljer som hör till just din plattform.
Det här är särskilt användbart på små ARM-servrar och Raspberry Pi-liknande system: kontrollera arkitekturen innan du följer kommandon som råkar vara skrivna för amd64. Annars kan APT hitta rätt paketnamn men fel paketarkitektur.
Välj en Docker-installation och rensa bort paketkonflikter
Namnen liknar varandra, men paketen kommer från olika underhållare. Debian erbjuder paketet docker.io, medan Dockers eget arkiv erbjuder docker-ce; enligt Debians Docker-wikisida är det två distributionsvägar för Docker.
Jag föredrar Dockers APT-arkiv när en server ska få Docker-uppdateringar via samma leverantörs arkiv och Compose-plugin ska installeras ihop med Engine. Om du redan har Debianpaketet installerat bör du ta bort det före bytet, men avinstallera inte slentrianmässigt på en maskin med befintliga containrar eller data.
sudo apt remove docker.io docker-compose docker-doc docker-buildx podman-docker containerd runcKommandot tar bort paket, men Dockers dokumentation påpekar att bilder, containrar och volymer i /var/lib/docker/ inte automatiskt raderas vid avinstallation. Kontrollera därför vad servern redan kör innan du ändrar installationen.
Installera Docker Engine med APT
När gamla paket är hanterade kan du lägga till den signerade nyckeln och arkivet. Nyckeln sparas separat i /etc/apt/keyrings, och raden Signed-By begränsar vilken nyckel APT använder för det här arkivet.
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/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 <Paketlistan installerar Engine och kommandoradsverktygen, tillsammans med Buildx för moderna byggen och Compose-plugin för kommandot docker compose. Det gamla fristående kommandot docker-compose är inte det kommando som den här installationsmetoden ställer in.
Om apt update visar ett fel om Signed-By kan en äldre Docker-källfil ligga kvar från ett tidigare försök. Kontrollera filer under /etc/apt/sources.list.d/ och ta bort eller rätta den dubbla arkivposten innan du kör uppdateringen igen.
Verifiera tjänsten och välj rätt åtkomstnivå
En lyckad paketinstallation räcker inte som test; kontrollera att daemonen kör och att den kan starta en container. Kör kommandona i ordning:
sudo systemctl status docker
sudo docker run hello-world
docker compose versionOm tjänsten inte är aktiv kan du starta den med sudo systemctl start docker. Testbilden hello-world laddas ned och avslutar sedan containern, vilket bekräftar att både Docker-klienten och daemonen fungerar.
Utan sudo får du normalt ett behörighetsfel. Du kan lägga till kontot i gruppen docker, men det är lätt att misstolka som en harmlös bekvämlighet: Dockers anvisning om efterinstallation på Linux varnar för att gruppen ger root-nivåprivilegier. På en delad server skulle jag behålla sudo eller undersöka rootless-läge i stället.
Felsök efter symptom, inte genom att installera om
När installationen fastnar är felmeddelandet ofta en ledtråd om vilket lager som bråkar. Börja med den synliga situationen och undvik att radera Docker-data innan du vet vad som finns på maskinen.
| Situation | Trolig orsak | Gör så här |
|---|---|---|
apt update ger 404 från Docker-arkivet |
Fel kodnamn eller Debian-version som inte finns i den konfigurerade distributionsvägen | Kontrollera VERSION_CODENAME och jämför med Debian-versionerna Docker anger. |
APT rapporterar olika värden för Signed-By |
En gammal och en ny arkivpost pekar på olika nyckelfiler | Sök efter dubbla Docker-poster i APT:s källfiler och behåll en korrekt konfiguration. |
docker run ger behörighetsfel |
Kommandot körs utan sudo och kontot saknar åtkomst till Docker-socketen |
Testa med sudo; lägg bara till gruppen docker om root-liknande åtkomst är acceptabel. |
| En publicerad containerport går att nå trots UFW-regler | Docker kan leda trafik förbi UFW:s vanliga filterkedjor | Granska portpublicering och brandväggsregler utifrån Dockers dokumentation om paketfiltrering och brandväggar. |
Portfallet är lätt att missa på en webbserver: ett publicerat portnummer kan bli nåbart även när UFW verkar blockera det. Begränsa publiceringen till nödvändiga portar och verifiera reglerna från nätverket som ska använda tjänsten.
Håll installationen enkel att uppdatera
För en vanlig Debian-server ger Dockers APT-arkiv en tydlig väg för både installation och uppgraderingar. När containrarna väl startar kan du bygga vidare med Compose, men låt inte en lyckad testcontainer bli enda kontrollen om maskinen också ska exponera en webbplats.
Min tumregel är enkel: använd rätt kodnamn, håll dig till en paketkälla och ge bara Docker-åtkomst till konton som kan ha root-privilegier. Då blir det betydligt lättare att förstå om nästa fel kommer från APT, daemonen, behörigheter eller nätverket.