weshare

Dieses Projekt stellt eine schlanke, selbst gehostete Umgebung für den sicheren Datenaustausch bereit.
Pingvin Share ist eine WeTransfer‑ähnliche Lösung mit moderner Weboberfläche, ideal für gelegentliche große Dateiübertragungen hinter einem Apache‑Reverse‑Proxy.

Inhalt

Voraussetzungen
Verzeichnisstruktur
Konfiguration (.env & docker-compose.yml)
Apache‑Reverse‑Proxy
Erststart
HTTPS (Let’s Encrypt)
Administration & Updates
Sicherheitshinweise

Voraussetzungen

Ubuntu Server (z.B. 22.04 LTS) mit:
- Docker und Docker Compose
- Apache Webserver (apache2)
DNS‑Eintrag für:
- pingvin.deinedomain.tld
Root‑ oder sudo‑Rechte

Verzeichnisstruktur

Empfohlene Struktur auf dem Host:


/opt/
pingvin/
docker-compose.yml
.env
data/
images/

Konfiguration

.env

Datei: /opt/pingvin/.env


PINGVIN_VERSION=latest
PINGVIN_HTTP_PORT=3000
PINGVIN_DATA_PATH=/opt/pingvin/data
PINGVIN_TIMEZONE=Europe/Vienna
PINGVIN_BEHIND_PROXY=true
PINGVIN_PUID=1000
PINGVIN_PGID=1000

docker-compose.yml

Datei: /opt/pingvin/docker-compose.yml


version: "3.8"

services:
pingvin-share:
image: stonith404/pingvin-share:\${PINGVIN_VERSION}
container_name: pingvin-share
restart: unless-stopped
environment:
TZ: \${PINGVIN_TIMEZONE}
PUID: \${PINGVIN_PUID}
PGID: \${PINGVIN_PGID}
PINGVIN_BEHIND_PROXY: \${PINGVIN_BEHIND_PROXY}
volumes:
- \${PINGVIN_DATA_PATH}:/opt/app/backend/data
- ${PINGVIN_DATA_PATH}/images:/opt/app/frontend/public/img
    networks:
      - pingvin_net
    # nur lokal binden – Zugriff über Apache
    ports:
      - "127.0.0.1:${PINGVIN_HTTP_PORT}:3000"

networks:
pingvin_net:
driver: bridge

Datenverzeichnisse vorbereiten


sudo mkdir -p /opt/pingvin/data/images
sudo chown -R 1000:1000 /opt/pingvin

Apache‑Reverse‑Proxy

Module aktivieren


sudo a2enmod proxy proxy_http headers
sudo systemctl restart apache2

Datei: /etc/apache2/sites-available/pingvin.conf


<VirtualHost *:80>
ServerName pingvin.deinedomain.tld

    ErrorLog ${APACHE_LOG_DIR}/pingvin_error.log
    CustomLog ${APACHE_LOG_DIR}/pingvin_access.log combined
    
    ProxyPreserveHost On
    ProxyPass        / http://127.0.0.1:3000/
    ProxyPassReverse / http://127.0.0.1:3000/
    
    ProxyTimeout 600
    Timeout 600
    LimitRequestBody 0
    
    RequestHeader set X-Forwarded-Proto "http"
    RequestHeader set X-Forwarded-For "%{REMOTE_ADDR}s"
    </VirtualHost>

Sites aktivieren:


sudo a2ensite pingvin.conf
sudo systemctl reload apache2

Erststart


cd /opt/pingvin
docker compose up -d

Aufruf im Browser:

http://pingvin.deinedomain.tld

Beim ersten Aufruf richtest du im Web‑Interface den Admin‑Benutzer und grundlegende Einstellungen ein.

HTTPS (Let’s Encrypt)

Optional: HTTPS mit Certbot und Apache einrichten:


sudo apt-get install certbot python3-certbot-apache
sudo certbot --apache -d pingvin.deinedomain.tld

Certbot passt die vHost‑Konfiguration an und richtet automatische Zertifikatserneuerung ein.

Administration & Updates

Logs ansehen


docker logs pingvin-share
journalctl -u apache2

Container aktualisieren


cd /opt/pingvin
docker compose pull
docker compose up -d

Sicherheitshinweise

Zugriff aus dem Internet möglichst nur über HTTPS bereitstellen.
Starke, eindeutige Passwörter für Admin‑Konten verwenden.
Upload‑Größen und Ablaufzeiten in Pingvin Share passend konfigurieren.
Regelmäßig Docker‑Images und Apache aktualisieren.

README.md Unescape Escape

Pingvin Share – Self‑Hosted File Sharing