ShareDir

Sharedir

Sharedir ist ein einfaches und bequemes pythonbasiertes Tool, mit dem Sie Dateien und Verzeichnisse über LAN oder das Internet über einen einzigen Befehl teilen können. Unabhängig davon, ob Sie Filme von Ihrem Laptop auf Ihr Telefon streamen, Dateien zwischen Geräten teilen, die mit demselben WLAN -Netzwerk verbunden sind, oder ein Verzeichnis von Ihrem VPS von Ihrem VPS hosten, erleichtert Sharedir es mit einem eingebetteten HTTP -Server und Passphrase -Schutz.

Das Tool generiert eine gemeinsam genutzbare URL, einschließlich einer sicheren Passphrase, die über Geräte geteilt werden kann. Sie können den QR -Code für automatische generierte QR für einfache Datei- und Ordnerfreigabe scannen.

Merkmale

• Einfache Datei- und Verzeichnisfreigabe : Teilen Sie Dateien und ganze Verzeichnisse über LAN oder das Internet mit nur einem Befehl.
• QR -Code für Schnellzugriff : Das Tool generiert einen QR -Code, sodass er einfach auf die gemeinsam genutzbare URL von jedem Gerät zugreifen kann.
• Passphrase -Schutz : Jede Sitzung ist mit einer erzeugten Passphrase geschützt, um einen unbefugten Zugriff zu verhindern.
• Blacklist : IPs mit übermäßigen fehlgeschlagenen Anmeldeversuchen werden für eine festgelegte Dauer auf die schwarze Liste gesetzt, um Bruteforcing- oder Wörterbuchangriffe zu verhindern.
• Schnittstelle zwischen Dark Mode : Integrierte Unterstützung für den Dark-Modus in der Webschnittstelle zum bequemen Surfen.
• LAN und Internetzugang : Teilen Sie Dateien in Ihrem lokalen Netzwerk oder verwenden Sie eine öffentliche IP -Adresse von einem VPS, um über das Internet zu teilen.

Installation

Es gibt zwei Möglichkeiten, Sharedir zu installieren: über pip oder klonieren Sie das Repository direkt von GitHub.

Option 1: Installieren Sie über pip

Der einfachste Weg, Sharedir zu installieren, ist die Verwendung von pip . Sie können das Tool mit dem folgenden Befehl installieren:

pip install sharedir

Option 2: Installieren Sie über git clone

Sie können Sharedir auch installieren, indem Sie das Repository aus GitHub klonen und die Abhängigkeiten manuell installieren:

1. Klonen Sie das Repository:

   git clone https://github.com/spignelon/ShareDir.git
   cd ShareDir

2. Installieren Sie die Abhängigkeiten mit pip :

   pip install -r requirements.txt

Verwendung

Mit Sharedir können Sie mit einem einzigen Befehl eine Datei oder ein Verzeichnis über LAN oder das Internet freigeben. Im Folgenden finden Sie die Verwendungsanweisungen für beide Installationsmethoden.

Grundnutzung

Nach der Installation können Sie eine Datei oder ein Verzeichnis freigeben, indem Sie den folgenden Befehl ausführen:

sharedir /path/to/file/or/directory

Dieser Befehl startet einen lokalen HTTP -Server, auf dem die angegebene Datei oder das angegebene Verzeichnis dient. Der Server zeigt eine gemeinsam nutzbare URL und einen QR -Code für den schnellen Zugriff an.

Optionen

• Pfad (erforderlich) : Der Pfad zur Datei oder zum Verzeichnis, die Sie teilen möchten.
• -Passphrase-Länge oder -P (optional) : Geben Sie die Anzahl der Wörter in der Passphrase an (Standard ist 4).

Beispiel

Um ein Verzeichnis mit dem Namen movies mit einer Passphrase von 6 Wörtern zu teilen:

sharedir ~ /movies -p 6

ODER

python sharedir/sharedir.py ~ /movies -p 6

Dies gibt so etwas wie:

Generated passphrase: grape-apple-banana-orange-kiwi-lemon
Access URL: http://192.168.1.100:44447/ ? passphrase=grape-apple-banana-orange-kiwi-lemon

Sie können auf diese URL von jedem Gerät zugreifen, das mit demselben Netzwerk verbunden ist, oder den angezeigten QR -Code mit Ihrem Telefon scannen.

Zugriff auf Dateien

Sobald der Server ausgeführt wird, navigieren Sie in einem Webbrowser zur bereitgestellten URL oder verwenden Sie den QR -Code. Sie werden aufgefordert, die Passphrase in die URL -Parameter einzugeben. Zum Beispiel:

 http://192.168.1.100:44447/?passphrase=grape-apple-banana-orange-kiwi-lemon

Von hier aus können Sie Dateien direkt über die Weboberfläche durchsuchen und herunterladen.

Teilen über das Internet

Wenn Sie mit einer öffentlichen IP auf einem VPS sind, generiert das Tool automatisch einen QR -Code und die URL mit der öffentlichen IP Ihres VPS. Teilen Sie diese URL mit dem Gerät im Internet, um auf das freigegebene Verzeichnis oder die Datei zuzugreifen.

Lizenz

Dieses Projekt ist unter der GNU Affero General Public Lizenz v3.0 lizenziert. Weitere Informationen finden Sie in der Lizenzdatei.