OnionShare - Anleitung für macOS

Installieren

Homebrew prüfen, OnionShare als Homebrew Cask installieren und die App einmal starten.

Ordner vorbereiten

Alle Dateien in einem einzigen Hauptordner sammeln. Bei einer Webseite müssen auch index.html, Bilder, CSS und weitere Bestandteile enthalten sein.

Freigabe starten

Den Ordner in OnionShare laden, die Schutzoptionen prüfen und Freigabe starten wählen.

Zugang übermitteln

Die .onion-Adresse und den privaten Schlüssel über einen sicheren Kommunikationsweg an die empfangende Person senden.

Mac wach halten

Das Display darf ausgehen. Der iMac selbst darf jedoch bis zum vollständigen Download nicht in den Ruhezustand wechseln.

Terminal öffnen

Öffne Finder > Programme > Dienstprogramme > Terminal. Prüfe zuerst, ob Homebrew bereits vorhanden ist.

brew --version

Homebrew nur bei Bedarf installieren

Erscheint command not found, verwende den offiziellen Homebrew-Installationsbefehl. Das Skript erklärt die Änderungen und hält vor der Installation noch einmal an.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Falls brew danach noch nicht gefunden wird, richte auf dem M1-iMac den Homebrew-Pfad ein:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> "$HOME/.zprofile"
eval "$(/opt/homebrew/bin/brew shellenv)"

Homebrew aktualisieren

Lade die aktuelle Paketliste, bevor OnionShare installiert wird.

brew update

OnionShare installieren

Installiere die grafische macOS-App aus dem offiziellen Homebrew-Cask. Homebrew führt derzeit OnionShare 2.6.5 für macOS 11 oder neuer.

brew install --cask onionshare

App starten und Installation prüfen

Starte OnionShare direkt aus dem Terminal. Beim ersten Start kann macOS eine Sicherheitsabfrage anzeigen.

open -a OnionShare

Einen Hauptordner verwenden

Lege alle zu teilenden Dateien in einen einzigen Ordner. Verschiebe oder benenne den Ordner während der Freigabe nicht um.

Inhalt vollständig prüfen

Kontrolliere Dateinamen, Unterordner und Dateigrößen. Temporäre Dateien, Backups und Inhalte, die nicht weitergegeben werden sollen, müssen vorher entfernt werden.

Webseitenordner vollständig halten

Wenn der Ordner eine kleine Webseite enthält, muss index.html zusammen mit allen lokalen Bildern, CSS- und JavaScript-Dateien im Ordner liegen. Relative Verknüpfungen und Groß-/Kleinschreibung müssen exakt stimmen.

Vorher lokal testen

Öffne bei einer Webseite index.html im Finder. Prüfe jede Seite und jedes Bild, bevor OnionShare gestartet wird.

Metadaten bewusst behandeln

OnionShare entfernt keine EXIF-, PDF-, Office- oder sonstigen Metadaten. Wenn Anonymität wichtig ist, müssen sensible Metadaten bereits vor der Freigabe bereinigt sein.

OnionShare öffnen

Starte OnionShare und warte, bis die Verbindung zum Tor-Netzwerk hergestellt ist. Die Desktop-App bringt die notwendige Tor-Anbindung mit; ein eigener Tor-Dienst ist für diesen Standardbetrieb nicht nötig.

Freigabebereich wählen

Öffne Dateien freigeben. Ziehe den vollständigen Hauptordner in das Fenster oder verwende die Schaltfläche zum Hinzufügen eines Ordners.

Empfohlene Schutzoptionen prüfen

Lasse den privaten Schlüssel aktiviert und verwende keinen öffentlichen Dienst. Für eine einzelne Person bleibt Server nach Download der Dateien stoppen aktiviert.

Freigabe starten

Klicke auf Freigabe starten. Erst jetzt ist der temporäre Onion-Dienst erreichbar.

Zugangsdaten kopieren

Kopiere die vollständige .onion-Adresse und den angezeigten privaten Schlüssel. Je nach Oberfläche kann OnionShare zusätzlich eine bequem kopierbare vollständige Zugriffsangabe anbieten.

Download überwachen

Lasse das OnionShare-Fenster geöffnet. Der Übertragungsbereich zeigt Verbindungs- und Downloadfortschritt; nach einem vollständigen Download beendet die Standardeinstellung die Freigabe automatisch.

Webseitenbereich öffnen

Wähle in OnionShare Webseite veröffentlichen. Ziehe den vollständigen Webseitenordner hinein - nicht nur die Datei index.html.

Startdatei und Verknüpfungen prüfen

