Distribuzione di applicazioni

Compose, pannelli per container e gestione degli aggiornamenti

In sintesi: Quando si gestiscono applicazioni multi-container su un VPS Linux, comandi docker run sparsi possono facilmente portare a parametri dimenticati, topologia di rete confusa e aggiornamenti disastrosi. La moderna distribuzione di container standardizza tag delle immagini, variabili di ambiente, volumi persistenti, reti e limiti di risorse in Docker Compose come Infrastructure as Code.

Redazione di VPSMap · Aggiornato il 2026-09-26 · 20 min di lettura · Versione solo testo

Quando si gestiscono applicazioni multi-container su un VPS Linux, l'uso diretto di comandi docker run sparsi può facilmente causare parametri dimenticati, una topologia di rete confusa e aggiornamenti disastrosi. La moderna distribuzione di container utilizza Docker Compose per definire tag delle immagini, variabili di ambiente, volumi persistenti, reti e limiti di risorse come Infrastructure as Code.

Focalizzato sull'alta disponibilità e sulla sicurezza dei dati nelle operazioni di produzione, questo articolo illustra l'organizzazione standardizzata delle directory di Compose, l'isolamento della rete interna, autorizzazioni più rigorose per i pannelli di gestione grafici e procedure di aggiornamento senza interruzioni e rollback di emergenza che tengono conto delle migrazioni del database. Utilizza inoltre le funzionalità della console dei principali provider cloud come BandwagonHost e DMIT per fornire indicazioni sulla risoluzione dei problemi di basso livello e sul disaster recovery operativo.


1. Standard di architettura: una directory per applicazione e stato isolato#

Per garantire la portabilità e la migrazione a freddo in pochi secondi, l'orchestrazione dei container a livello di host dovrebbe seguire il principio di una directory per stack di applicazioni. Si consiglia di standardizzare su /srv/stacks/<应用名> o /opt/stacks/<应用名> come percorso radice per l'isolamento.

testo
/opt/stacks/web-app/
├── compose.yaml          # 核心编排文件(Compose V2 规范)
├── .env                  # 敏感环境变量(权限 600,禁止提交至公开仓库)
├── config/               # 挂载至容器的应用专属静态配置文件
│   └── nginx.conf
└── data/                 # 宿主机绑定挂载的数据目录(非必要时优先使用命名卷)
    └── app-uploads/

Linee guida per la gestione di directory e credenziali#

  1. Convenzioni di denominazione aggiornate: i moderni plug-in Compose utilizzano coerentemente compose.yaml (o compose.yml) come file di configurazione predefinito; la vecchia riga di dichiarazione di primo livello version: '3.8'. Il comando è coerentemente docker compose (con uno spazio tra le parole), anziché il binario autonomo obsoleto docker-compose.
  2. Isola le credenziali di ambiente: i valori di configurazione dinamici come le password del database e i token API devono essere estratti nel file .env della stessa directory, con Compose che esegue automaticamente l'interpolazione delle variabili (${VARIABLE_NAME}). Per proteggere l'host, i permessi di questo file devono essere rigorosamente limitati:
    bash
    chmod 600 /opt/stacks/web-app/.env
    chown -R root:root /opt/stacks/web-app
  3. Confini del controllo di versione: Se si utilizza Git per tracciare la configurazione operativa, includere nel repository il modello .env.example e in .gitignore escludere rigorosamente .env e tutte le directory data/ che contengono l'effettivo stato aziendale.

2. Standard di orchestrazione di livello di produzione e isolamento della rete#

Mappare direttamente tutte le porte dei container su 0.0.0.0 dell'host rappresenta un grave rischio per la sicurezza di rete. Il demone Docker modifica direttamente le regole iptables del sistema e inserisce la catena DOCKER, aggirando le impostazioni UFW o firewalld del sistema. Una volta che un servizio di database o cache viene mappato esternamente, la sua porta risulta esposta direttamente alla rete Internet pubblica.

Quello che segue è un modello compose.yaml standard che integra una rete di applicazioni separata, limiti di rotazione dei log, vincoli di risorse e predisposizioni per un reverse proxy:

yaml
services:
  web:
    image: ghost:5-alpine
    container_name: production_blog_web
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    environment:
      database__client: mysql
      database__connection__host: db
      database__connection__user: ghost
      database__connection__password: ${MYSQL_PASSWORD}
      database__connection__database: ghost_prod
      url: https://example.com
    volumes:
      - blog_content:/var/lib/ghost/content
    ports:
      # 严格限制仅监听宿主机本地环回接口,交由外部 Nginx 或 Caddy 处理 TLS 与反代
      - "127.0.0.1:2368:2368"
    networks:
      - frontend_net
      - backend_net
    deploy:
      resources:
        limits:
          cpus: '1.50'
          memory: 1024M
    logging:
      driver: json-file
      options:
        max-size: "20m"
        max-file: "3"

  db:
    image: mariadb:10.11
    container_name: production_blog_db
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ghost_prod
      MYSQL_USER: ghost
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql
    # 绝不发布 ports,仅在内部网络被同栈应用发现
    networks:
      - backend_net
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "2"

