Difference between revisions of "AMule (简体中文)"

From ArchWiki
Jump to: navigation, search
Line 4: Line 4:
 
{{Lowercase title}}
 
{{Lowercase title}}
 
{{translateme (简体中文)}}
 
{{translateme (简体中文)}}
aMule 是一个类似于 eMule 的 eD2k 和 Kademlia 网络的跨平台客户端 。
+
 
 +
aMule是一个跨平台的eD2k和Kademlia网络客户端,类似于eMule,即电驴客户端。
  
 
==安装==
 
==安装==
官方库中有amule的安装包,如果想要安装官方库中的版本,只需要在终端内输入:
+
[[Official Repositories (简体中文)|官方源]]提供了软件包{{Pkg|amule}}。另外,[[AUR (简体中文)|AUR]]中的{{AUR|amule-dlp}}软件包支持[https://code.google.com/p/amule-dlp/ 动态吸血保护](旧版本)。
# pacman -S amule
+
aMuled是一个没有图形用户界面(GUI)的全能的aMule命令行程序,也可以称之为守护程序。你可以通过安装图形界面的amule图形前端,或者通过amuleweb访问,或者用amulecmd模式,对其工作进行控制。
+
  
 +
'''amuled'''是aMule的后台守护进程。其前端有GTK的aMuleGUI、网页版的aMuleWeb、命令行的aMuleCmd。
  
  
 
==配置==
 
==配置==
===amule守护程序(amuled)===
+
最简单的使用方式,命令行输入amule或直接点击系统菜单启动aMule即可。以下将把amule配置为系统级服务(守护进程)。
  
 +
===amule 守护进程(amuled)===
 
===创建配置文件===
 
===创建配置文件===
首先,我们需要创建一个用户来运行amule守护程序:
+
首先,需要创建一个用户来运行amule守护程序:
 
  # useradd -m -d /srv/amule -s /bin/bash amule
 
  # useradd -m -d /srv/amule -s /bin/bash amule
然后,我们要立即运行amule守护程序来建立配置文件:
+
 
  #su amule
+
然后,打开shell,登录用户{{ic|amule}},首次运行{{ic|amuled}}来建立配置文件:
  #amuled --ec-config
+
  # su amule
接下来,amule守护程序会让你输入一个密码,随便输入什么都行,这个无关紧要(例如amule),然后按Ctrl-C停止amule守护程序。
+
  $ amuled --ec-config
 +
 
 +
Now amuled will ask you for a temporary password, enter something (amule for example, this does not matter), and use Ctrl-C to terminate amuled.
 +
接下来,amule守护程序会请求输入一个临时的密码,随便输入什么都行(例如amule),然后按{{keypress|Ctrl-C}}停止amuled。
  
 
===编辑配置文件===
 
===编辑配置文件===
现在,我们要正确配置amule让其正常运行。首先,需要给连接守护进程的外部程序或者连接建立一个密码,以便其访问amule守护进程。
+
现在,我们要正确配置amuled,让其正常运行。
$ echo -n <your password here> | md5sum | cut -d ' ' -f 1
+
首先,为链接amuled的外部程序设置密码:
上面这行命令是生成一个加密后的密码,现在你可以编辑配置文件了。
+
$ echo -n <这里是密码> | md5sum | cut -d ' ' -f 1
$ nano /srv/amule/.aMule/amule.conf
+
 
在[ExternalConnect]下面,设置如下:
+
上述命令将密码加密输出。接下来,编辑配置文件,添加下列内容到[ExternalConnect]部分:
 +
{{hc|1=/srv/amule/.aMule/amule.conf|2=
 
AcceptExternalConnections=1
 
AcceptExternalConnections=1
 
ECPassword=<encrypted password>
 
ECPassword=<encrypted password>
 +
}}
 +
 +
===创建开机自启动脚本===
 +
{{注意|按说这些东西应该由amule软件包提供的,BT客户端transmission就是那样做的。}}
 +
 +
要开机启动amuled,需要手动建立一个守护进程脚本{{ic|/etc/rc.d/amuled}}:
 +
 +
# touch /etc/rc.d/amuled
 +
 +
文件内容如下,请自行复制:
  
===创建开机启动项(Creat Deamon)===
+
{{bc|<nowiki>
Note: 可能将amule安装包和默认的配置文件放在一起是一个更好的选择,就像下载时,将临时文件与结束文件放到一起一样(这句话勉强翻译,有理解透的可以加以修改)(It is probably better to include these configuration files by default with amule package, like it is done with transmission.)
+
想要开机启动的amule守护进程的话,我们需要在这里设置一个开机项  /etc/rc.d/amuled:
+
# touch /etc/rc.d/amuled
+
然后将下面这些内容复制到配置文件:
+
 
#!/bin/bash
 
#!/bin/bash
 
DAEMON=amuled
 
DAEMON=amuled
Line 80: Line 91:
  
 
exit 0
 
exit 0
 +
</nowiki>}}
  
然后赋予他可执行的权限:
+
添加可执行的权限:
# chmod 755 /etc/rc.d/amuled
+
# chmod 755 /etc/rc.d/amuled
然后在 /etc/rc.conf  添加上 “amuled”,想下面这样,他就可以开机启动了。
+
DAEMONS=( ... network amuled ... )
+
  
也可以通过创建下列配置文件来运行amuleweb:
+
编辑{{ic|/etc/rc.conf}},配置为开机启动:
  #amuleweb --write-config --password=amule --admin-pass=amule
+
  DAEMONS=( ... network '''amuled''' ... )
  
我们现在可以把p2p的shell设置为/bin/false如果我们我们不像在计算机里给它提供shell
+
===amuleweb===
 +
{{注意|较之amulegui,amuleweb功能单薄,输出的下载信息也少,而且经常要求输入密码(让浏览器记住密码会好一些)。基于以上原因,建议使用amulegui,并忽略本节。}}
 +
====创建配置文件====
 +
还是使用之前配置amuled时的那个新用户,启动amuleweb以初始化配置文件:
 +
$ amuleweb --write-config --password=''<这里是密码>'' --admin-pass=<这个是网页登录密码>
  
编辑/etc/password并且把/bin/bash替换为/bin/false
+
<这里是密码>处填写之前配置amuled使用的密码(未加密的),<这个是网页登录密码>处填写登录网页界面时输入的密码。
  p2p:x:1001:1001::/home/p2p:/bin/false
+
  
 +
===创建开机自启动脚本===
 +
创建{{ic|/etc/rc.d/amuleweb}}:
  
==amuled 服务==
+
# touch /etc/rc.d/amuleweb
  
创建 /etc/rc.d/amuled :
+
内容如下:
<pre>
+
#!/bin/bash                                                                                                 
+
  
NAME=$(basename "$0")
+
{{bc|<nowiki>
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
+
#!/bin/bash
DAEMON=/usr/bin/amuled                                         
+
DAEMON=amuleweb
WEB=/usr/bin/amuleweb                                          
+
USER=amule
DESC=amuled                                                     
+
USER=p2p #A user who already ran amule once to configure it.   
+
  
test -x "$DAEMON" || exit 0
+
. /etc/rc.conf
 +
. /etc/rc.d/functions
  
 
case "$1" in
 
case "$1" in
  start)    
+
  start)
   echo -n "Starting $DESC: "
+
   stat_busy "Starting $DAEMON"
      su "$USER" -c "$(printf "%q -f" "$DAEMON" )"
+
  su "$USER" -l -s /bin/sh -c "$(printf "%q --quiet &" "/usr/bin/amuleweb" )"
      su "$USER" -c "$(printf "%q --quiet &" "$WEB" )"
+
   if [ $? = 0 ]; then
   echo "$NAME."
+
    add_daemon $DAEMON
 +
    stat_done
 +
  else
 +
    stat_fail
 +
    exit 1
 +
  fi
 
   ;;
 
   ;;
 
  stop)
 
  stop)
   echo -n "Stopping $DESC: "