Die Datei index.html muss im Wurzelverzeichnis der Freigabe liegen. Bilder und Stylesheets sollten über relative Pfade wie bilder/foto.jpg eingebunden sein.

Sicherheitsstandard beibehalten

Lasse den strengen Content-Security-Policy-Schutz aktiviert. Verwende möglichst nur lokale Dateien; externe CDNs, Webfonts oder Drittanbieter-Skripte können sonst blockiert werden.

Webseite veröffentlichen

Starte den Dienst über Webseite veröffentlichen, kopiere Adresse und privaten Schlüssel und teste die Seite anschließend selbst im Tor Browser.

Anzeige vollständig kontrollieren

Öffne jede Unterseite und prüfe alle Bilder. Ein lokal sichtbares Bild fehlt im Tor Browser meist deshalb, weil es nicht im freigegebenen Ordner liegt oder der Dateiname im HTML nicht exakt übereinstimmt.

Tor Browser installieren

Lade den Tor Browser ausschließlich von der offiziellen Tor-Projekt-Seite. Direkter Link für macOS: https://www.torproject.org/de/download/

Mit Tor verbinden

Starte den Tor Browser und wähle Verbinden. Wenn Tor nicht blockiert wird, ist keine Brücke notwendig.

Onion-Adresse öffnen

Füge die vollständige .onion-Adresse in die Adresszeile des Tor Browsers ein. Chrome, Safari und normale Firefox-Installationen können diese Adresse nicht öffnen.

Privaten Schlüssel eingeben

Wenn OnionShare danach fragt, füge den privaten Schlüssel exakt ein. Adresse und Schlüssel gehören zusammen; ein alter Schlüssel passt nicht zu einer neu gestarteten Freigabe.

Download starten

Wähle Dateien herunterladen. Bei einem Ordner wird üblicherweise ein komprimiertes Gesamtpaket angeboten; bei entsprechend geänderter Serveroption können auch einzelne Dateien verfügbar sein.

Erfolg melden

Die empfangende Person wartet, bis der Browser den vollständigen Download bestätigt. Erst danach beendet der Sender die Freigabe und die Wachhalte-Sitzung.

Energie öffnen

Wähle Apple-Menü > Systemeinstellungen > Energie. Du musst in der Seitenleiste möglicherweise nach unten scrollen.

System-Ruhezustand verhindern

Aktiviere Kein automatisches Aktivieren des Ruhezustands bei ausgeschaltetem Display. Genau diese Option hält den iMac weiter aktiv, wenn sein Bildschirm ausgeht.

Displayzeit frei wählen

Unter Systemeinstellungen > Sperrbildschirm darfst du Display bei Netzbetrieb deaktivieren, wenn inaktiv auf die gewünschte Zeit stellen. Das spart Strom, ohne OnionShare zu unterbrechen.

Unbegrenzte Sitzung starten

Klicke in der Menüleiste auf Amphetamine > Neue Sitzung starten > Unbegrenzt. Die Sitzung muss vor dem Start der OnionShare-Freigabe aktiv sein.

Display-Ruhezustand erlauben

Amphetamine darf den Display-Ruhezustand zulassen, während es den Mac wach hält. Beim iMac ist keine Einstellung für einen geschlossenen Notebook-Deckel nötig.

Nach dem Transfer beenden

Beende die Amphetamine-Sitzung erst, wenn OnionShare den vollständigen Download zeigt oder der Empfänger den Abschluss bestätigt hat.

OnionShare geöffnet lassen

Die App darf im Hintergrund liegen, aber nicht beendet werden. Freigabe beenden macht die Adresse sofort unerreichbar.

Ordner nicht verändern

Verschiebe, benenne oder lösche keine freigegebenen Dateien. Warte mit Änderungen, bis der Download abgeschlossen ist.

Internet stabil halten

WLAN beziehungsweise Netzwerkverbindung und Router müssen aktiv bleiben. Ein Netzwerkwechsel kann die Verbindung unterbrechen und einen neuen Download erforderlich machen.

Fortschritt kontrollieren

Öffne in OnionShare die Übertragungsanzeige. Erst ein vollständig abgeschlossener Download gilt als erfolgreiche Übergabe.

Freigabe stoppen

Klicke auf Freigabe beenden, falls die Standardeinstellung den Dienst nicht bereits automatisch gestoppt hat.

Zugangsdaten verwerfen

Behandle die alte Adresse und den alten Schlüssel als erledigt. Bei einer neuen Freigabe erzeugt OnionShare normalerweise neue Zugangsdaten.

Wachhalten beenden

Beende Amphetamine oder caffeinate. Wenn du die dauerhafte Energieeinstellung nur für OnionShare geändert hast, kannst du sie anschließend zurückstellen.