volumes:
  blog_content:
    name: blog_app_content
  db_data:
    name: blog_app_db_data

networks:
  frontend_net:
    driver: bridge
  backend_net:
    driver: bridge

Considerazioni chiave sull'architettura#

  • Isolamento di rete a due livelli: Il container db si unisce esclusivamente a backend_net, eliminando del tutto la possibilità di comunicazione con la rete Internet pubblica; i container web utilizzano il DNS integrato di Compose e il nome del servizio db per risolvere e stabilire una connessione.
  • Progettazione per prevenire l'esaurimento del disco: Il driver di logging predefinito di Docker consente ai log stdout/stderr dei container di crescere senza limiti. Dichiarare esplicitamente nella configurazione max-size e max-file consente di imporre la rotazione dei log ed evitare che le istanze VPS di fascia bassa si blocchino a causa dell'esaurimento dello spazio su disco.
  • Fissare le versioni delle immagini: Non utilizzare mai direttamente in produzione quanto segue: :latest. Utilizzare immagini stabili con versioni principali esplicite o hash di build bloccati (come il ramo mariadb:10.11, alpine) per evitare di scaricare una build con modifiche incompatibili durante un riavvio imprevisto.

3. Verifica della distribuzione e flussi di lavoro dei comandi comuni#

Dopo aver configurato la struttura delle directory, seguire la sequenza standard: "controllo della sintassi $\to$ download dell'immagine $\to$ compilazione in background $\to$ verifica dello stato":

bash
# 1. 验证配置文件合法性与变量解析状态(不显示敏感数据)
docker compose config --quiet

# 2. 预先抓取所有编排中的镜像,降低上线中断时长
docker compose pull

# 3. 后台守护模式创建并启动容器
docker compose up -d

# 4. 检查服务健康状态与端口监听
docker compose ps

# 5. 持续观测业务输出以排查初始化异常
docker compose logs -f --tail=100 web

Durante la risoluzione dei problemi, ricorda: docker compose config farà sì che .env tutte le variabili interne siano completamente espanse. Quando condividi informazioni di debug con il tuo team o con un sistema di ticket di supporto, non incollare mai la configurazione completa non sanitizzata.


4. Scelta dei pannelli visivi (Portainer / 1Panel) e riduzione della loro superficie di attacco#

Alcuni team aggiungono pannelli leggeri di gestione dei container per semplificare la collaborazione o il monitoraggio. Tuttavia, è essenziale riconoscere che: Tutti i pannelli di gestione collegati a Docker sono essenzialmente processi con privilegi.

Confini di sicurezza del socket Docker#

Quasi tutti i pannelli di gestione visivi, come Portainer, devono montare il socket di comunicazione Docker dell'host: -v /var/run/docker.sock:/var/run/docker.sock

Il montaggio di questo socket all'interno di un container gli conferisce privilegi di controllo equivalenti a root a livello di host. Se la password del frontend del pannello viene compromessa o se è presente una vulnerabilità di esecuzione di codice da remoto, un utente malintenzionato può utilizzare questo socket per creare un container privilegiato che monta la directory radice dell'host, assumendo il controllo dell'intero sistema.

Linee guida per la protezione avanzata del pannello#

  1. Non esporre alla rete Internet pubblica: Non esporre mai le porte del pannello di gestione, come la porta 9443 di Portainer o la porta di 1Panel, direttamente alla rete Internet pubblica. In produzione, richiedere l'ascolto solo locale (127.0.0.1), consentendo l'accesso solo tramite port forwarding locale attraverso un tunnel sicuro basato su chiave SSH:
    bash
    # 在本地工作电脑建立安全隧道,将远程端口转发至本地
    ssh -N -L 9443:127.0.0.1:9443 user@vps-ip -i ~/.ssh/id_ed25519
    Quindi apri nel tuo browser locale https://127.0.0.1:9443 per accedere al pannello.
  2. Evitare la deriva della configurazione dalla gestione bidirezionale: Possono sorgere facilmente conflitti di stato tra un pannello grafico e i file YAML locali. Se si modificano le porte mappate o le variabili di ambiente di un container direttamente nella WebUI del pannello mentre il file locale compose.yaml non è stato sincronizzato, alla successiva esecuzione di docker compose up -d da terminale qualsiasi modifica temporanea apportata nel pannello verrà completamente cancellata. Migliori pratiche: Utilizzare il pannello solo come monitor di sola lettura o come strumento di audit dei log. Mantenere il repository di controllo versione e gli script di terminale come unica fonte di verità (Single Source of Truth) per tutte le operazioni di creazione, lettura, aggiornamento e cancellazione.