+
   stat_busy "Stopping $DAEMON"
    killall --quiet --ignore-case "$WEB"
+
  killall --quiet --ignore-case "/usr/bin/amuleweb"
     killall --quiet --ignore-case "$DAEMON"
+
  if [ $? = 0 ]; then
   echo "$NAME."
+
     rm_daemon $DAEMON
 +
    stat_done
 +
   else
 +
    stat_fail
 +
    exit 1
 +
  fi
 
   ;;
 
   ;;
 
  restart|force-reload)
 
  restart|force-reload)
   echo -n "Restarting $DESC: "
+
   $0 stop
      killall --quiet --ignore-case "$WEB"
+
      killall --quiet --ignore-case "$DAEMON"
+
 
   sleep 1
 
   sleep 1
      su $USER -c "$DAEMON -f"
+
   $0 start
      su $USER -c "$WEB --quiet &"
+
   echo "$NAME."
+
 
   ;;
 
   ;;
 
  *)
 
  *)
Line 139: Line 157:
  
 
exit 0
 
exit 0
</pre>
+
</nowiki>}}
 +
 
 +
添加可执行权限:
 +
# chmod 755 /etc/rc.d/amuleweb
 +
 
 +
编辑{{ic|/etc/rc.conf}},配置开机启动:
 +
