AMule

Attenzione. Questa guida è da considerarsi abbandonata, per via del tempo trascorso dall'ultima verifica. Potrà essere resa obsoleta, previa segnalazione sul forum, se nessuno si propone per l'adozione.

Versioni Compatibili Debian 4 "etch" Debian 5 "lenny" Debian 6 "squeeze" Debian 7 "wheezy"

Introduzione

aMule è un programma che si propone come un eMule multipiattaforma. Attualmente non ha tutte le funzionalità di emule, pur avendo tutte le più importanti, ma è disponibile sia in versione completa che di solo demone.

La versione completa non è altro che una versione simile ad emule, cioè programma ed interfaccia grafica assieme, mentre la versione demone separa il programma dall'interfaccia così che gli utenti che lo desiderano possono installare o il solo demone o la sola interfaccia. Quest'ultima soluzione risulta particolarmente utile per chi ha un PC dedicato a scaricare, per esempio un piccolo server domestico, il quale o non viene mai spento o comunque è quasi sempre acceso; in tale circostanza il PC su cui far girare aMule viene spesso gestito da remoto attraverso un secondo PC. Da qui la convenienza di avere il programma e l'interfaccia separati.

NOTA: gli abbonati Fastweb per evitare problemi (ID basso, etc) devono usare aMule-adunanza. Negli altri casi eventuali problemi sono probabilmente da imputare ad una non corretta configurazione del proprio router/firewall (se ne possiede uno) e/o al proprio provider.

Installazione

I pacchetti di aMule sono disponibili sia nei repository ufficiali di Debian che in quello di amule.org, tuttavia è da notare che generalmente la versione del repository ufficiale non è aggiornata come quella del secondo. Si noti che la versione adunanza non è disponibile nei repository ufficiali.

Nel seguito si descriverà l'installazione della versione standard. Per la versione adunanza la procedura è probabilmente ancora valida a patto che l'utente trovi autonomamente un repository da cui installarla.

NOTE:

• Installare su uno stesso computer il demone e la versione completa è assolutamente inutile.
• Le interfacce, testuali o grafiche, servono solo per gestire il demone di amule, pertanto se si installa la versione completa non servono, a meno che non si abbia anche la necessità di gestire un demone di aMule installato su un altro computer.

Repository ufficiali

Versione completa:

# apt-get install amule

Versione demone:

# apt-get install amule-daemon

Interfaccia a riga di comando aMuleCMD, da installare obbligatoriamente almeno sul computer su cui gira il demone:

# apt-get install amule-utils

Interfaccia grafica aggiuntiva aMuleGUI, essendo di base già disponibile un interfaccia web:

# apt-get install amule-utils-gui

Repository non ufficiali Testing

Questa sezione riguarda l'installazione di aMule su Debian Testing a 32 bit con linea ADSL 7Mb, ma le indicazioni e i link sono validi per altre distro.

Ho optato per la versione più aggiornata e ho così modificato il mio file etc/apt/sources.list, aggiungendo:

 # amule CVS
 deb http://www.vollstreckernet.de/debian/ testing amule 

poi ho aggiunto la GPG Key:

  gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60
  gpg -a --export 50D0AE60 > /tmp/key
  # apt-key add /tmp/key 

Per installarlo come root eseguo:

 # apt-get update
 # apt-get install amule 

per aggiungere all'interfaccia grafica la lingua italiana, altrimenti è in inglese:

 # apt-get install amule-i18n-it 

Ora il programma è installato e funzionante, così dando per scontato che sappiate come si usa questo client P2P, non mi dilungherò sulla configurazione di base.

Repository non ufficiali Stable

 deb http://www.vollstreckernet.de/debian/ testing amule-stable wx 

oppure:

 deb http://www.vollstreckernet.de/debian/ stable amule-stable wx 

If you have wx from somewhere else, you can ommit it in theses lines, but don't cry if it won't work.

aMule CVS release