5. Aggiornamenti controllati delle immagini, migrazione dei dati e controllo del rollback#

Molti principianti presumono che aggiornare un container significhi soltanto scaricare l'immagine più recente e riavviarlo. Per le applicazioni aziendali persistenti, questo può facilmente interrompere le migrazioni dello schema del database o danneggiare i dati.

Metodo standard di aggiornamento continuo in quattro passaggi#

testo
[1. 业务静态化与状态备份] ──> [2. 拉取新镜像] ──> [3. 差异化重建容器] ──> [4. 健康校验]

Passaggio uno: Eseguire backup a freddo dell'applicazione e del database#

Prima di passare a una nuova immagine, creare un dump logico dei dati anziché fare affidamento esclusivamente su uno snapshot del disco dell'host.

bash
# 进入部署目录
cd /opt/stacks/web-app

# 逻辑导出当前数据库数据并压缩
docker compose exec db mariadb-dump -u ghost -p"${MYSQL_PASSWORD}" ghost_prod | gzip > backup_$(date +%F_%H%M).sql.gz

# 备份持久化配置与上传目录
tar -czvf app_data_$(date +%F).tar.gz config/ data/

Passaggio due: Aggiornare le immagini e sostituire i container#

Modificare in compose.yaml il tag di versione del servizio di destinazione (come web), quindi eseguire una ricostruzione differenziale:

bash
# 仅拉取更新的镜像层
docker compose pull web

# 触发依赖项计算,仅重新创建发生了配置或镜像变更的容器
docker compose up -d web

# 清理不再使用的孤儿容器与旧版本镜像
docker compose ps
docker image prune -f

docker compose up -d consente di aggiornare lo stack sul posto senza interrompere un servizio di database separato che rimane integro.

Il fatale errore concettuale sul rollback: La trappola dello schema#

Quando una nuova versione del servizio non si avvia correttamente ed è necessario un ripristino urgente, molti si limitano a modificare in compose.yaml la versione dell'immagine riportandola al tag precedente ed eseguono up -d.

Grave rischio nascosto: Molte applicazioni web, come Nextcloud, WordPress e Ghost, eseguono automaticamente migrazioni irreversibili dello schema del database al primo avvio di una nuova versione, inclusa l'eliminazione di colonne, la ridenominazione di campi o la conversione di set di caratteri. Il codice delle versioni precedenti dell'applicazione non è in grado di interpretare le tabelle modificate dalla versione più recente, pertanto errori e arresti anomali continueranno a verificarsi anche se il ripristino dell'immagine ha esito positivo.

Procedura di ripristino completa:

  1. Arrestare immediatamente i container dell'applicazione: docker compose stop web
  2. Ripristinare il database utilizzando il backup esportato in precedenza:
    bash
    # 清空并恢复数据库
    gunzip < backup_YYYY-MM-DD.sql.gz | docker compose exec -T db mariadb -u ghost -p"${MYSQL_PASSWORD}" ghost_prod
  3. Modificare compose.yaml per ripristinare il vecchio tag dell'immagine e i relativi file di configurazione corrispondenti.
  4. Ricostruire la versione precedente del container: docker compose up -d web

Avvertenza: Evitare docker compose down -v
docker compose down arresta e rimuove soltanto i container e le reti bridge; tuttavia, se include il parametro -v (o --volumes), Docker cancellerà direttamente i volumi con nome dichiarati in compose.yaml. A meno che non si intenda distruggere completamente l'ambiente, non utilizzare mai l'opzione seguente su un server di produzione: il comando -v.


6. Coordinamento del networking cloud sottostante e delle operazioni di emergenza#

L'orchestrazione dei container viene eseguita sul server cloud sottostante. Problemi alle interfacce di rete, blocchi del firewall o credenziali smarrite possono interrompere direttamente il ciclo di vita dei container. L'utilizzo efficace delle funzionalità dell'infrastruttura dell'host costituisce l'ultima linea di difesa contro i disastri operativi.

Risoluzione dei problemi relativi al firewall e ai guasti della connettività sottostante#

