Come aggiornare Nginx Proxy Manager 2.15: guida completa

Nginx Proxy Manager 2.15 è un aggiornamento di manutenzione significativo per questo strumento di gestione di reverse proxy basato su Docker, ampiamente utilizzato per semplificare la configurazione e la gestione di proxy inversi. Questo aggiornamento introduce una nuova immagine base Debian 13 "Trixie" e una serie di miglioramenti che lo rendono particolarmente utile per amministratori di sistema e sviluppatori che necessitano di un controllo avanzato sui loro servizi web.

L'aggiornamento è fondamentale per chi gestisce deploy pubblici, grazie all'aggiornamento di OpenResty che risolve diverse vulnerabilità di sicurezza. Inoltre, migliora la gestione dei certificati SSL tramite Certbot, aggiungendo nuovi plugin per vari provider DNS e correggendo un problema di sicurezza relativo alla gestione dei ruoli.

Questo strumento è particolarmente utile per chi necessita di un'interfaccia utente intuitiva per configurare proxy inversi senza dover scrivere manualmente file di configurazione Nginx. È ideale per chi gestisce più domini e necessita di certificati SSL automatici, offrendo un modo semplice per configurare e mantenere proxy inversi sicuri e efficienti.

Prerequisiti

• Hardware: Un server o un dispositivo compatibile con Docker.
• Software: Docker installato e configurato correttamente.
• Software: Docker Compose (opzionale, ma consigliato per gestire i container).
• Software: Nginx Proxy Manager versione 2.15.0.
• Software: Certbot e i relativi plugin DNS per la gestione dei certificati SSL.
• Software: Un client DNS compatibile con i plugin supportati (hoster.by, RcodeZero, Hostinger, deSEC, EuroDNS).

PROCEDURA: Aggiornamento a Nginx Proxy Manager 2.15

Seguendo questa guida, aggiornerai correttamente Nginx Proxy Manager alla versione 2.15, beneficiando delle ultime funzionalità di sicurezza e miglioramenti.

• Accedi al terminale del server dove è installato Nginx Proxy Manager.
• Esegui il comando per aggiornare l'immagine Docker: docker pull jc21/nginx-proxy-manager:2.15.0
• Ferma il container in esecuzione: docker stop nginx-proxy-manager
• Avvia un nuovo container con l'immagine aggiornata: docker run -d --name=nginx-proxy-manager --restart=unless-stopped -p 80:80 -p 443:443 -p 81:81 -v /path/to/data:/data -v /path/to/letsencrypt:/etc/letsencrypt jc21/nginx-proxy-manager:2.15.0
• Accedi all'interfaccia web di Nginx Proxy Manager per confermare che l'aggiornamento è stato completato con successo.

Verifica e Troubleshooting

Alla fine di questa guida, sarai in grado di testare il corretto funzionamento di Nginx Proxy Manager 2.15 e risolvere eventuali problemi di configurazione.

Test di Funzionamento

• Test delle certificazioni: Verifica che i certificati SSL siano stati rinnovati correttamente. Controlla la sezione "SSL Certificates" nel pannello di amministrazione.
• Prova di accesso: Assicurati che tutti gli utenti possano accedere ai loro rispettivi proxy host senza problemi.
• Test delle nuove funzionalità: Verifica che le nuove Certbot plugins per hoster.by, RcodeZero, e Hostinger siano disponibili e funzionanti.

Risoluzione dei Problemi

• Problemi con i plugin DNS: Se riscontri problemi con i plugin DNS per Certbot, assicurati di aver installato tutte le dipendenze necessarie. Controlla la documentazione ufficiale per eventuali aggiornamenti.
• Permessi utente: Se gli utenti non riescono ad accedere ai loro proxy host, verifica che i ruoli siano stati configurati correttamente e che non ci siano problemi con i permessi.
• Aggiornamenti falliti: Se l'aggiornamento non va a buon fine, prova a eseguire manualmente il pull dell'immagine Docker con il tag 2.15.0.
• Problemi con la base Debian: Se riscontri problemi legati alla nuova base Debian 13 "Trixie", consulta il changelog ufficiale per ulteriori dettagli e soluzioni.

Per ulteriori dettagli e supporto, visita il changelog ufficiale.

Alla fine di questa guida, avrai compreso le principali novità introdotte da Nginx Proxy Manager 2.15 e sarai pronto a pianificare l'aggiornamento del tuo ambiente.

Sintesi didattica

• L'aggiornamento a Debian 13 "Trixie" rappresenta un cambiamento significativo nella base del sistema.
• L'aggiornamento di OpenResty risolve vulnerabilità critiche, essenziale per le implementazioni pubbliche.
• Miglioramenti nella gestione di Certbot, con nuovi plugin e test CI per i plugin DNS.
• Correzioni di sicurezza per la gestione dei ruoli negli ambienti multi-utente.
• Minor miglioramenti nell'interfaccia web, come l'ordinamento delle colonne e i dialoghi di conferma.

Invito alla pratica

Prima di procedere con l'aggiornamento, verifica la compatibilità dei tuoi plugin DNS e pianifica un test in un ambiente di staging. Per gli ambienti di produzione, utilizza il tag 2.15.0 invece di latest per un controllo più accurato delle versioni.