Per Debian Testing. In molti casi funziona anche con sid/unstable:

 deb http://www.vollstreckernet.de/debian/ testing amule 

Per Debian Stable:

 deb http://www.vollstreckernet.de/debian/ stable amule 

If you need a recent Version of wx (2.8 atm), just append " wx" to the lines above. Be careful, between amule and wx is a space needed. If you only want wx binaries installed, replace amule with wx.

GPG Key

I pacchetti sono segnati con una firma GPG, seguire i seguenti passi:

 gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60
 gpg -a --export 50D0AE60 > /tmp/key
 # apt-key add /tmp/key  

Oppure utilizzando sudo "sudo":

 gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60
 gpg -a --export 50D0AE60 | sudo apt-key add - 

Migrare da emule ad aMule

aMule presenta un'organizzazione di file ed impostazioni simile ad emule, in particolare alcuni file ed impostazioni possono essere traferite pari pari da eMule ad aMule; a titolo d'esempio i file temporanei e il file ipfilter.dat funzionano senza problemi tali e quali in aMule. Sul sito ufficiale di aMule esiste una guida in inglese che spiega nel dettaglio come migrare da eMule ad aMule, specificando quali impostazioni/file possono essere trasferiti con successo e quali invece no.

Utilizzo e Configurazione

Versione Completa

Per un approfondimento vi mando alla pagina principale del wiki di amule, lì potrete trovare informazioni utili per installare e/o compilare amule per diverse distro e diversi sistemi operativi.

Se avete problemi con aMule potete scrivere nel Forum o cercare la soluzione a problemi comuni che vi sono accaduti.

Per chi masticasse poco l'inglese è possibile fare riferimento, per le impostazioni comuni, al sito italiano di eMule , che per la parte generica come ID basso o altro è simile se non uguale.

Avendo usato emule già da diversi anni ho trovato un attimo di smarrimento con l'interfaccia grafica che è leggermente diversa ma bastano pochi minuti per abituarcisi.

Se uno ha già usato emule o altri client simili modificati non troverà alcun problema.

Noto con piacere che la stabilità un tempo incerta è ora cosa di fatto ho constatato che anche l'uso di risorse è diminuito facendo un paragone con ciò che usavo prima ovvero emule-morphXT con wine.

Come test ho lasciato in esecuzione amule per 48 ore e nelle ore diurne il PC è stato usato normalmente per la navigazione e altro.

Non ho mai avuto crash e la memoria occupata da amule non ha mai superato i 150 Mb a parità di impostazioni con l'altra soluzione.

Versione Demone

Il demone può essere avviato/fermato attraverso il file binario amuled oppure tramite lo script /etc/init.d/amule-daemon.

File binario amuled

Primo avvio

Digitare da terminale:

$ amuled

Se si ricevono dei messaggi d'errore ignorarli (questo avvio è servito semplicemente per far generare automaticamente dei file, tra cui quello di configurazione). Premere CTRL+C per terminarne l'esecuzione.

NOTE Amuled viene eseguito con gli stessi permessi dell'utente che avvia il demone. Prima di poter lanciare amuled con successo è necessario impostare sia una password che configurarlo per accettare connessioni esterne, ovvero connessioni da interfacce testuali o grafiche.

Successivi avvii

Una volta configurato il demone (si veda l'apposita sezione) è sufficiente digitare da terminale:

$ amuled -f

Il demone stamperà un paio di messaggi e poi continuerà a girare in background. Questo significa che è possibile sloggarsi e/o fare altro senza che questo comporti l'arresto dell'esecuzione di amule-daemon.

NOTE Per questioni di sicurezza è caldamente Sconsigliato l'avvio del demone come root. In caso di crash è possibile che il file di configurazione amule.conf venga danneggiato e sostituito con una copia base dello stesso. Se il parametro AcceptExternalConnections è impostato su 0 il demone dopo essere stato avviato si arresta immediatamente (senza stampare a video particolari messaggi d'errore).