DAEMONS=( ... network amuled '''amuleweb''' ... )
 +
 
 +
{{注意|amuleweb必须在amuled之后启动,否则amuleweb无法运行。}}
 +
 
 +
{{注意|之后记得把用户amule的默认shell设置为'''/bin/false''',这样别人就无法使用该用户启动shell了:编辑{{ic|/etc/passwd}},将用户amule项的'''/bin/bash'''替换为'''/bin/false'''(其他部分内容与示例可能有所区别,请不要随意改动):
 +
amule:x:1001:1001::/srv/amule:/bin/false
 +
}}
 +
 
 +
==使用==
 +
启动amuled、amuleweb(如果需要):
 +
# rc.d start amuled
 +
# rc.d start amuleweb
 +
 
 +
然后,可以访问地址http://127.0.0.1:4711链接amuleweb,或者使用`amulegui`或`amulecmd`控制amule。
  
赋予它可执行权限
+
{{小贴士|如果默认获取KAD节点(nodes.dat)的地址无效,可以从如下地址获取: http://nodes-dat.com 。}}
#sudo chmod 755 /etc/rc.d/amuled
+
  
现在你可以通过amuleGUI来远程连接amuled。你也可以使用http://yourserver:4711/ 地址来通过amuleweb连接。
+
更多信息,参见:[http://wiki.amule.org/index.php/Getting_Started Getting_Started at aMule wiki]。

Revision as of 12:27, 13 July 2012

Tango-preferences-desktop-locale.png本页面需要更新翻译,内容可能已经与英文脱节。要贡献翻译,请访问简体中文翻译组Tango-preferences-desktop-locale.png

附注: please use the first argument of the template to provide more detailed indications.

aMule是一个跨平台的eD2k和Kademlia网络客户端,类似于eMule,即电驴客户端。

安装

官方源提供了软件包amule。另外,AUR中的amule-dlpAUR软件包支持动态吸血保护(旧版本)。

amuled是aMule的后台守护进程。其前端有GTK的aMuleGUI、网页版的aMuleWeb、命令行的aMuleCmd。


配置

最简单的使用方式,命令行输入amule或直接点击系统菜单启动aMule即可。以下将把amule配置为系统级服务(守护进程)。

amule 守护进程(amuled)

创建配置文件

首先,需要创建一个用户来运行amule守护程序:

# useradd -m -d /srv/amule -s /bin/bash amule

然后,打开shell,登录用户amule,首次运行amuled来建立配置文件:

# su amule
$ amuled --ec-config

Now amuled will ask you for a temporary password, enter something (amule for example, this does not matter), and use Ctrl-C to terminate amuled. 接下来,amule守护程序会请求输入一个临时的密码,随便输入什么都行(例如amule),然后按Template:Keypress停止amuled。

编辑配置文件

现在,我们要正确配置amuled,让其正常运行。 首先,为链接amuled的外部程序设置密码:

$ echo -n <这里是密码> | md5sum | cut -d ' ' -f 1

上述命令将密码加密输出。接下来,编辑配置文件,添加下列内容到[ExternalConnect]部分:

/srv/amule/.aMule/amule.conf
AcceptExternalConnections=1
ECPassword=<encrypted password>

创建开机自启动脚本

注意: 按说这些东西应该由amule软件包提供的,BT客户端transmission就是那样做的。

要开机启动amuled,需要手动建立一个守护进程脚本/etc/rc.d/amuled

# touch /etc/rc.d/amuled

文件内容如下,请自行复制:

#!/bin/bash
DAEMON=amuled
USER=amule

. /etc/rc.conf
. /etc/rc.d/functions

case "$1" in
 start)
   stat_busy "Starting $DAEMON"
   su "$USER" -l -s /bin/sh -c "$(printf "%q -f>/dev/null" "/usr/bin/amuled" )"
   if [ $? = 0 ]; then
     add_daemon $DAEMON
     stat_done
   else
     stat_fail
     exit 1
   fi
   ;;
 stop)
   stat_busy "Stopping $DAEMON"
   killall --quiet --ignore-case "/usr/bin/amuled"
   if [ $? = 0 ]; then
     rm_daemon $DAEMON
     stat_done
   else
     stat_fail
     exit 1
   fi
   ;;
 restart|force-reload)
   $0 stop
   sleep 4 #1 is not enough
   $0 start
   ;;
 *)
   printf "Usage: %q {start|stop|restart|force-reload}\n" "$0" >&2
   exit 1
   ;;
