本篇教程基于的环境

  1. 机器是 WD MyCloud Gen2，固件版本是 2.21.126；
  2. 开发环境是基于 macOS 的基础；
  3. 需要使用 Terminal 来输入相关语句；
  4. 需要使用 Linux 语句进行相关操作;
  5. WD MyCloud 可以安装外部应用；
  6. WD MyCloud 开启 SSH 访问的功能；

WD MyCloud 相关操作

下载所需文件

从以下链接中下载整个文件夹，里面包含三个文件。

  1. WDMyCloud_aria2_1.29.0.bin(11212016) 是将 aria2 安装到 WD MyCloud 上的应用程序；
  2. aria2.conf 是 aria2 的配置文件；
  3. aria2c 是交叉编译文件，具体是做什么的，你把它理解成破译文件就行。

链接: https://pan.baidu.com/s/1jIHUkgY 密码: ex4d

安装 aria2 应用程序

登陆到 WD MyCloud，进入应用程序的安装界面，选择 WDMyCloud_aria2_1.29.0.bin(11212016) 后进行安装。

将其他两个文件复制到 config 文件夹

安装完 aria2 后，会自动生成相关的一系列文件夹。打开 Terminal 通过 ssh 登陆到 root，输入 cd ~ 进入最底层文件夹，然后输入 cd mnt/HD/HD_a2/Nas_Prog/aria2/config/ 进入 config 的文件夹。

通过 scp 的命令将 aria2.conf 和 aria2c 复制到 config 文件夹的目录里。

运行 aria2

在 Terminal 里输入如下命令即可运行。

1
2
3
4
aria2c --conf-path=/mnt/HD/HD_a2/Nas_Prog/aria2/config/aria2.conf -D
``` 

若想要 WD MyCloud 在后台持续运行，则需要输入以下命令。

nohup ./aria2c –conf-path=/mnt/HD/HD_a2/Nas_Prog/aria2/config/aria2.conf -D &

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

#### 进行 **aria2** 网页版的相关设置
登录 `http://192.168.1.11/aria2/web_yaaw/index.html` 就会显示 **aria2** 的下载列表。

选择右上角的扳手符号进行设置，将 `JSON-RPC Path` 设置成 `http://token:abcd@host:port/jsonrpc`，`abcd` 是你在 **aria2.conf** 中设置的 token，将 **host:port** 设置成你自己的地址。

设置成功后右上角会显示当前 **Aria2** 的版本，同时会有成功链接的提示。

以上就是 WD MyCloud 这一部分的全部操作，接下需要在百度网盘上进行设置。

### 百度网盘相关操作
#### 下载 aria2 的插件
在本案例下，我是使用 Google Chrome 的。

进入 Chrome Web Store，搜索 aria2 的插件，然后安装到浏览器上。

#### 设置百度网盘插件
进入百度网盘， aria2 的插件会初始化，成功后你会看到「导出下载」的选项，光标悬浮后选择「设置」按钮。如下图：
![add](/assets/img/in-post/2017-04-04/002.png)

在地址栏里输入正确的地址，本案例中应该是 `http://token:abcd@host:port/jsonrpc`，`abcd` 是你在 **aria2.conf** 中设置的 token，将 **host:port** 设置成你自己的地址。

#### 导出下载
选择你需要下载的资源，选中后有会「导出下载」的按钮，选择第一个「ARIA2 RPC」，这样就能将资源导入到 WD MyCloud 上下载了。

#### 确认下载
登录 `http://192.168.1.11/aria2/web_yaaw/index.html` 查看下载列表，如果按照以上步骤进行顺利进行的话，资源应该处于全速下载中了。

以上就是本教程的全部内容，接下来是我在安装过程中本人遇到的问题，如果你也遇到了同样的问题，可以参考如何解决的。

### FAQ 环节
#### 无法使用 ssh 登陆到 root？
如果你登陆到 root 的时候得到这样的反馈

Unable to negotiate with 192.168.1.11 port 22: no matching host key type found. Their offer: ssh-dss

1
2
3
4
5
6
7
8
9
10
你需要进行如下的操作。

第一种是简单方法：直接输入 `ssh -oHostKeyAlgorithms=+ssh-dss root@192.168.1.11`，这样就可以顺利输入密码后登录了。

