N1小钢炮部署IYUUPlus：打造全自动辅种下载工作站

1. 项目概述与场景拆解

最近在折腾N1小钢炮盒子的时候，顺手把IYUUPlus也部署上了。整个过程踩了一些坑，也理清了不少以前容易忽略的细节。如果你手头正好有一台吃灰的N1小钢炮盒子，又需要一套自动化的下载管理工具，这篇文章应该能帮你少走几趟弯路。

先说清楚这个组合是干嘛的。N1小钢炮本质上是一个面向下载场景的固件系统，内置了Docker容器、下载器、文件共享等服务，非常适合放在家里当低功耗下载机。而IYUUPlus是一个开源的内网下载管理辅助工具，核心能力是自动辅种、定时校验、做种管理等。把两者结合起来，你的N1小钢炮就不再只是一台“挂着下载软件的小盒子”，而是一台能自动帮你整理资源、保持下载器健康度的“无人值守下载工作站”。

适合谁看？如果你是下载爱好者，同时又有基础Docker知识，想在一台低功耗设备上部署IYUUPlus，这篇文章会从零开始，把容器如何创建、目录如何映射、下载器如何对接、任务如何配置全部串起来。即使你之前完全没接触过IYUUPlus，只要跟着操作，也能够轻松跑起来。我这里所有操作都基于N1小钢炮盒子的实际环境，别的系统也可以参考，差异集中在系统路径和权限管理上。

2. 部署前准备：硬件、固件与目录规划

2.1 硬件与小钢炮系统认知

N1小钢炮盒子使用的是一颗不太起眼但实际性能够用的四核处理器，配合2GB内存，日常跑下载器和Docker容器完全没问题。它的系统是基于开源Linux内核定制的第三方固件，所以自带Docker服务，这是我选择它来跑IYUUPlus的关键原因。如果用其他设备，比如普通x86小主机或者树莓派，只要系统里有Docker，部署流程基本一致，只是路径名称和端口映射的写法要跟着改。

小钢炮固件里自带了一套Web管理后台，可以图形化管理Docker、查看容器状态、设置定时任务。部署IYUUPlus之前，我建议先确认几件事：系统里是否已经启用Docker服务，存储空间是否足够，以及能不能正常通过SSH登录设备。N1小钢炮默认开启了SSH，这对后续命令行操作帮助很大。如果连SSH都连不上，后面的容器创建会麻烦很多，所以第一步就先把SSH验证好。

内存和存储也要提前考虑。N1小钢炮的内置存储通常有几个GB，但不同版本固件差异不小。IYUUPlus本身不占多少空间，镜像大概几百MB，但运行时的数据库和日志会逐渐增长。另外，辅种校验需要下载器提供种子列表，这个过程中产生的临时数据也不少，所以我建议至少预留2GB以上可用空间。如果空间紧张，可以把Docker的数据目录外挂到USB移动硬盘上，小钢炮支持外接存储设备，这个方案实测很稳。

2.2 你可能需要的工具清单

部署前把工具列清楚，能省掉一多半的临时乱找时间。我实际用到的工具如下：

• 一台已经刷好小钢炮固件的N1盒子，并且能正常开机联网。
• 一台用于访问Web管理后台的电脑或手机，浏览器建议用Chrome或Edge，兼容性较好。
• SSH客户端，Windows可以用系统自带的Terminal，macOS和Linux直接终端即可。
• 文本编辑器，后面编辑配置文件时会用到，Windows下顺手用记事本或者VS Code都行。
• 可用的PT站账号和访问权限，IYUUPlus需要登录站点获取token，这一步绕不开。
• 下载器客户端，比如qBittorrent或Transmission，需要提前在小钢炮上跑起来，并把WebUI端口和登录信息准备好。

这里要专门提一下，IYUUPlus和下载器之间的通信依赖下载器开放的WebUI接口。所以你必须确认下载器WebUI允许来自容器IP的访问，端口不能随意封死。很多人在这一步卡住，原因就是下载器只允许本机访问，容器里连不上。

