Erste Schritte

Fileshare

Ein selbst betriebener Dienst zum Versand einzelner Dateien. Ein angemeldeter Nutzer lädt eine Datei hoch und erhält einen Link, den er weitergeben kann. Der Empfänger braucht kein Konto.

Stand: 3.3.1.

Wofür

Die Datei liegt auf deinem Server, nicht bei einem fremden Anbieter. Jede Freigabe hat ein Ende — Ablaufdatum, Download-Limit, optional ein Passwort. Und wer sie abgeholt hat, steht in derselben Oberfläche, in der sie erzeugt wurde.

Die drei Anwendungsfälle:

Fall Wer handelt Weg
Datei bereitstellen angemeldeter Nutzer Upload → Download-Link → weitergeben
Datei empfangen Empfänger ohne Konto Link öffnen → ggf. Passwort → Download
Datei entgegennehmen fremde Person ohne Konto Upload-Link öffnen → Datei ablegen

Was Fileshare nicht ist: keine Dateiablage und kein Laufwerk (keine Ordner, kein Teilen von Beständen, keine Zusammenarbeit an Dokumenten), kein Archiv (Links laufen ab, Dateien werden gelöscht), keine Synchronisation, kein Ersatz für ein DMS.

Der Zuschnitt in vier Sätzen:

  • Keine öffentliche Registrierung. Konten legt ausschließlich ein Administrator an.
  • Ein Link, eine Datei. Keine Sammelfreigaben, keine Ordnerfreigaben.
  • Dateien werden immer als Anhang ausgeliefert, nie zur Anzeige im Browser. Eine hochgeladene HTML- oder SVG-Datei kann damit kein Skript im Kontext der Installation ausführen.
  • Alle Wege der Nutzer funktionieren ohne JavaScript. Mit JavaScript wird es bequemer (Drag & Drop, gechunkter Upload großer Dateien, Detailansicht ohne Seitenwechsel), aber kein Anwendungsfall hängt davon ab. Einzige Ausnahme ist ein Werkzeug im Admin: der Selbsttest der Auslieferung misst im Browser die empfangenen Bytes.

Die Oberfläche ist deutschsprachig, die Kommandozeile englisch.

Installieren

Mit vorbereiteter Datenbank und Domain in einer Viertelstunde:

curl -fLO https://gitlab.com/mankeldor/fileshare/-/raw/main/fileshare-setup.sh
sh fileshare-setup.sh /pfad/zur/installation
cd /pfad/zur/installation
php artisan fileshare:install

Der ganze Weg: SystemanforderungenInstallationCron einrichtenNach der Installation.

Wo was steht

Häufige Fragen Was es kostet, was der Betrieb verlangt, was es bewusst nicht kann
Erste Schritte Anforderungen, Installation, Cron, Aktualisierung
Betrieb Konfiguration, Einstellungen, Konten, Sicherheit, Backup, Wartung, Störungssuche
Benutzen Für die Menschen, die täglich damit arbeiten: Dateien bereitstellen, Links weitergeben, Dateien entgegennehmen
Lizenz Wer was darf, kostenlos oder lizenzpflichtig
Änderungen Was sich zuletzt geändert hat

Für Entwicklung und Konventionen: CONVENTIONS.md, CONTRIBUTING.md, DOCS-CONVENTIONS.md.

Quelle dieser Seite: docs/uebersicht.md im Repository. Sie wird beim Bauen daraus erzeugt — Änderungen gehören in die Markdown-Datei, nicht in diese Seite.