amule-daemon script

Se si vuole che il demone parta automaticamente all'avvio del proprio computer, nonché di poterlo avviare e fermare attraverso questo script, è necessario editare il file /etc/default/amule-daemon e specificare nella seguente riga

AMULED_USER=""

il nome dell'utente che lo script userà per gestire il demone, ad esempio

AMULED_USER="sempronio"

L'utente sempronio deve essere già esistente. È consigliabile come sempre utilizzare un utente senza privilegi di amministratore, magari creandone uno apposito (se già non lo si possiede) da usare per i vari demoni in generale, tra cui appunto anche amule-daemon. In tal caso l'utente potrebbe valutare di disabilitare la possibilità di login per l'utenza dedicata ai vari demoni, in modo da rafforzare ulteriormente la sicurezza.

Configurazione

NOTE Tutti i file dell'applicativo si trovano nella cartella ~/.aMule/, compreso il file amule.conf contenente la maggior parte delle impostazioni modificabili dall'utente.

Impostazione della password

È necessario impostare una password per regolare l'accesso al demone, operazione che può essere svolta in due modi.
Primo modo
Digitare da terminale:

$ amuled -e

Seguire le istruzioni a video. La password scelta sarà visibile nel file amule.conf in corrispondenza della voce ECPassword della sezione [ExternalConnect]. Si noti che questa password viene salvata criptata (in md5), pertanto quel che si vedrà sarà solo una lunga stringa di caratteri casuali, non la parola digitata.

Secondo modo
Prevede di stampare a video la propria password criptata (in md5) e di copiare il risultato nel file amule.conf in corrispondenza della voce ECPassword della sezione [ExternalConnect]. Il comando per stampare a video la propria password criptata è il seguente:

$ echo -n "miapassword" | md5sum | awk '{print $1}'

Dove miapassword è appunto la password scelta dall'utente. Si noti che se come miapassword si usa proprio miapassword il risultato è la stringa 4c3e02877eb65b74b6a0882fa4406962. In sintesi nel file amule.conf dovrà esserci una riga del tipo:

ECPassword=4c3e02877eb65b74b6a0882fa4406962

amule.conf

In questa sezione si descrivono i parametri di più comune interesse, per un elenco esaustivo si veda invece questa pagina.

[eMule]
MaxUpload=0
MaxDownload=0
SlotAllocation=2
Port=4662
UDPPort=4672
TempDir=/home/nome_utente/.aMule/Incoming
IncomingDir=/home/nome_utente/.aMule/Temp

[ExternalConnect]
AcceptExternalConnections=1
ECPort=4712
ECPassword=4c3e02877eb65b74b6a0882fa4406962

[WebServer]
Enabled=1
Password=4c3e02877eb65b74b6a0882fa4406962
Port=4711

[emule]

• MaxUpload e MaxDownload definiscono banalmente i limiti alla velocità per l'invio e la ricezione dei file in kB/s. È possibile indicare un qualsiasi valore, ma evidentemente indicare dei valori superiori a quelli propri della propria connessione non farà inviare/scaricare più rapidamente... l'utilità sta proprio nella possibilità di ridurre il quantitativo di banda che aMule utilizzerà rispetto al massimo teorico. Il valore "0" significa nessun limite.
• SlotAllocation definisce quanti kB/s riservare ad ogni client che richiede un file a noi. In pratica definisce anche a quante persone permettiamo di scaricare contemporaneamente da noi, per es. indicando MaxUpload=30 e SlotAllocation=5 permetteremo al più a 6 persone di scaricare contemporaneamente da noi.
• Port e UDPPort definiscono i numeri di porta che aMule usa per "connettersi a internet". Queste sono le porte che devono essere reindirizzate sull'eventuale router della nostra LAN e/o aperte sull'eventuale firewall del PC su cui si è installato amule-daemon. È possibile specificare un qualsiasi valore diverso da quelli proposti purché inferiore a 65535 e maggiore di 1024, nonché diverso da eventuali numeri già utilizzati da altri programmi (in genere oltre il 10000 è quasi impossibile beccare un numero di porta già usato).
• TempDir e IncomingDir definiscono banalmente le cartelle dove vengono salvati i file temporanei e quelli completati. Si noti il punto prima di aMule, che rende la suddetta cartella nascosta.

