MLDonkey

MLDonkey is client for P2P networks under Linux.

The supported protocols are :

eDonkey2000
Overnet
BitTorrent
Gnutella (LimeWire)
Gnutella2
FastTrack
FileTP: HTTP, FTP and SSH
Kad Network

Moreover, it can be managed by several ways :

web interface (4080)
telnet (4000)
GUI (4001) available list here : MLDonkey Gui

Installation

Package

To install mldonkey server, add the package :

mldonkey-server

Mldonkey is installed by default in the folder /var/lib/mldonkey.

Once the install done, mldonkey is only reachable from the localhost 127.0.0.1

Setup

The following paragraps details how to customize the installation.
Then all other tunning can be done through the web interface.

Define the admin network

To allow access from other computers, we need to edit /var/lib/mldonkey/downloads.ini :

stop mldonkey : /etc/init.d/mldonkey-server stop
modify the option “allowed_ips” into /var/lib/mldonkey/downloads.ini :

 
 allowed_ips = [
  "127.0.0.1"; "192.168.10.0/24"; "192.168.11.0/24";]

start mldonkey : /etc/init.d/mldonkey-server start

Change the password

To protect the access, we need to setup a password with useradd command (telnet) :

# telnet localhost 4000
Trying 127.0.0.1...
Connected to localhost.localdomain.
Escape character is '^]'.
Welcome to MLDonkey 3.0.0
Welcome on mldonkey command-line

Use ? for help

> useradd admin xxx
Password of user admin changed

Administration

It's possible to manage mldonkey from several ways.

Interfaces

HTTP : 4080
telnet : 4000
GUI : 4001 list available here : MLDonkey Gui

Incoming connections to allow on the firewall

Network	Type	Historical default	MLdonkey default	Configuration file
eDonkey2000	TCP	4662	port = random (before 2.8.0: 4662)	donkey.ini
eDonkey2000	UDP	4672 (eMule)	TCP port + 4 (before 2.8.0: 4666)	donkey.ini
Kad	TCP	6419 (eMule)	Kademlia.port = random	donkey.ini, Kademlia section
Kad1	UDP	6429 (eMule)	Same as TCP	donkey.ini, Kademlia section
Overnet	TCP	4662	Overnet.port = random	donkey.ini, Overnet section
Overnet	UDP	No default	Same as TCP	donkey.ini, Overnet section
Gnutella	TCP	6346	client_port = 6346	gnutella.ini
Gnutella	UDP (??)	Same as TCP	client_port = 6346	gnutella.ini
Gnutella2	TCP	No default	client_port = 6347	gnutella2.ini
Gnutella2	UDP	Same as TCP	client_port = 6347	gnutella2.ini
BitTorrent	TCP	6881	client_port = 6882	bittorrent.ini
FastTrack	TCP	1214	client_port = 1214	fasttrack.ini
OpenNapster	TCP	6699	client_port = 9999	opennap.ini
DirectConnect	TCP	1412	client_port = 4444	directconnect.ini
Direct Connect	UDP	Same as TCP	client_port = 4444	directconnect.ini
Soulseek	TCP	2234	client_port = 2234	soulseek.ini

Tunning

Some usefull parameters :

client name : Options > Client > client_name
maximum upload rate : Options > Client > max_hard_upload_rate (kB/s)
maximum download rate : Options > Client > max_hard_download_rate (kB/s)
number of connections allowed : Options > Client > max_opened_connections : 929
number of indirect connections allowed : Options > Client > max_indirect_connections (percentage of max_opened_connections)
maximum connection per second allowed : Options > Client > max_connections_per_second : 100
maximum simultaneous downloads : Options > Client > max_concurrent_downloads : 100
send an email on completion : Options > Mail

clients parameters by protocol :

incoming eDonkey port : Options > Plugins > Donkey > ED2K-Ports : 4662
force the High ID : Options > Plugins > Donkey > ED2K-force_high_id : true

For information, there is two kind of ID with eDonkey :

high ID : it's the public IP of the client when it is directly reachable from the Internet
low ID : ID given by servers when the client is not reachable directly

Two low ID cannot connect together.

Backup

/etc/default/mldonkey-server
/var/lib/mldonkey/downloads.ini
/var/lib/mldonkey/donkey.ini