第二种是一劳永逸的方法，也是值得推荐的。
1. 打开 Terminal，输入`cd ~/.ssh/`
2. 使用 `vi config` 新建一个 config 的文件，然后将下列代码直接复制进去。
3. 如果你不熟悉 Linux 的操作语言，输入 `vi config` 后输入 `i` 进行编辑，使用 `command + v` 可以将代码粘贴进去，按下 `esc` 后再输入 `:x` 就可以保存退出该文件了。

`config` 的配置文件：

Host my.host.com .myinsecure.net 192.168.1. 192.168.2.*
HostKeyAlgorithms ssh-dss
KexAlgorithms diffie-hellman-group1-sha1

1
2
3

#### 如何将文件从 macOS 复制到 Linux 上？
使用 `scp` 的语句即可实现 macOS 和 Linux 之间的文件互传。在本篇教程中，我们需要将 aria2 的两个文件复制粘贴到 MyCloud aria2 的根目录里，即`/mnt/HD/HD_a2/Nas_Prog/aria2/config/`。假设 aria2 在 macOS 桌面上，需要使用的语句如下：

scp -r /Users/weixia/Desktop/aria2c root@192.168.1.11:/mnt/HD/HD_a2/Nas_Prog/aria2/config/
scp -r /Users/weixia/Desktop/aria2.conf root@192.168.1.11:/mnt/HD/HD_a2/Nas_Prog/aria2/config/

1
2
3
4
输入后 Terminal 会提示要你输入密码，成功输入密码后，就可以顺利地将 aria2c 和 aria2.conf 两个文件之间复制到 `/mnt/HD/HD_a2/Nas_Prog/aria2/config/` 的目录里。

#### RPC 报错，无法捆绑 TCP 怎么办？
输入 `aria2c --conf-path=/mnt/HD/HD_a2/Nas_Prog/aria2/config/aria2.conf` 之后报错，得到以下的 error message。

