AMuleWeb-de

From AMule Project FAQ
Jump to: navigation, search

English | Deutsch | Italiano

aMuleWeb ist ein Programm das es dir erlaubt aMule von überall aus mit einem Webbrowser zu steuern. Diese Schnittstelle bietet nur eine Untermenge aller aMule-Funktionen inklusive: Suchen nach Dateien, Downloads starten und ansehen der Downloadwarteschlange. Es zeigt dir auch Statusinformationen an, und erlaubt das ändern einiger Optionen.

aMule bietet selbst keine Unterstützung für HTTP Verbindungen; aMuleWeb dient deswegen als Vermittler zwischen aMule und deinem Browser. Wenn einmal die Verbindung zwischen aMuleWeb und dem entfernten Nutzer aufgebaut wurde, verbindet aMuleWeb per Externer Verbindung zu aMule.

Standardmäßig wartet aMuleWeb auf HTTP Verbindungen an Port 4711, dies kann aber unter Einstellungen geändert werden.

aMuleWeb Installieren

Die meisten Distributionen haben aMule Pakete in ihrem Katalog. Falls du aMule mittels RPM, DEB, oder anderen Paketmanagern installieren willst, wird auch meistens aMuleWeb mit installiert.

Das ist die einfachste und vorzuziehende Methode aMule und aMuleWeb zu installieren.

aMuleWeb Kompilieren

Wenn du aMule nicht mit einem Paketmanager installiert hast, musst du ihn aus dem Quelltext kompilieren.

aMuleWeb wird nicht separat kompiliert; Es wird zeitgleich mit aMule kompiliert, wenn du --enable-amuleweb dem configure Skript mitgibst. (Auf der Hauptseite sind Links zu Seiten die das Kompilieren von aMule auf verschiedenen Systemen beschreiben).

aMuleWeb konfigurieren

Um aMuleWeb zu nutzen musst du erst verschiedene Option im Einstellungsdialog von aMule setzen. Auf der Seite "Fernsteuerung" muss gesetzt werden:

  • "Externe Verbindungen annehmen" aktivieren.
  • Passwort für Externe Verbindungen eingeben.
  • Webserver aktivieren.

Du kannst auch den Standardport von aMuleWeb (4711) und den Externen Verbindungen (4712) auf dieser Seite ändern. Wenn du das tust musst du aMule neu starten um die Änderungen zu übernehmen.

(Wenn du aMuled nutzt und aMule nicht nutzen willst um aMuleWeb zu konfigurieren, lies die Anweisungen weiter unten)

Als nächstes musst du eine remote.conf generieren. Das ist die Datei, in der aMuleWeb seine Konfiguration speichert. (Sie kann im .aMule-Verzeichnis gefunden werden.) Unter anderem enthält diese Datei die Portnummer die aMule für Externe Verbindungen nutzt, wie auch das Passwort für den Zugriff auf aMule.

Um eine remote.conf-Datei zu erstellen, führe folgenden Befehl aus:

$ amuleweb -w

aMuleWeb wird alle nötigen Informationen aus der amule.conf lesen und eine remote.conf daraus generieren, danach beendet es sich wieder.

Danach starte aMuleWeb ganz normal:

$ amuleweb

Nun soltest du in der Lage sein aMuleWeb in deinem Browser zu erreichen. Durch Eingabe der URL (auf dem lokalem System):

 http://localhost:4711

oder, mit dem Hostnamen des Computers (lokal oder von entfernten Rechnern):

 http://Hostname:4711

Wenn du aMuleWeb auf einem anderen Computer als aMule laufen lassen willst, kopier einfach die remote.conf in das .aMule Verzeichnis dieses Computers, und ändere den Hostnamen darin entsprechend.

ANMERKUNG: aMuleWeb nutzt Cookies um Sitzungsdaten zu speichern. Stelle sicher, das dein Browser Cookies akzeptiert.

aMuleWeb starten

Es gibt 2 Möglichkeiten aMuleWeb zu starten.

Erste und bevorzugte ist es aMuleWeb in den Optionen von aMule zu aktivieren. Beim Starten wird dann aMule (oder aMuled) aMuleWeb aufrufen. Beim Beenden wird aMuleWeb automatisch geschlossen.

Die zweite Möglichkeite ist es aMuleWeb manuell von der Kommandoziele aus starten indem du "amuleweb" eingibst.

aMuleWeb mit aMuled konfigurieren

Als erstes: Wenn aMuled schon läuft, beende ihn.

Dann starte:

 $ amuleweb -w

um eine remote.conf-Datei zu generieren. Du musst diese Einstellungen im Bereich [ExternalConnect] vornehmen:

  • AcceptExternalConnections=1 <-- Um Externe Verbindungen zu aktivieren.
  • ECPassword=ca3c365274907c6fd527068788e14639 <-- MD5 Angabe

Danach kannst du aMuled und aMuleWeb wieder starten.

ANMERKUNG: Passwörter müssen als MD5-Prüfsumme vorliegen. Um diese zu generieren starte:

