MicroBin

Zugriff

Öffnen Sie die folgende URL in Ihrem Browser: https://<SERVER-IP>

Akzeptieren Sie die Warnung zum selbstsignierten Zertifikat und öffnen Sie MicroBin.

Admin-Bereich

Die Administrationsoberfläche ist erreichbar unter: https://<SERVER-IP>/admin/

Verwenden Sie die folgenden Anmeldedaten:

• Benutzername: admin
• Passwort: gespeichert in /usr/share/microbin/.env as MICROBIN_ADMIN_PASSWORD

Konfiguration

Die MicroBin-Einstellungen können geändert werden in: /usr/share/microbin/.env

Starten Sie die Anwendung nach Änderungen an der Konfiguration neu:

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

Wichtige Dateien und Verzeichnisse

• Installationspfad: /usr/share/microbin
• Compose-Datei: /usr/share/microbin/compose.yaml
• Umgebungsdatei: /usr/share/microbin/.env
• Datenvolume: /var/lib/docker/volumes/microbin_microbin_data
• Nginx-Konfiguration: /etc/nginx/sites-available/microbin

Service-Management

Laufende Container anzeigen:

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

MicroBin neu starten:

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

MicroBin-Logs anzeigen:

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

MicroBin stoppen:

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

MicroBin starten:

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

MicroBin neu erstellen:

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

Nginx-Status prüfen:

systemctl status nginx

Nginx neu starten:

systemctl restart nginx

Nginx neu laden:

systemctl reload nginx

Überprüfen Sie die Nginx-Konfiguration:

nginx -t

HTTPS mit einer Domain aktivieren

1. Richten Sie Ihre Domain auf die Server-IP aus.

2. Bearbeiten /etc/nginx/sites-available/microbin und ersetzen Sie beide server_name _; Direktiven durch Ihre Domain (z. B. server_name yourdomain.com;).

3. Certbot installieren:

apt install -y certbot python3-certbot-nginx

4. Beschaffen Sie ein Let's Encrypt-Zertifikat:

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

5. Bearbeiten Sie /etc/nginx/sites-available/microbin und aktualisieren Sie die ssl_certificate und ssl_certificate_key Direktiven, damit sie Ihr Let's Encrypt-Zertifikat verwenden.

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. Laden Sie Nginx neu, um die Änderungen anzuwenden:

systemctl reload nginx

7. Bearbeiten Sie /usr/share/microbin/.env und aktualisiere MICROBIN_PUBLIC_PATH ab https://<SERVER_IP>/ auf Ihre Domain (z. B. export MICROBIN_PUBLIC_PATH=https://yourdomain.com/).

8. Dienste neu erstellen:

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

9. Rufen Sie MicroBin auf unter https://yourdomain.com.

Hinweise

• Das Neuerstellen des Dienstes kann bestehende Einträge beeinträchtigen.
• Halten Sie die .env Datei sicher auf, da sie sensible Konfigurationswerte enthält.