MicroBin

Accesso

Apri il seguente URL nel tuo browser: https://<SERVER-IP>

Accetta l'avviso del certificato autofirmato e accedi a MicroBin.

Pannello di amministrazione

L'interfaccia di amministrazione è disponibile su: https://<SERVER-IP>/admin/

Usa le seguenti credenziali:

• Nome utente: admin
• Password: archiviato in /usr/share/microbin/.env as MICROBIN_ADMIN_PASSWORD

Configurazione

Le impostazioni di MicroBin si modificano in: /usr/share/microbin/.env

Dopo aver modificato la configurazione, riavvia l'applicazione:

cd /usr/share/microbin
docker compose up -d

File e directory importanti

• Percorso di installazione: /usr/share/microbin
• File Compose: /usr/share/microbin/compose.yaml
• File di ambiente: /usr/share/microbin/.env
• Volume dati: /var/lib/docker/volumes/microbin_microbin_data
• Configurazione Nginx: /etc/nginx/sites-available/microbin

Gestione del servizio

Visualizzare i container in esecuzione:

docker compose -f /usr/share/microbin/compose.yaml ps

Riavvia MicroBin:

docker compose -f /usr/share/microbin/compose.yaml restart

Visualizzare i log di MicroBin:

cd /usr/share/microbin && docker compose logs -f

Arresta MicroBin:

docker compose -f /usr/share/microbin/compose.yaml stop

Avvia MicroBin:

docker compose -f /usr/share/microbin/compose.yaml start

Ricrea MicroBin:

docker compose -f /usr/share/microbin/compose.yaml up -d

Verificare lo stato di Nginx:

systemctl status nginx

Riavviare Nginx:

systemctl restart nginx

Ricaricare Nginx:

systemctl reload nginx

Convalida la configurazione di Nginx:

nginx -t

Abilitare HTTPS con un dominio

1. Punta il tuo dominio all'IP del server.

2. Modifica /etc/nginx/sites-available/microbin e sostituisci entrambe le server_name _; direttive con il tuo dominio (ad es. server_name yourdomain.com;).

3. Installa Certbot:

apt install -y certbot python3-certbot-nginx

4. Ottieni un certificato Let's Encrypt:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Modifica /etc/nginx/sites-available/microbin e aggiorna le ssl_certificate e i piani ssl_certificate_key direttive per usare il tuo certificato Let's Encrypt.

Before:
    ssl_certificate /etc/nginx/ssl/microbin.crt;
    ssl_certificate_key /etc/nginx/ssl/microbin.key;
After:
    ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Ricarica Nginx per applicare le modifiche:

systemctl reload nginx

7. Modifica /usr/share/microbin/.env e aggiorna MICROBIN_PUBLIC_PATH da https://<SERVER_IP>/ con il tuo dominio (ad es. export MICROBIN_PUBLIC_PATH=https://yourdomain.com/).

8. Ricreare i servizi:

cd /usr/sahre/microbin && docker compose up -d

9. Accedi a MicroBin su https://yourdomain.com.

Note

• Ricreare il servizio può influire sulle voci esistenti.
• Mantieni il .env al sicuro, perché contiene valori di configurazione sensibili.