[ExternalConnect]

• AcceptExternalConnections se impostato su 1 permette di amministrare il demone con interfacce tipo amulecmd e amuleGUI.
• ECPort è la porta usata sia da aMuleCMD che aMuleGUI per connettersi ad amule-daemon. Se questa porta viene bloccata da un firewall e/o da un router (quest'ultimo caso solo se si tenta di accedere ad amule-daemon dall'esterno della LAN cui appartiene il PC su cui è installato il demone) allora non sarà possibile controllare il demone da remoto con le suddette interfacce (ma potrebbe sempre essere possibile collegarsi tramite ssh al server e da lì usare amulecmd).

[WebServer]

• Enabled se impostato su 1 permette di amministrare il demone tramite interfaccia web. Si noti che è anche possibile evitare di rendere disponibile l'interfaccia web all'avvio del demone, in tal caso è sempre possibile avviarla successivamente tramite il comando amuleweb (si veda la relativa pagina man).
• Port è la porta usata dal Web Server di aMule. Vale quanto detto al punto precedente per ECPort.

Interfacce

Come già scritto ad inizio pagina le interfacce servono esclusivamente per amministrare il demone, e non la versione completa di aMule; si è inoltre parlato di tre tipi di interfacce: testuale, grafica e web.

ATTENZIONE solo l'interfaccia testuale amulecmd permette di arrestare il demone

In genere ogni interfaccia memorizza i suoi parametri nel file ~/.aMule/remote.conf del computer su cui viene eseguita, con l'eccezione dell'interfaccia web che essendo gestita direttamente dal webserver del demone viene configurata direttamente tramite il file ~/.aMule/amule.conf.

aMuleCMD

Per amministrare il demone dal pc su cui questo è in esecuzione è sufficiente digitare:

$ amulecmd

Se si è impostata una password verrà richiesto di inserirla, dopo di che verrà mostrato il prompt di aMuleCMD (amulecmd$ ). Da qui è possibile digitare i vari comandi, di cui se ne riportano alcuni:

• help, mostra l'elenco dei comandi disponibili.
• exit, termina aMuleCMD, ma non il demone.
• shutdown, termina sia aMuleCMD che il demone.
• show dl, mostra l'elenco dei file da scaricare.
• connect, connette ad un server ed2k disponibile ed alla rete kad. Digitare connect ip_ed2k_server:port per connettersi ad uno specifico server ed2k, digitare connect kad per connettersi alla sola rete kad.

Se si vuole amministrare il demone da un altro PC è necessario, oltre naturalmente ad aver installato aMuleCMD sul suddetto PC, editare il file ~/aMule/remote.conf.
NOTA: remote.conf viene usato anche da aMuleGUI per memorizzare le sue impostazioni.
Nel suddetto file deve essere contenuto almeno quanto segue:

[EC]
Host=indirizzo_server
Port=porta
Password=password_utente

dove indirizzo_server è il nome o l'indirizzo IP del PC su cui gira aMule, porta è la porta specificata nel parametro ECPort del file amule.conf sul server e password_utente è la password criptata in md5 e specificata nel parametro ECPassword del medesimo file di configurazione. Alternativamente è possibile specificare i suddetti parametri direttamente da terminale digitando:

$ amulecmd -h indirizzo_server -p porta -P password_utente

È anche possibile passare direttamente i comandi con l'opzione -c, ad esempio:

$ amulecmd -c 'show dl'
$ amulecmd -c shutdown
$ amulecmd -h indirizzo_server -p 4712 -P password_utente -c shutdown
ecc.