Poiché Docker gestisce autonomamente le tabelle NAT e i bridge (docker0 / br-xxxx), dopo il riavvio dei container possono occasionalmente verificarsi conflitti nella tabella di routing, rendendo persino irraggiungibile il demone SSH dell'host.

  • Accesso di emergenza DMIT: il pannello di controllo delle istanze di DMIT fornisce un punto di accesso dedicato alla Web Console. Se SSH risulta inaccessibile poiché un container Docker occupa la porta o le policy di rete lo bloccano, utilizzare la Console del pannello per inviare un interrupt hardware o accedere direttamente per risolvere il problema. Inoltre, per prevenire attacchi brute-force, DMIT disabilita l'accesso remoto con password per root, favorendo fortemente l'accesso tramite chiave SSH; se è necessario sostituire o inserire chiavi pubbliche in blocco tramite il menu Access del pannello, dopo l'operazione riavviare l'istanza (Reboot) come indicato dal pannello, dopodiché i meccanismi sottostanti di autenticazione e cloud-init diventeranno effettivi.
  • Risoluzione approfondita dei problemi di KiwiVM su BandwagonHost: BandwagonHost assegna a ciascun VPS un pannello KiwiVM separato. Si noti che la password del pannello KiwiVM, la password dell'account dell'area clienti e le password interne di root del sistema sono completamente indipendenti. In caso di guasto della rete dell'host, utilizzare l'Interactive Console integrata di KiwiVM per bypassare il normale stack di rete e accedere direttamente a un terminale TTY, quindi inserire la password di root per assumere il controllo del server. Se una configurazione di rete errata dei container disabilita l'intera rete, il pannello può persino avviare la reinstallazione del sistema operativo o il ripristino di uno snapshot.

Rinnovo automatico e limiti di conservazione dei dati#

L'orchestrazione dei container consente di ricostruire rapidamente le applicazioni, ma non sostituisce il disaster recovery tra nodi per i dati persistenti. In caso di fattura scaduta o di modifica delle policy del data center, tutti i volumi di dati sull'host potrebbero essere cancellati direttamente.

  • Finestre di fatturazione e conservazione:
    • BandwagonHost: il provider non effettua addebiti automatici su carte di credito o account PayPal collegati senza il vostro intervento. Se il rinnovo è abilitato, viene generata una fattura 7 giorni prima della scadenza. Se il saldo dell'account prepagato è sufficiente, il sistema lo detrae per rinnovare il servizio; in caso contrario, un amministratore deve completare il pagamento manualmente.
    • DMIT: anche le fatture di rinnovo mensile vengono generate 7 giorni prima della scadenza. Se il ritardo nel pagamento causa la sospensione, il data center concede solitamente un periodo di grazia per la conservazione dei dati di soli 3 giorni; una volta scaduto, i processi automatizzati eliminano definitivamente l'istanza e i dati Docker montati, senza alcuna possibilità di recupero.
  • Limitazioni alla migrazione tra data center: sebbene BandwagonHost offra una comoda migrazione tra data center di regioni diverse, se attività in uscita vietate o abusi causano l'inserimento dell'IP di un'istanza in una lista nera, il sistema limita rigorosamente la migrazione nel pannello sottostante. Se un container configurato in modo errato viene compromesso e utilizzato per scansionare reti esterne, le conseguenze vanno dal blocco dell'IP e dall'interruzione del servizio fino alla perdita dei privilegi di migrazione e ripristino.
  • Requisiti minimi di disaster recovery off-site: indipendentemente dal provider sottostante, le directory persistenti (Volumes) e i backup Dump dei database devono essere crittografati e caricati all'esterno dell'host con pianificazione giornaliera utilizzando client di storage a oggetti, come AWS S3, R2 o Backblaze B2. Non mettete mai tutte le uova nel disco virtuale di una sola istanza.

7. Checklist per il passaggio in produzione#

Dopo qualsiasi deployment con Docker Compose o aggiornamento di versione principale, completare l'audit di passaggio di consegne seguendo questi passaggi:

Categoria di convalidaControlli chiaveMetodo di verifica / Comportamento atteso
Isolamento di reteLe porte del database/middleware non sono esposte a Internet pubblicoEsegui sull'host ss -tulpn | grep -E '3306|5432|6379' Nessun listener esterno
Revisione dei privilegiI container applicativi non devono utilizzare la modalità privilegiatacompose.yaml non contiene privileged: true, senza mount dell'host non necessari
Limiti di risorseI limiti rigidi di memoria e CPU sono configurati ed effettiviDopo l'avvio, utilizzare docker stats --no-stream Verificare che i limiti di memoria del container siano diventati effettivi
Rotazione dei logI log non riempiranno il disco dell'hostVerificare che ogni servizio dichiari max-size e max-file Limitazioni
Avvio automatico dopo un'interruzione di correnteRipristino automatico dopo il riavvio dell'hostConfigurazione del servizio restart: unless-stopped, dopo il riavvio docker ps Viene visualizzato
Backup offlineStrategia di backup off-site e convalida dei backupVerificare che i file di backup SQL automatizzati non siano vuoti e possano essere importati in un ambiente di test
Canale di accesso di emergenzaConsole operativa sempre disponibileVerificare in anticipo le credenziali di accesso alla console del provider per garantire l'accesso di basso livello per la risoluzione dei problemi durante un'interruzione di rete