2.3 目录与端口规划

部署容器之前，先把目录和端口规划好，不然后面改配置会非常痛苦。我的规划是这样：

• 容器数据目录：/mnt/sda1/docker/iyuuplus，用于存放IYUUPlus的数据库、日志和临时文件。
• 下载数据目录：/mnt/sda1/downloads，这个是下载器的默认下载路径，IYUUPlus的辅助校验会扫描这个目录下的种子文件。
• 端口规划：IYUUPlus的Web管理界面映射到宿主机的8780端口，避免和下载器端口冲突。

之所以把数据目录放在/mnt/sda1下，是因为我的N1小钢炮把移动硬盘挂载在这个路径。如果你只有内置存储，路径就换成内置存储的实际挂载点，比如/root/data。关键是搞清楚路径的真实挂载位置，不要凭感觉写一个不存在的路径，否则容器创建后起来就报错找不到目录。

提示：在创建容器前，先用df -h命令看一遍当前磁盘挂载情况，确认你准备的路径确实可用。这一步几十秒的事，能避免后期大量排查时间。

3. 完整部署实操：从拉镜像到自动运行

3.1 开启并验证Docker环境

小钢炮固件自带Docker，但版本可能不是最新的，所以先把Docker服务拉起来，然后验证一下版本。SSH登录设备后，执行下面几条命令：

systemctl status docker

如果服务没有运行，先启动：

systemctl start docker systemctl enable docker

启动完成后检查版本：

docker version

我建议看到客户端和服务端版本都输出再继续往下走。如果Docker服务本身都没起来，后面所有容器操作都报错，而且很容易误以为是镜像问题。

接下来需要确认Docker的存储驱动和数据目录。小钢炮默认配置通常没问题，但有个细节：如果系统重启后Docker数据目录被挂载到内存临时文件系统，重启丢容器，这问题很隐蔽。建议看一下docker info里的Docker Root Dir，正常情况下应该在持久存储下，而不是/tmp。如果指向/tmp，赶紧去固件设置里把Docker数据目录改到设备存储或外接硬盘上，否则辛苦配置的容器一次重启就全没了。

3.2 拉取IYUUPlus镜像并创建容器

Docker环境就绪后，下一步是拉取镜像。IYUUPlus的官方镜像名称会随版本发布变化，建议直接去项目的发布页面或Docker Hub上查当前最新镜像名。我这里用拉取命令演示整体流程：

docker pull iyuu/iyuuplus:latest

拉取时需要耐心等一会儿，镜像不算特别大，但取决于你的网络情况。拉取完成后，用docker images确认镜像已经存在并记下IMAGE ID，后面创建容器要用到。

创建容器时，推荐使用docker run命令并指定挂载目录、端口和重启策略。下面是我实际使用的命令：

docker run -d \ --name iyuuplus \ --restart unless-stopped \ -p 8780:8780 \ -v /mnt/sda1/docker/iyuuplus:/config \ -v /mnt/sda1/downloads:/downloads \ iyuu/iyuuplus:latest

这条命令的含义很简单：容器名是iyuuplus，映射宿主机的8780端口到容器内的8780端口，同时把两个目录挂载进去，容器退出后会自动重启。创建完成后，容器会立刻启动，可以通过docker ps查看运行状态，状态显示Up就说明正常。

如果你需要自定义端口，比如想用8080访问Web界面，把前面的8780改成8080即可。宿主机端口不要选已经被占用的端口，否则容器会启动失败。命令执行完如果不报错，基本就成功了大半。

3.3 配置下载器连接与登录

容器运行起来后，浏览器访问http://N1的IP:8780，就能看到IYUUPlus的Web管理页面。首次打开会要求初始化配置，这里最关键的一步是添加下载器。IYUUPlus支持的下载器包括qBittorrent、Transmission、Deluge等，我这次用的是qBittorrent。

添加下载器时，需要填写的核心信息有：

