[[Vorlage(archiviert, )]]

{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Packprogramme: Archive entpacken]
[:Programme starten: Ein Programm starten]
[:Editor: Einen Editor öffnen] (optional)
[:Autostart: Automatischer Start von Programmen] (optional)
}}}
[[Inhaltsverzeichnis()]]

[[Bild(Lanshark-logo.png, align=left)]]
[http://lanshark.29a.ch/de Lanshark] {de} ist eine in [:Python:] geschriebene freie Filesharing-Anwendung. Lanshark dient dazu, Dateien mit anderen Benutzern im lokalen Netzwerk (LAN) auszutauschen. Andere Lanshark-Benutzer im Netzwerk werden automatisch erkannt. Man kann auf ihre Freigaben lesend zugreifen und diese auf den lokalen Rechner herunterladen (Download). Lanshark hat eine integrierte Suchfunktion.

Eine Alternative zu Lanshark, jedoch mit anderer Funktionalität, ist [:Transfer_On_LAN:].

{{{#!vorlage Warnung
Lanshark ist nur für die Verwendung in sicheren, nach außen abgeschirmten Netzwerken (auch [:OpenVPN:VPN]) vorgesehen. Es bietet keinen hinreichenden Schutz für die Verwendung in unsicheren Netzen (Internet) und für die Übertragung sensibler Daten. 

Freigaben aller Art können auf Rechnern mit einem direkten Zugang zum Internet ('''ohne''' [:Hardware-Router:Router] mit [wikipedia:Network_Address_Translation:NAT]) oder anderen öffentlichen Netzen ein __erhebliches Sicherheitsrisiko__ bedeuten. Dies gilt insbesondere, wenn wie bei Lanshark kein Schutz durch (verschlüsselt übertragene) Zugangsdaten besteht.
}}}

= Installation =
Lanshark setzt die Pakete

{{{#!vorlage Paketinstallation
python2.5
python-gtk2
python-glade2
}}}
voraus [1].

Derzeit muss man den [http://lanshark.29a.ch/de/Downloads.html Quelltext] {de} (Sourcecode) herunterladen und entpacken [2]. 

[[Vorlage(Fremd, Software, "")]]

Die Installation erfolgt im entpackten Ordner mit:

{{{#!vorlage Befehl
sudo python setup.py install
}}}

Anschließend findet man das Programm unter ''"Anwendungen -> Internet -> Lanshark"''.

Die grafische Oberfläche lässt sich alternativ auch ohne Installation (von mobilen/externen Datenträgern) starten [3]:

{{{#!vorlage Befehl
python ./src/lansharkgui
}}}

= Anwendung =
== Konfiguration ==
Über ''"Editieren -> Eigenschaften"'' lässt sich die grundlegende Konfiguration ausführen. Dafür gibt es zwei Bereiche:

=== Einfach ===
[[Bild(Lanshark-Konfiguration.png, 240, align=right)]]
 * ''Hostname'': Der Name, mit dem sich dieser Rechner im Netzwerk für Lanshark zu erkennen gibt
 * ''Freigabe Pfad'': Hier wird der Pfad (Ordner) ausgewählt, der auf den anderen Rechnern im Netzwerk als scheinbares Wurzelverzeichnis dieses Rechners erscheint
 * ''Einkommender Pfad'': Werden über Lanshark Dateien von anderen Rechnern kopiert, landen sie standardmäßig im hier festgelegten Verzeichnis. Mit "Download to" ist es aber auch möglich, Dateien direkt außerhalb dieses Verzeichnisses zu speichern.
 * ''Autostart'': Da Lanshark-Freigaben nicht durch Zugriffskontrollen geschützt sind, sollte man hiervon __nur mit Bedacht__ Gebrauch machen!

=== Erweitert ===
[[Bild(Lanshark-Konf-Erweitert.png, 240, align=right)]]
 * ''Hallo Nachricht'': Eine Art Netzwerk-Kennung. Nur Rechner, bei denen hier die gleiche Kennung eingetragen ist, können einander sehen und voneinander Dateien kopieren.
 * ''Broadcast-Adresse'': Das Browsen im Netzwerk führt Lanshark mittels Rundspruch (Broadcast) durch. Dabei werden nur diejenigen Rechner erfasst, deren [wikipedia:IP-Adresse:IP-Adresse] in der hier angegebenen Maske enthalten ist. Damit kann man in komplexeren Netzwerken eine Vorauswahl unter den vorhandenen Rechnern treffen.
 * ''Port'': Hier lässt sich der standardmäßig von Lanshark verwendete [:Offene_Ports:Port] verändern.
{{{#!vorlage Hinweis
Den verwendeten Port zu verändern ist keine wirksame Zugriffskontrolle, da offene Ports auf allen Rechnern des Netzwerks mit einem [:Portscan:Port-Scan] leicht zu ermitteln sind.
}}}

=== detaillierte Konfiguration ===
Für eine detailliertere Konfiguration muss man die versteckte Datei '''~/.config/lanshark/lanshark.conf''' mit einem Editor [4] bearbeiten. Einstellungen in dieser Datei sind dann wirksam, wenn die Zeile __nicht__ mit dem Kommentarzeichen (`#`) beginnt. Die Datei ist ausreichend (auf Englisch) kommentiert.

== Browser ==
[[Bild(Lanshark-Browser.png, 360, align=right)]]
In regelmäßigen Zeitabständen (standardmäßig einmal pro Minute) durchsucht Lanshark das lokale Netzwerk mit einem Rundspruch (Broadcast). Erfasst und im linken Feld des Browser-Fensters als Verzeichnisbaum dargestellt werden die Freigaben derjenigen Rechner, deren IP und Kennung den eingetragenen Werten entsprechen. Dort mit Mausklick markierte Ordner werden im rechten Feld geöffnet. Hat man aus diesen die gewünschte Auswahl getroffen, klickt man oben rechts das Download-Symbol an. Mit ''"Download Liste"'' bekommt man eine Übersicht über begonnene und bereits durchgeführte Downloads.

Außerdem besteht die Möglichkeit, über ''Rechtsklick -> "Preview"'' oder [wikipedia:Drag & Drop:] in einen Media Player (z.B. [:Totem:]) Filme und Musik zu streamen.

== Webinterface öffnen ==
Mit ''"Lanshark -> Webinterface öffnen"'' kann die momentane Datei-Auswahl vom internen Browser an den Standard-Internet-Browser ([:Firefox:], [:Opera:], [:Konqueror:] u.a.) übergeben werden. So wird es möglich, auf einige Dateien (Musik, Video, Bilder ...) über die dort installierten [:Archiv/Firefox/Plugins:Plugins] direkt zuzugreifen, ohne sie vorher auf den lokalen Rechner zu kopieren. 

== Suchen ==
Zusätzlich zum Netzwerk-Browser verfügt Lanshark über eine Suchfunktion, mit der das Netzwerk gezielt und schnell nach Dateien aus zehn verschiedenen Kategorien durchsucht werden kann.

== Andere Plattformen ==
=== Windows-Version ===
Von Lanshark gibt es auch eine Version für Windows (Win XP und Vista) mit gleich strukturierter graphischer Oberfläche. Deshalb ist der Daten-Austausch mit Windows-Rechnern über Lanshark kein Problem.

=== Sonderzeichen ===
Standardmäßig ist als Zeichen-Codierung UTF-8 eingestellt. Andere Codierungen können in der Konfigurations-Datei '''~/.config/lanshark/lanshark.conf''' eingetragen werden.  

=Zugriffskontrolle und Sicherheit=
==Authentifikation und Zugriffsrechte==
Die Netzwerk-Kennung ("Hallo Nachricht") bietet nur einen sehr einfachen Schutz vor unerlaubten Zugriffen, da sie unverschlüsselt übertragen wird. Es ist nicht möglich, Zugriffe differenziert einzelnen Rechnern oder Benutzern zu gestatten oder zu untersagen. Auf die Freigaben können grundsätzlich alle Rechner mit der gleichen Netzwerk-Kennung und auf diesen gleichermaßen alle Benutzer lesend zugreifen. Schreibrechte können über Lanshark nicht vergeben werden.

==Freigabe-Pfad==
Das für Lanshark freigegebene Verzeichnis (Freigabe-Pfad) erscheint auf den anderen Rechnern im Netzwerk als ''scheinbares  [wikipedia:Stammverzeichnis:Wurzelverzeichnis]''. Der direkte Zugriff auf Ordner und Dateien außerhalb desselben ist über Lanshark nicht möglich. Dies wirkt sich ähnlich aus wie ein "root-jail" (von "root directory" = Wurzelverzeichnis; nicht Benutzer "Root").

Da Lanshark im Gegensatz zu manchen anderen Netzwerk-Anwendungen auch symbolischen Verknüpfungen ([:ln:Symlinks]) folgt, kann man über solche auch auf Ordner oder Dateien außerhalb des Freigabe-Pfads zugreifen. Bei bewusster Anwendung ist dies jedoch kein Sicherheitsrisiko, weil man vom Client aus auf dem Server keine Symlinks einrichten kann.

== Ports ==
Lanshark verwendet __keinen__ statisch installierten Server mit dauerhaft geöffneten [Offene_Ports:Ports:]. Die zum Datenaustausch benötigten Ports werden erst beim Programmstart geöffnet und nach dem Verlassen des Programms ("''Lanshark -> Beenden''" oder Rechtsklick auf Icon im Panel und "''Beenden''"), nicht jedoch nach dem einfachen Schließen des Auswahlfensters, wieder geschlossen.

{{{#!vorlage Hinweis
Wie bei allen Filesharing-Programmen empfiehlt es sich auch bei Lanshark, das Programm bei Nichtgebrauch __ganz__ zu beenden (''"Lanshark -> beenden"'', nicht nur das Auswahlfenster schließen).
}}}


= Links =
== Intern ==
 * [:Heimnetzwerk:Heimnetzwerk]: Alternative Möglichkeiten zum Einrichten eines privaten Netzwerks
== Extern ==
 * [http://lanshark.29a.ch/de/ Homepage von Lanshark] {de}

#tag: Netzwerk, Server, Kommunikation, Python