Hur man deployar en Docker Compose-stack på en VPS

Docker Compose beskriver en flercontainer-stack i en fil och kör den med ett kommando. Detta är deploy-guiden; installera Docker först om du inte gjort det. För en AI-agent-specifik stack (agent + vektor-DB + Redis), se docker-compose för AI-agenter.

1. En stack: app + databas + reverse proxy

# /opt/stack/docker-compose.yml
services:
  app:
    image: your/app:latest
    restart: unless-stopped
    env_file: [.env]
    depends_on: [db]
    # no ports: — reached only through the proxy below

  db:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes: ["pg:/var/lib/postgresql/data"]   # internal only

  caddy:                                        # HTTPS automatically
    image: caddy:2
    restart: unless-stopped
    ports: ["80:80", "443:443"]                 # the only public entrypoint
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data

volumes: { pg: {}, caddy_data: {} }

Hemligheter bor i .env, aldrig i compose-filen:

# /opt/stack/.env  (chmod 600, git-ignored)
DB_PASSWORD=a-long-random-string

En minimal Caddyfile proxar din domän till appen och hämtar HTTPS på egen hand:

app.yourdomain.com {
  reverse_proxy app:8080
}

2. Kör upp den

cd /opt/stack
docker compose up -d
docker compose ps
docker compose logs -f app

restart: unless-stopped på varje tjänst + Docker aktiverat vid uppstart = stacken kommer tillbaka av sig själv efter en omstart.

3. Vardagskommandon

docker compose pull && docker compose up -d   # update images
docker compose down                            # stop the stack
docker compose restart app                     # restart one service

Den del folk gör fel: exponerade portar

Docker publicerar portar via iptables, så en container med ports: ["5432:5432"] är nåbar från internet även bakom en UFW-brandvägg du trodde var stängd. Publicera bara den publika ingången (proxyn på 80/443); håll databaser och cachar på compose-nätverket eller bundna till 127.0.0.1. Allt som serverar webbtrafik behöver ett plan med dedikerad IP; kombinera med en UFW-brandvägg.

För en hel stack bakom en IP, se självhosta flera tjänster. Root på ungefär en minut, NVMe, ingen KYC, betala i krypto.