企业官网建设流程全解析

ANI-RSS 安装部署教程：新手快速跑起一套自动追番的 RSS 工具

【免费下载链接】ani-rss基于RSS自动追番、订阅、下载、刮削、洗版项目地址: https://gitcode.com/gh_mirrors/an/ani-rss

ANI-RSS 是一款基于 RSS 的自动追番聚合工具，能帮你完成订阅、下载、刮削和洗版一整条流程。本文面向第一次接触它的新手，带你完成安装部署，并说清第一次使用时的操作路径和常见卡点。

它解决什么问题

手动追番的痛苦通常有三步：蹲 RSS 源、手动挑资源、手动推送给下载工具。ANI-RSS 把这三步接成了一条流水线：

• 监控你配置的 RSS 源，发现新资源自动推送给 qBittorrent、Transmission 或 Aria2；
• 下载完成后执行刮削（如通过 TMDB 补齐元数据）和洗版，让入库的文件命名规整；
• 支持 Bark、邮件、Telegram 等消息推送，以及 Emby 媒体库刷新通知；
• 提供 Web 管理界面，追番记录、日志、订阅配置都能在页面上改。

如果你有一台常开的服务器、NAS 或树莓派，再配一个下载工具，它就是这套方案里缺的那个"中枢"。

先选一条适合你的启动路线

三种跑法各有取舍，先对号入座：

ANI-RSS Docker 部署

仓库里的docker/Dockerfile已经配好默认端口和内存参数，你只需要保证能访问镜像源：

docker run -d --name ani-rss -e PUID=0 -e PGID=0 -v /你的配置目录:/config -p 7789:7789 你的镜像

容器启动后访问http://服务器IP:7789。注意-v挂载的目录会保存全部配置，升级容器前不用手动备份。如果 ARM 平台拉不动默认镜像，仓库提供了docker/Dockerfile-arm32v7供自行构建。

Linux 脚本一键安装

linux/install-ani-rss.sh会依次完成：安装 JDK、创建运行用户、部署 jar 包、注册 systemd 服务并启动，还会询问是否沿用默认端口 7789：

sudo bash linux/install-ani-rss.sh

装完后系统里会有一个ani-rss命令，日常用它管理服务即可。

本地源码启动（开发者路线）

mvn clean package java -jar ani-rss-application/target/ani-rss.jar

第一条命令编译打包，第二条直接运行产物。前端开发时可以在ani-rss-ui/下用 Vite 起开发服务，它会把请求代理到后端的 7789 端口。

首次进入后先做什么

默认登录账号是admin/admin，登录后建议按顺序做三件事：

1. 改默认密码，并确认页面能正常加载。登录页入口在 ani-rss-ui/src/Login.vue，改完密码后刷新页面确认不会掉登录状态。
2. 配好下载工具再谈追番。到下载配置页填入 qBittorrent / Transmission / Aria2 的地址和账号，先手动下发一个测试任务，确认能下进来。下载通道不通的话，后面所有订阅都是空转。
3. 添加第一个 RSS 源并验证消息推送。在订阅页面粘贴一个 RSS 链接，等它抓取到新资源后，观察通知渠道（Bark、邮件等）是否收到推送。收到推送，说明"抓取 → 下载 → 通知"整条链路已经打通。

启动失败怎么排查

端口被占用，页面打不开？7789 是默认端口，被占用时换个端口再启动。Docker 改-p 新端口:7789左侧的数字即可；脚本安装在安装过程中就会提示你改；直接跑 jar 包则用-Dserver.port=新端口参数。

Maven 构建失败？先确认本机 JDK 版本满足要求（构建脚本按 JDK 25 拉取），再确认能正常拉取依赖仓库。mvn clean package报错时看最后一段堆栈，多数情况是 Java 版本或依赖下载问题。

Docker 容器启动就退出？优先看两件事：/config卷是否挂上（没挂上的话配置会随容器丢失）、能否访问外网下载资源。用docker logs 容器名看退出原因，docker stats确认内存是否被限制得过死（默认堆上限 512M，一般服务器够用）。

装完脚本后配置改了不生效？服务由 systemd 托管，改完配置后用ani-rss管理命令重启服务；日志可用journalctl -u ani-rss查看。

延伸资料

• 打包脚本：package.sh
• 更新日志：UPDATE.md
• 前端界面源码：ani-rss-ui/src/
• 后端服务代码：ani-rss-application/src/main/java/

【免费下载链接】ani-rss基于RSS自动追番、订阅、下载、刮削、洗版项目地址: https://gitcode.com/gh_mirrors/an/ani-rss