$ echo -n deinPasswortHier | md5sum | cut -d ' ' -f 1
ca3c365274907c6fd527068788e14639

Anmerkung:Falls du eine FATAL ERROR: Cannot find template: default-Meldung bekommst, hast du make install nicht ausgeführt. Wenn du aMule nicht installieren willst, kopiere das src/webserver/default/ Verzeichnis nach ~/.aMule/webserver/ (falls nötig erstellen). Wenn du eine andere Vorlage willst (vielleicht php-default), kopier dieses auch. Danach wiederhole den letzten Schritt.

aMuleWeb mit älteren aMule Versionen

Für eine Anleitung wie man aMuleWeb mit aMule vor 2.0.0 final nutzt, lies dieses Archivmaterial.

Standard Ports

Die Ports können nach belieben gesetzt werden, aber per Default nutzt aMule:

  • Externe Verbindungen: 4712
  • aMuleWeb: 4711

Achte darauf sie nicht zu verwechseln; in der Standardkonfiguration sieht das ganze so aus:

aMule --> [4712] --> aMuleWeb --> [4711] --> Webbrowser

Vorlagen (skin) Verzeichnis

aMuleWeb sucht an mehreren Orten nach seinen Vorlagen:

  • In deinem Home-Verzeichnis: $HOME/.aMule/webserver/[skin name]/
  • Und sein Installationspfad (in dieser Reihenfolge) (Standard, /usr/local/share/amule/webserver wenn du aMule kompiliert hast, oder /usr/share/amule/webserver wenn du einen Paketmanager genutzt hast).

Der Standardvorlagenname lautet 'default'.

Wenn, nach dem Installieren von aMule, aMuleWeb immernoch nicht starten will, weil er nicht auf seine Vorlagen zugreifen kann:

  • Melde uns diese Situation, und dann
  • Erstelle die Verzeichnisse webserver/default im .aMule Verzeichnis in deinem Home und kopiere den Inhalt des src/webserver Verzeichnisses aus dem aMule Quelltextarchiv (i.d.R, $HOME/.aMule/webserver/default).

aMuled und aMuleWeb als Dienste

Auch wenn die bevorzugte Methode darin besteht aMuleWeb in den Optionen von aMule zu aktivieren, kannst du aMuleWeb auch mit aMuled von einem init.d Skript starten lassen. Hier ist ein Beispiel:

/etc/init.d/amule

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
DAEMON=/usr/bin/amuled
WEB=/usr/bin/amuleweb
NAME=amuled
DESC=amuled
RUNAMULE=no
USER=Dein_aMule_Nutzername

test -x $DAEMON || exit 0

# Include amule defaults if available
if [ -f /etc/default/amule ] ; then
    . /etc/default/amule
fi

if [ "$RUNAMULE" != "yes" ] ; then
    echo "Amule not to be started. Edit /etc/default/amule first."
    exit 1
fi

set -e

case "$1" in
  start)
    echo -n "Starting $DESC: "
       su $USER -c "$DAEMON -f"
       while ! netstat -l -n -p -t | grep -q amuled ; do sleep 1 ; done
       su $USER -c "$WEB --quiet &"
    echo "$NAME."
    ;;
  stop)
    echo -n "Stopping $DESC: "
       killall --quiet --ignore-case $WEB
       killall --quiet --ignore-case $DAEMON
    echo "$NAME."
    ;;
  restart|force-reload)
    echo -n "Restarting $DESC: "
       killall --quiet --ignore-case $WEB
       killall --quiet --ignore-case $DAEMON
    sleep 1
       su $USER -c "$DAEMON -f"
       while ! netstat -l -n -p -t | grep -q amuled ; do sleep 1 ; done
       su $USER -c "$WEB --quiet &"
    echo "$NAME."
    ;;
  *)
    N=/etc/init.d/$NAME
    echo "Usage: $N {start|stop|restart|force-reload}" >&2
    exit 1
    ;;
esac

exit 0

Lass dieses Skript einfach beim Booten ausführen. Bei Debian wird das mit folgendem Befehl erreicht:

update-rc.d amule defaults

Damit die Dienste auch starten musst du noch die Datei /etc/default/amule mit folgendem Inhalt anlegen:

RUNAMULE=yes

Vorlagenentwicklung

aMuleWeb Vorlagen sind stinknormale HTML-Dateien. Um sie "interaktiv" werden zu lassen, wird eine Server-basierende Skriptsprache 3ingefügt. Das ist eine abgespeckte From von PHP. Mehr Informationen darüber findest du hier.

Wohin mit Problemem und Fragen?

Für Probleme oder Fragen melde dich einfach im Forum oder im IRC Kanal #amule auf irc.freenode.net

Andere Informationsquellen

Lese die aMuleWeb Manpage, welche in Englisch, Französisch, Deutsch, Ungarisch und Spanisch vorliegt.

Für weiterführende Informationen lies die aMuleWeb FAQ.