• 下载器类型：选择QB。
• 下载器名称：随便起，自己认得就行，比如home-qb。
• 下载器地址：填写http://N1的IP:8080，这个IP是小钢炮盒子的局域网地址，端口是qBittorrent WebUI端口。
• 用户名和密码：下载器WebUI的登录信息，注意和系统登录区分开。

填完之后，点测试连接。如果显示成功，说明容器和下载器已经能通信。我最开始测试失败，检查发现下载器WebUI只监听了127.0.0.1，容器访问不了。解决办法是在qBittorrent的WebUI设置里把监听地址改成0.0.0.0，然后重启下载器。这个问题非常典型，如果你也遇到，优先检查监听地址。

下载器添加完成后，还需要登录PT站获取API令牌。IYUUPlus需要你在站点设置里填入站点的API地址和token。每个站点的token获取方式略有差异，但基本都是在站内“个人信息”或“API设置”页面里生成。拿到token后粘贴进IYUUPlus的站点配置里，保存设置。

注意：token相当于你在站点上的身份凭证，不要随手分享给别人。一旦泄露，对方可以用你的账号权限操作，处理起来很麻烦。

3.4 配置自动辅种与定时任务

IYUUPlus最核心的价值在于自动辅种。所谓辅种，就是当你的下载器里有一个种子，而某个站点或者其他站点有完全相同的资源但不同的tracker信息时，通过校验本地文件后，直接为这个资源也做一份种，不需要重复下载数据。配置好之后，它能自动扫描下载器中的种子，和各个站点的资源进行比对，发现匹配的种子就自动添加辅助做种。

自动辅种的配置项包括：

• 扫描间隔：建议设置成每6小时运行一次，太频繁会增加下载器压力。
• 站点选择：可以把常用的几个站点都勾选上，IYUUPlus会逐个比对。
• 辅种操作方式：选择通过下载器API添加种子，保持现有文件路径不变。
• 遇到重复种子时的处理：选择跳过，避免重复添加导致下载器混乱。

定时任务除了辅种，还可以配置“种子健康度检查”，定期检查哪些种子长期无人做种，及时暂停或者从中移除。这个功能我一开始觉得多余，后来发现对保持做种比例非常有帮助。很多站点要求做种率，如果一堆死种子占着地方，对站点对个人都不好。IYUUPlus会自动识别这些问题种子，按规则处理。

设置完这些任务后，记得保存，让任务处于启用状态。启用后，IYUUPlus会在后台按计划自动执行，不需要频繁手动介入。第一次辅种扫描可能需要较长时间，尤其是下载器里种子数量比较多的时候，耐心等待即可。

3.5 验证运行状态

配置完成后的首次验证很重要。我习惯先把扫描日志打开，观察一轮完整的任务执行过程。在IYUUPlus的Web界面里进入日志页面，可以看到每条辅种动态。比如“找到一个可辅种的种子，正在添加”这类信息，说明任务真正在干活。

如果日志里大量出现匹配失败或连接失败，不要急着怀疑IYUUPlus，先检查下载器状态和网络环境。常见原因有三种：下载器WebUI不可达、token填写错误、PT站点访问超时。逐项排查基本都能找到问题。

容器本身的稳定性也要观察几天。小钢炮盒子都是长时间运行，我部署完后特意连续观察了72小时，没有出现容器挂掉或者任务中断的情况。这个容器配置了unless-stopped重启策略，即使设备断电重启，也会自动拉起，实测很省心。

4. 常见问题与实战避坑

4.1 容器启动失败或反复重启

这个问题的典型表现是容器创建后一直显示Restarting，或者每隔几秒就退出。排查思路从简到繁：

• 端口冲突。宿主机8780端口被其他程序占用，容器无法绑定。用ss -lnt看看端口占用情况，换一个端口重新创建。
• 挂载目录权限不对。容器内部进程需要读写挂载目录，如果目录属主不对就会退出。最简单的办法是把挂载目录的属主改成UID 1000，或者给目录chmod -R 777，临时验证时可以这样，长期运行建议固定属主。
• 镜像启动命令不对。有些镜像版本更新后启动参数有变化，建议回到镜像文档确认入口脚本，不要死守旧命令。