esac

exit 0

添加可执行的权限:

# chmod 755 /etc/rc.d/amuled

编辑/etc/rc.conf,配置为开机启动:

DAEMONS=( ... network amuled ... )

amuleweb

注意: 较之amulegui,amuleweb功能单薄,输出的下载信息也少,而且经常要求输入密码(让浏览器记住密码会好一些)。基于以上原因,建议使用amulegui,并忽略本节。

创建配置文件

还是使用之前配置amuled时的那个新用户,启动amuleweb以初始化配置文件:

$ amuleweb --write-config --password=<这里是密码> --admin-pass=<这个是网页登录密码>

<这里是密码>处填写之前配置amuled使用的密码(未加密的),<这个是网页登录密码>处填写登录网页界面时输入的密码。

创建开机自启动脚本

创建/etc/rc.d/amuleweb

# touch /etc/rc.d/amuleweb

内容如下:

#!/bin/bash
DAEMON=amuleweb
USER=amule

. /etc/rc.conf
. /etc/rc.d/functions

case "$1" in
 start)
   stat_busy "Starting $DAEMON"
   su "$USER" -l -s /bin/sh -c "$(printf "%q --quiet &" "/usr/bin/amuleweb" )"
   if [ $? = 0 ]; then
     add_daemon $DAEMON
     stat_done
   else
     stat_fail
     exit 1
   fi
   ;;
 stop)
   stat_busy "Stopping $DAEMON"
   killall --quiet --ignore-case "/usr/bin/amuleweb"
   if [ $? = 0 ]; then
     rm_daemon $DAEMON
     stat_done
   else
     stat_fail
     exit 1
   fi
   ;;
 restart|force-reload)
   $0 stop
   sleep 1
   $0 start
   ;;
 *)
   printf "Usage: %q {start|stop|restart|force-reload}\n" "$0" >&2
   exit 1
   ;;
esac

exit 0

添加可执行权限:

# chmod 755 /etc/rc.d/amuleweb

编辑/etc/rc.conf,配置开机启动:

DAEMONS=( ... network amuled amuleweb ... )
注意: amuleweb必须在amuled之后启动,否则amuleweb无法运行。
注意: 之后记得把用户amule的默认shell设置为/bin/false,这样别人就无法使用该用户启动shell了:编辑/etc/passwd,将用户amule项的/bin/bash替换为/bin/false(其他部分内容与示例可能有所区别,请不要随意改动):
amule:x:1001:1001::/srv/amule:/bin/false

使用

启动amuled、amuleweb(如果需要):

# rc.d start amuled
# rc.d start amuleweb

然后,可以访问地址http://127.0.0.1:4711链接amuleweb,或者使用`amulegui`或`amulecmd`控制amule。

提示: 如果默认获取KAD节点(nodes.dat)的地址无效,可以从如下地址获取: http://nodes-dat.com

更多信息,参见:Getting_Started at aMule wiki