aMuleGUI

C'è veramente poco da dire. Richiede la presenza di un ambiente grafico come GNOME, sfrutta lo stesso file remote.conf di aMuleCMD per archiviare le impostazioni e attualmente non permette di terminare l'esecuzione del demone. Una volta cliccato sulla relativa icona per avviarlo viene proposta una schermata in cui si richiede di inserire password, indirizzo e porta. Se la connessione ha successo si apre una finestra molto simile a quella di aMule e emule.

Web

Anche in questo caso c'è poco da dire. È sufficiente aprire una finestra di un browser qualsiasi, immettere nel campo indirizzo quello del computer su cui gira amule-daemon con relativa porta (es.: http://mio_server:4711), quindi immettere la propria password nella schermata di login che appare.

Firewall/Router

ATTENZIONE il computer su cui è in esecuzione aMule, versione completa o demone non fa differenza, deve avere un indirizzo IP statico nel caso si usi un modem-router per connettersi a internet

Le porte che devono essere aperte su un router e/o sul firewall del computer su cui è in esecuzione aMule sono tipicamente:

• [emule] Port, 4662 tipo TCP
• [emule] UDPPort, 4672 tipo UDP
• [ExternalConnect] ECPPort, 4712 tipo TCP
• [WebServer] Port, 4711 tipo TCP

Se le prime due sono bloccate si scaricherà molto lentamente (spia connettività gialla, se disponibile) sia che si usi la versione completa che quella ridotta. Le ultime due porte riguardano di norma solo il demone: se sono bloccate non ci saranno problemi ad amministrare amule-daemon fintanto che vi si connette dall'interno della propria LAN; al contrario risulterà impossibile connettersi al demone dall'esterno della propria LAN, quindi sarà impossibile amministrarlo (ma amule-daemon di per se funzionerà normalmente, ovvero continuerà a scaricare tutti file già in coda e ad inviare quelli in condivisione).

In questa guida non ci si occupa di come configurare correttamente un firewall/router poiché la procedura è variabile in base al prodotto usato. L'utente dovrà quindi eventualmente cercare altrove una guida per aprire e reindirizzare correttamente le connessioni necessarie verso la macchina su cui è in esecuzione il demone. Come punto di partenza si può utilizzare questa Guida.

Sicurezza

Per non dimenticare la sicurezza vorrei suggerire l'uso di Moblock_-_mobloquer con il quale potrete filtrare gli IP che minacciano (teoricamente) la vostra privacy.

MoBlock

Per l'installazione sulla nostra Debian Testing aggiungiamo al file etc/apt/sources.list:

 #Debian lenny (testing):
 deb http://moblock-deb.sourceforge.net/debian lenny main
 deb-src http://moblock-deb.sourceforge.net/debian lenny main 

e carichiamo la GPG Key:

 gpg --keyserver wwwkeys.eu.pgp.net --recv 9072870B
 gpg --export --armor 9072870B | sudo apt-key add - 

per l'installazione, con i permessi di root:

 # apt-get update
 # apt-get install moblock
 # apt-get install mobloquer 

In questo modo anche la nostra macchina Linux potrà scaricare tranquilla e sicura.

Riferimenti Esterni

• Sito Ufficiale aMule .
• Wiki di aMule .
• Forum di aMule.
• emule, sito italiano.
• Guida alla configurazione di porte dati per svariati router in commercio. È comunque imprescindibile fare riferimento al manuale istruzioni specifico del proprio router.

Suggerimento Per favore se modifichi questa guida aggiungi nel box "NOTE" sottostante "Estesa da: mio_nome_utente", se invece l'hai semplicemente consultata, ma ne hai verificato personalmente la correttezza aggiungi sempre nello stesso box "Verificata da: mio_nome_utente". In questo modo aiuti la comunità a tenere traccia della maturità della guida.

NOTE Autore: Mm-barabba Esteso da Wtf 20:54, 29 mag 2011 (CEST)