我自己遇到过一次类似问题，原因是挂载目录路径写错，导致容器里无法初始化数据库。后来把/config挂载目录建好，再重新创建容器，问题就消失了。

4.2 token失效与登录态保持

IYUUPlus在运行一段时间后，可能会出现某个站点无法更新数据，Web界面提示token失效或会话过期。这个问题几乎人人都会遇到，原因是站点API token有时效性，或者站点服务端检测到异地登录主动失效。

解决方案很简单：登录对应站点，重新生成token，到IYUUPlus站点配置里更新保存。为了防止频繁失效，建议设置一个周期性的“站点验证”任务，每周自动检查所有站点连接状态，发现失败就告警。IYUUPlus其实有这个功能，只是很多人没有开启。

另一个相关的坑是同时配置多个站点时，一个站点失效不影响其他站点，但日志里会不断刷错误，影响排查。我建议把失效站点单独停用，等重新填好token再启用，省得日志刷屏干扰判断。

4.3 辅种命中率低

很多人部署后第一周发现辅种数量远低于预期，怀疑是不是自己没配置好。实际上辅种命中率受多方面因素影响，不能简单认为工具不行。

• 下载器里的种子本身要足够多，种子越多，能匹配上的概率越大。
• 站点资源库的实时性也要考虑，如果你没在这个站点上直接发布过种子，匹配范围就小，辅种命中率自然低。
• 本地文件路径和站点种子路径不能完全对上时，IYUUPlus可能无法直接复用文件，这种情况下它会跳过该种子，而不是强行下载。
• 扫描间隔太长，某些资源已被别人占坑，导致新增辅种机会变少。

想提高命中率，我建议适当增加站点数量，并且注意保持本地文件名和站点发布名一致。IYUUPlus支持自定义路径映射规则，如果目录结构不同，可以配置路径替换，让文件能对上。这个功能在“设置-路径映射”里，设置路径时最好把实际绝对路径和容器内路径都填清楚。

4.4 Q&A速查表

部署过程中有不少零散问题，我整理了一个简单的速查表，方便遇到同样问题的人直接定位：

这些只是最典型的几种情况，实际使用中还会遇到更个体化的问题。遇到问题先冷静下来，查日志、查网络、查容器输出，比乱改配置有效得多。

4.5 我的几点实操心得

最后分享几个我在实际使用中觉得特别有用的习惯。

第一，配置任何改动前先备份配置文件。IYUUPlus的配置都存在挂载目录里，复制一份几乎零成本。万一改动出问题，把目录恢复回去就是原样，太省事了。

第二，端口规划要留余量。很多人在小钢炮上同时跑着下载器、文件管理、各种Docker服务，端口冲突是家常便饭。我就吃过亏，IYUUPlus的8780端口和另一个容器的Web界面端口撞了，导致容器反复重启。所以创建容器前，用一个Excel或者备忘录把各服务端口列一张表，给自己省心。

第三，定时任务不要贪多。一开始我把辅种间隔设成1小时，结果发现下载器CPU经常满载，反而拖累了正常下载。找到一个平衡点很重要，我目前是6小时跑一次辅种，3小时跑一次健康度检查，运行稳定，下载器负载也很低。

第四，别忽略设备散热。N1小钢炮体积小，长期高负载运行发热明显。我是在盒子上加了一个小风扇，温度控制在60度以内。下载器频繁读写时温度高，极端高温会影响设备寿命。这个细节看似和IYUUPlus无关，但整个系统稳定性差了，什么工具都白搭。

用IYUUPlus这段时间，整体感受是“一劳永逸”这四个字特别贴切。前期配置稍花心思，后期基本不用管，它自己就能把辅种、检查、清理这些琐碎活儿干完。配合N1小钢炮的低功耗优势，这台小盒子放在角落里跑了几个月，电费几乎可以忽略不计。如果你也想把自己的下载机打造成一套自动化管理系统，照着这篇文章的思路走，大概率不会踩到大的深坑。