后端前端音视频【免费下载链接】Auto_BangumiAutoBangumi - 全自动追番工具项目地址https://gitcode.com/gh_mirrors/au/Auto_Bangumi点击查看免费下载AutoBangumi 是一款全自动追番工具支持 RSS 订阅解析、下载器调度与番剧重命名。本文围绕官方文档的本地部署路线非 Docker 方式完整还原下载、解压、虚拟环境搭建、配置目录初始化、启动运行的每一步命令行操作并结合当前仓库的源码补充 Python 版本要求、默认端口、环境变量与启动流程等实现细节。读完本文你将能够在自己的 Linux / WSL / Windows 机器上独立完成 AutoBangumi 的本地安装、首次启动与开机自启配置并理解每一步背后的实现原理。::: warning 部署方式选择 官方文档明确警告本地部署可能会导致意外问题强烈建议优先使用 Docker 方式部署可参考 docker-cli 部署文档 与 docker-compose 部署文档。本地部署更适合希望在裸机上直接运行、或需要对运行过程进行深度定制的场景生产环境请优先选择 Docker。 :::一、本地部署前置条件在开始之前请确认环境满足以下要求检查项要求说明操作系统Linux / WSL / WindowsUnix 系直接使用命令行Windows 需手动解压并执行 PowerShell 命令Python3.10以发布包为准官方文档标注为 Python 3.10当前仓库 backend/pyproject.toml 声明requires-python 3.13请以你所下载的发布版本声明为准pip已安装且可用用于安装requirements.txt中的依赖网络可访问 GitHub Releases下载发布包需要访问 GitHub国内环境可考虑镜像加速关于 Python 版本官方文档特别提示此文档可能存在更新延迟。当前仓库backend/pyproject.toml中记录的项目版本为3.3.6依赖锁定文件为 backend/uv.lockrequires-python已提升至3.13。因此建议优先安装最新稳定版 Python3.13 及以上以兼容依赖声明若使用发布包自带的requirements.txt则以包内标注的版本要求为准。二、下载最新发布版本AutoBangumi 的发布版本号遵循语义化版本规范。官方提供了一段 Bash 命令通过 GitHub API 自动获取最新 tag 并下载对应的app-v$VERSION.zip压缩包VERSION$(curl -s https://api.github.com/repos/EstrellaXD/Auto_Bangumi/releases/latest | grep tag_name: | sed -E s/.*([^]).*/\1/) curl -L -O https://github.com/EstrellaXD/Auto_Bangumi/releases/download/$VERSION/app-v$VERSION.zip命令说明第一步通过 GitHub Releases API 的latest端点获取最新发布信息再用grepsed从返回的 JSON 中提取tag_name字段如v3.3.6存入变量VERSION第二步拼接下载地址使用curl -L跟随重定向、-O保持原始文件名下载app-v$VERSION.zip。下载完成后建议先核对压缩包完整性。若后续解压失败可重新执行下载GitHub 偶尔会出现网络抖动重试即可。三、解压发布压缩包压缩包内含后端源码src/目录与构建好的前端产物dist/目录。在 Unix / WSL 系统上使用以下命令解压到AutoBangumi目录并进入unzip app-v$VERSION.zip -d AutoBangumi cd AutoBangumi在 Windows 上请手动解压右键压缩包 → 全部解压缩然后通过 PowerShell 或资源管理器进入解压后的AutoBangumi目录。解压后目录结构核心部分如下与当前仓库 backend/ 布局一致AutoBangumi/ ├── src/ # 后端 Python 源码入口 main.py 位于 src 下 ├── dist/ # WebUI 前端静态资源 └── ... # 依赖清单、许可证等四、创建虚拟环境并安装依赖进入src目录使用 Python 官方venv模块创建隔离的虚拟环境再通过 pip 安装依赖清单中的全部第三方包cd src python3 -m venv env python3 pip install -r requirements.txt4.1 虚拟环境的作用AutoBangumi 依赖较多包括 FastAPI、uvicorn、httpx、beautifulsoup4、SQLModel、SQLAlchemy、aiosqlite、pydantic、PyJWT、bcrypt、cryptography 等见 backend/pyproject.toml 的dependencies段。使用独立虚拟环境可以避免污染系统 Python也便于日后整体升级或卸载。4.2 从仓库源码安装的替代方案如果你不是使用官方发布包而是直接基于仓库源码运行则无需requirements.txt仓库当前以pyproject.tomluv.lock管理依赖。可以参照 backend/dev.sh 的开发环境搭建思路python3 -m venv venv ./venv/bin/python3 -m pip install -r requirements-dev.txt或者使用uv直接按锁文件安装uv sync --frozen --no-dev两种方式二选一即可。发布包用户直接使用文档中的python3 pip install -r requirements.txt即可。4.3 激活虚拟环境安装完成后后续所有运行命令都应通过虚拟环境中的 Python 解释器执行# Linux / WSL source env/bin/activate # 或直接使用env/bin/python main.py # Windows (PowerShell) .\env\Scripts\Activate.ps1五、创建配置与数据目录AutoBangumi 启动时需要两个目录config与datamkdir config mkdir data在src目录下创建即执行上述命令时位于src/中最终形成src/config与src/data。这两个目录承担着不同职责config存放运行配置。首次启动时程序会将工厂默认配置写入config/config.json。默认值的完整定义见 backend/src/module/conf/const.py 中的DEFAULT_SETTINGS包含programRSS 轮询间隔、重命名间隔、WebUI 端口、downloaderqbittorrent 连接信息、rss_parser、bangumi_manage、proxy、notification、llm、security、update等配置块data存放运行时数据例如番剧元数据、SQLite 数据库、海报缓存等backend/src/main.py 中定义了data/posters作为海报静态资源目录。::: tip 关于端口 默认 WebUI 端口为7892定义在 backend/src/module/conf/const.py 的DEFAULT_SETTINGS[program][webui_port]。首次运行生成config.json后可手动修改也可通过环境变量AB_WEBUI_PORT覆盖见 backend/src/module/conf/const.py 的ENV_TO_ATTR映射。 :::六、运行 AutoBangumi一切就绪后在src目录下启动后端服务python3 main.py6.1 启动过程发生了什么从 backend/src/main.py 源码可以看到启动链路调用setup_logger(resetTrue)初始化日志系统通过AppContext.build(settings)构建应用上下文lifespan启动阶段执行数据库迁移ctx.startup()首次启动会创建数据库创建 FastAPI 应用挂载/api路由、根路径健康检查路由/health见 backend/src/healthcheck.py以及用于 LLM 工具集成的 MCP 服务/mcp非首次启动时后台任务调度RSS 采集、下载器等待、循环启动通过ctx.start_tasks()异步拉起最后以uvicorn.run启动 ASGI 服务监听settings.program.webui_port默认 7892。开发模式下版本号为DEV_VERSION即仓库源码直接运行根路径/会 302 重定向到/docsFastAPI 自动生成的 Swagger 文档见 backend/src/main.py正式发布版则挂载dist/下的 WebUI 静态资源。6.2 监听地址与 IPv6 支持默认监听0.0.0.0:7892。可通过环境变量调整# 仅监听本机 HOST127.0.0.1 python3 main.py # 启用 IPv6监听 :: IPV61 python3 main.py实现见 backend/src/main.py 的__main__段os.getenv(IPV6)为真时 host 取::否则取os.getenv(HOST, 0.0.0.0)。6.3 验证服务是否正常启动后访问http://主机地址:7892即可打开 WebUI首次启动会进入初始化/登录流程。也可以直接探测健康检查接口curl http://127.0.0.1:7892/health该接口挂载在应用根路径而非/api下不需要鉴权专为容器与编排系统的存活探针设计实现见 backend/src/healthcheck.py。本地部署时可用同样的方式确认服务已正常起来。6.4 日志排查若启动失败或行为异常优先查看终端输出的日志。日志等级由config.json中log.debug_enable控制也可通过环境变量AB_DEBUG_MODE开启调试日志见 backend/src/module/conf/const.py 的ENV_TO_ATTR。开启调试日志有助于定位 RSS 解析、下载器连接等问题。七、Windows 开机自启nssm 方案在 Windows 上nssmNon-Sucking Service Manager可以将任意命令行程序注册为 Windows 服务实现开机自启、异常自动重启。官方文档给出的示例配置如下nssm install AutoBangumi (Get-Command python).Source nssm set AutoBangumi AppParameters (Get-Item .\main.py).FullName nssm set AutoBangumi AppDirectory (Get-Item ..).FullName nssm set AutoBangumi Start SERVICE_DELAYED_AUTO_START命令逐条说明命令作用nssm install AutoBangumi (Get-Command python).Source创建名为AutoBangumi的服务可执行文件指向python解释器的完整路径PowerShell 动态解析nssm set AutoBangumi AppParameters (Get-Item .\main.py).FullName设置服务启动参数为main.py的绝对路径nssm set AutoBangumi AppDirectory (Get-Item ..).FullName设置工作目录为main.py所在目录的父目录即src/与运行python3 main.py时的目录一致保证config/、data/、dist/相对路径正确解析nssm set AutoBangumi Start SERVICE_DELAYED_AUTO_START设置为延迟自动启动避免开机时与系统服务争抢资源、等待网络就绪::: tip 使用前提需提前安装 nssm 并加入 PATH请将工作目录AppDirectory确认为src/这是 AutoBangumi 正常读取config、data与前端dist的关键前提——backend/src/main.py 中的静态资源挂载、data/posters路径解析均基于进程工作目录展开若用虚拟环境请将nssm install的 python 路径替换为env\Scripts\python.exe的完整路径并将 AppParameters 指向同一解释器执行main.py。 :::注册完成后可通过services.msc查看服务状态或使用nssm start AutoBangumi手动启动、nssm stop AutoBangumi停止、nssm remove AutoBangumi confirm删除服务。八、与 Docker 部署的差异小结官方文档反复强调优先使用 Docker结合仓库文件可以更清楚地理解原因entrypoint.shentrypoint.sh封装了PUID/PGID用户权限映射、UMASK、信号转发与优雅退出、在线更新覆盖层backend/src/boot_overlay.py等一整套运维逻辑Docker 健康检查backend/src/healthcheck.py每 30 秒探测/health端点本地部署时没有这套自动探活与重启机制本地部署的依赖版本由你本机的 Python 环境决定而 Docker 镜像内置了经过锁定与验证的 backend/uv.lock 依赖集合可复现性更强。因此如果你的目标是长期稳定运行建议优先采用 Docker 方案本地部署则适合快速体验、二次开发调试仓库提供了带热重载的开发启动脚本 backend/dev.sh使用uvicorn main:app --reload --port 7892或在没有 Docker 环境的内网主机上运行。九、常见问题速查Q1启动报 Python 版本错误检查 Python 版本是否满足发布包要求文档标注 3.10当前仓库源码要求 3.13。可用python3 --version查看。Q2访问 WebUI 提示 404 / 空白页确认已使用发布包内含dist/前端产物而非仅拷贝源码源码直跑模式下根路径会跳转到/docs而不是 WebUI。确认工作目录包含dist/且config/config.json中端口未被修改。Q3下载器连接失败config/config.json中downloader块的host默认指向172.17.0.1:8080Docker 桥接网络网关本地部署请改为你实际下载器如 qBittorrent的地址与端口默认值见 backend/src/module/conf/const.py。Q4需要修改端口启动前设置环境变量AB_WEBUI_PORT8080 python3 main.py或首次启动后编辑config/config.json的program.webui_port字段并重启服务。十、参考文档官方本地部署指南英文原版docs/en/deploy/local.md官方本地部署指南中文版docs/deploy/local.mdDocker CLI 部署docs/deploy/docker-cli.mdDocker Compose 部署docs/deploy/docker-compose.md后端入口与启动链路backend/src/main.py默认配置与环境变量映射backend/src/module/conf/const.py依赖声明backend/pyproject.toml赞分享后端前端音视频【免费下载链接】Auto_BangumiAutoBangumi - 全自动追番工具项目地址https://gitcode.com/gh_mirrors/au/Auto_Bangumi点击查看免费下载相关推荐AutoBangumi 本地部署完全指南源码运行、依赖安装与开机自启实战AutoBangumi 本地部署完全指南源码运行、依赖安装与开机自启实战 AutoBangumi全自动追番工具官方推荐使用 Docker 进行部署但如果后端前端音视频eqMac开发者指南从源码编译到本地部署完整流程eqMac开发者指南从源码编译到本地部署完整流程 eqMac是一款功能强大的macOS系统级音频均衡器和音量混合器为开发者提供了完整的开源代码和构建工具。本桌面应用音频处理GitHub Markup本地开发环境搭建从源码到部署的完整指南GitHub Markup本地开发环境搭建从源码到部署的完整指南 GitHub Markup 是一个强大的开源库用于确定在 GitHub 上渲染内容文件如后端上一篇30亿参数挑战千亿模型ERNIE 4.5 VL如何重塑多模态AI产业格局下一篇终极C Web框架指南CppCMS高性能开发全解析创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考