04/04 21:51:30 [^[[1;31mERROR^[[0m] IPv4 RPC: failed to bind TCP port 6800
Exception: [SocketCore.cc:312] errorCode=1 Failed to bind a socket, cause: Address already in use

04/04 21:51:30 [^[[1;31mERROR^[[0m] IPv6 RPC: failed to bind TCP port 6800
Exception: [SocketCore.cc:312] errorCode=1 Failed to bind a socket, cause: ai_family not supported

04/04 21:51:30 [^[[1;31mERROR^[[0m] Exception caught
Exception: [DownloadEngineFactory.cc:219] errorCode=1 Failed to setup RPC server.

1
第一，需要在 aria2.conf 的配置里禁用 IPv6，添加如下代码即可：

禁用IPv6, 默认:false

disable-ipv6=true

1
第二，在 Terminal 里输入

aria2c –conf-path=/mnt/HD/HD_a2/Nas_Prog/aria2/config/aria2.conf -D

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
即可让 Aria2 开始工作。

#### 无法成功登陆 Aria2，RPC 服务器报错
先查看你使用的 Aria2 是哪个版本？
1. v1.18.6以上：使用 `rpc-secret=abcd` 登陆的，此时登陆选项设置应该是 `http://token:abcd@host:port/jsonrpc`
2. v1.15.2 - v1.18.5：使用 `--rpc-user=user --rpc-passwd=pwd` 登陆的，此时的登陆选项设置应该是 `http://user:pwd@host:port/jsonrpc`

RPC 的设置在 **aria.conf** 的文件里，需要看清楚是什么。

登陆选项设置需要在两个地址设置：
1. 在下载器里设置，就是 YAAW 里将地址设置成对的地址；
2. 在百度网盘的导出下载里，也需要将地址设置成对的地址。

#### 查询端口使用情况
如果在报错里出现 `Address already in use`，不妨查查是哪个程序占用了这个端口。
在 Ternimal 里输入 `sudo netstat -nlpt` 即可查询端口使用情况，还能看到是哪个程序。

#### Public 文件夹无故消失了怎么办？
进入 WD MyCloud 的控制面板，找到「共享」一栏，然后添加共享文件夹，一般情况下是添加 Public 文件夹，根据你之前的设置而添加。如下图：
![add](/assets/img/in-post/2017-04-04/001.png)

### 参考
* [Mac Linux Terminal: SSH File Transfer](https://www.youtube.com/watch?v=EJOoiYtyPTE)
* [SSH returns: no matching host key type found. Their offer: ssh-dss](http://askubuntu.com/questions/836048/ssh-returns-no-matching-host-key-type-found-their-offer-ssh-dss)
* [10 basic examples of linux netstat command](http://www.binarytides.com/linux-netstat-command-examples/)
* [Aria2 & YAAW 使用说明](http://aria2c.com/usage.html)
* [aria2配置示例](https://binux.blog/2012/12/aria2-examples/)
* [使用Aria2下载百度网盘和115的资源](https://blog.icehoney.me/posts/2015-01-31-Aria2-download)
* [Aria2 & YAAW 使用说明](http://aria2c.com/usage.html)


### 下载
**aria2.conf** 配置文件（仅供参考）

‘#’开头为注释内容, 选项都有相应的注释说明, 根据需要修改

被注释的选项填写的是默认值, 建议在需要修改时再取消注释

文件保存相关

文件的保存路径(可使用绝对路径或相对路径), 默认: 当前启动位置

dir=/shares/Public/Aria2

启用磁盘缓存, 0为禁用缓存, 需1.16以上版本, 默认:16M

#disk-cache=32M

文件预分配方式, 能有效降低磁盘碎片, 默认:prealloc

预分配所需时间: none < falloc ? trunc < prealloc

falloc和trunc则需要文件系统和内核支持

NTFS建议使用falloc, EXT3/4建议trunc, MAC 下需要注释此项

file-allocation=none

断点续传

continue=true

下载连接相关

最大同时下载任务数, 运行时可修改, 默认:5

max-concurrent-downloads=5

同一服务器连接数, 添加时可指定, 默认:1

max-connection-per-server=1

最小文件分片大小, 添加时可指定, 取值范围1M -1024M, 默认:20M

假定size=10M, 文件为20MiB 则使用两个来源下载; 文件为15MiB 则使用一个来源下载

min-split-size=10M

单个任务最大线程数, 添加时可指定, 默认:5

split=5

整体下载速度限制, 运行时可修改, 默认:0

#max-overall-download-limit=0

单个任务下载速度限制, 默认:0

#max-download-limit=0

整体上传速度限制, 运行时可修改, 默认:0

#max-overall-upload-limit=0

单个任务上传速度限制, 默认:0

#max-upload-limit=0

禁用IPv6, 默认:false

disable-ipv6=true

进度保存相关

从会话文件中读取下载任务

input-file=/etc/aria2/aria2.session

在Aria2退出时保存错误/未完成的下载任务到会话文件

save-session=/etc/aria2/aria2.session

定时保存会话, 0为退出时才保存, 需1.16.1以上版本, 默认:0

#save-session-interval=60

RPC相关设置

启用RPC, 默认:false

enable-rpc=true

允许所有来源, 默认:false

rpc-allow-origin-all=true

允许非外部访问, 默认:false

rpc-listen-all=true

事件轮询方式, 取值:[epoll, kqueue, port, poll, select], 不同系统默认值不同

#event-poll=select

RPC监听端口, 端口被占用时可以修改, 默认:6800

#rpc-listen-port=6800

设置的RPC授权令牌, v1.18.4新增功能, 取代 –rpc-user 和 –rpc-passwd 选项

#rpc-secret=secret

BT/PT下载相关

当下载的是一个种子(以.torrent结尾)时, 自动开始BT任务, 默认:true

#follow-torrent=true

BT监听端口, 当端口被屏蔽时使用, 默认:6881-6999

listen-port=51413

单个种子最大连接数, 默认:55

#bt-max-peers=55

打开DHT功能, PT需要禁用, 默认:true

enable-dht=false

打开IPv6 DHT功能, PT需要禁用

#enable-dht6=false

DHT网络监听端口, 默认:6881-6999

#dht-listen-port=6881-6999

本地节点查找, PT需要禁用, 默认:false

#bt-enable-lpd=false

种子交换, PT需要禁用, 默认:true

enable-peer-exchange=false

每个种子限速, 对少种的PT很有用, 默认:50K

#bt-request-peer-speed-limit=50K

客户端伪装, PT需要

peer-id-prefix=-TR2770-
user-agent=Transmission/2.77

当种子的分享率达到这个数时, 自动停止做种, 0为一直做种, 默认:1.0

seed-ratio=0

强制保存会话, 话即使任务已经完成, 默认:false

较新的版本开启后会在任务完成后依然保留.aria2文件

#force-save=false

BT校验相关, 默认:true

#bt-hash-check-seed=true

继续之前的BT任务时, 无需再次校验, 默认:false

bt-seed-unverified=true

保存磁力链接元数据为种子文件(.torrent文件), 默认:false

bt-save-metadata=true
`

This is the end of post