Radarr 装不上电影自动下载管家的 5 大报错一次修完【免费下载链接】RadarrMovie organizer/manager for usenet and torrent users.项目地址: https://gitcode.com/GitHub_Trending/ra/RadarrRadarr 是 Usenet 和 BitTorrent 用户的电影管理与自动下载工具。这份部署排错指南覆盖 Radarr 安装全流程默认端口、config.xml 配置、目录权限、数据库连接把端口占用、配置损坏、数据库连不上这几类高频 Radarr 报错一次修完。极速上手从零到可访问动手前先把版本对齐仓库根目录的 global.json 锁定了 .NET SDK 版本 10.0.403项目目标框架 net10.0前端构建用 Node仓库 devcontainer 配置用的是 24包管理是 Yarn。装好后三条命令验证验证命令就这么多dotnet --version # 预期 10.0.4xx node --version # 预期 v24.x yarn --version # 没有就先 corepack enable 启用然后按 克隆 → 装依赖 → 编译 → 启动 的顺序走git clone https://gitcode.com/GitHub_Trending/ra/Radarr cd Radarr yarn install --frozen-lockfile # 以 yarn.lock 锁定版本为准 dotnet build src/Radarr.sln -c Release启动控制台程序dotnet src/NzbDrone.Console/bin/Release/net10.0/NzbDrone.Console.dll # 控制台出现 Starting Radarr 和 Listening on [::]:7878 即成功浏览器打开 http://localhost:7878 就能看到电影库界面。⚠️ Radarr 默认监听所有网卡、不启用登录认证公网机器先把 7878 端口挡住再说。启动后数据目录、数据库和日志会自动生成确认~/.config/RadarrLinux已创建就算部署完成。打不开、起不来都没关系后面几节就是卡住时翻的速查手册。高频报错速查五类问题直接定位第一次启动看到这种报错画面基本是下面几个问题之一端口被占用三步修完现象启动报Address already in use浏览器连接被拒。根因Radarr 默认 HTTP 端口 7878、HTTPS 9898默认值定义在 src/NzbDrone.Core/Configuration/ 的 ConfigFileProvider.cs端口被别的进程占着就起不来。修复先查占用——sudo lsof -i :7878 # Windows 用 netstat -ano | findstr :7878不该活的进程直接杀掉要长期共存就改Port节点。还有个常见坑改了端口但没重启 Radarr——它只在启动时读一次配置改完必须重启才生效。权限不够先查这两个目录现象启动报Permission denied或下载、整理文件时历史记录一堆失败。根因运行 Radarr 的账号比如专用 radarr 用户对数据目录或媒体库目录没有写权限。修复把属主改过来目录换成你自己的路径sudo chown -R radarr:radarr ~/.config/Radarr sudo chown -R radarr:radarr /media/movies /downloadsWindows 同理别装在 Program Files 下默认拒绝写入放到D:\Applications\Radarr再在文件夹权限里给运行账号完全控制。config.xml 损坏四步恢复现象启动报config.xml is corrupt提示删除后自动重建。根因写文件被中断或手改 XML 时标签没闭合、特殊字符没转义。修复Radarr config.xml 损坏恢复按这四步走——cp ~/.config/Radarr/config.xml config.xml.bak # 先备份 sudo systemctl stop radarr sudo mv ~/.config/Radarr/config.xml config.xml.bad # 挪走坏文件 sudo systemctl start radarr # 自动生成全新默认配置恢复后只需在 Web 界面重填媒体路径和下载客户端数据库不受影响。想自己确认 XML 是否合法跑xmllint --noout config.xml看一眼。数据库连不上先手动连一次现象启动报数据库错误日志里Connection refused。根因默认用内置 SQLite不需要任何配置只有主动切到 PostgreSQL 才要填对主机、端口、账号密码对应 ConfigFileProvider.cs 里的 PostgresHost、PostgresPort 等属性。修复先用 psql 手动连一次验证凭据psql -h localhost -p 5432 -U radarr -d radarr-main实在用不上 Postgres把 config.xml 里 Postgres 相关项清空就退回 SQLite这是最省事的路。代理没配元数据全超时现象所有元数据请求失败日志一片超时。根因网络要过代理但 Radarr 没配置。修复在 config.xml 的 Config 节点补上代理项改完记得重启ProxyTypehttp/ProxyType ProxyHostnameproxy.example.com/ProxyHostname ProxyPort8080/ProxyPort ProxyBypassFilterlocalhost;127.0.0.1/ProxyBypassFilter网页打不开是绑定地址的事现象局域网其他机器访问被拒或刷新出 404 页面。根因BindAddress被设成 127.0.0.1只有本机能访问或 nginx 反代配了子路径却没同步 config.xml 里的UrlBase地址少一段就 404。修复对照 config.xml 里这两个节点改404 的情况把地址补全比如http://host:7878/radarr。配置与权限怎么调记住这几个节点Radarr 运行时的全部状态都在数据目录里config.xml、数据库、日志三样缺一不可。默认路径跨平台差异如下系统数据目录Linux~/.config/RadarrmacOS~/Library/Application Support/RadarrWindowsC:\ProgramData\Radarr这些路径由 src/NzbDrone.Common/EnvironmentInfo/ 里的 AppFolderInfo.cs 决定启动参数--data /自定义路径可以整体挪数据目录Docker 和 NAS 上很常用。日常维护最常动的节点Port/SslPort默认 7878/9898BindAddress默认*即全部网卡明确只给本机用才改 127.0.0.1LogLevel默认 debug日志量大生产环境建议改 infoApiKey是 API 调用密钥EnableSsl配合SslCertPath可以不开反代直接用 httpsUrlBase用子路径访问时必须和反代配置一致。⚠️ 两个提醒改完 config.xml 必须重启 Radarr 才生效动手前先把文件备份一份XML 里别裸写这类特殊字符要转义成amp;。权限按最小够用原则只给运行账号数据目录和媒体目录的读写别放宽到整个系统。媒体库在共享卷上的话单独给 radarr 用户加一条 ACL 更干净sudo setfacl -R -m u:radarr:rwX /media/movies # 需要装 setfacl 包源码构建四步走官方 CI 同款流程想试最新代码时照仓库根目录 build.sh 里的 CI 流程走四步就行。第一步克隆git clone仓库地址后进入目录命令同极速上手一节不再重复。第二步后端编译。版本被 global.json 锁死在 10.0.403SDK 对上就能直接编dotnet build src/Radarr.sln -c Release # Windows 加 -p:PlatformWindows第三步前端构建。webpack 产物输出到_output/UI运行时要把它拷成UI/放到可执行文件同目录打包脚本自动做手动跑要自己拷yarn install --frozen-lockfile yarn run build --env production第四步启动验证。控制台出现Starting Radarr和Listening on端口行即成功浏览器访问 7878 能进界面就齐活了。前端源码在 frontend/src/ 下页面按 Activity、Calendar、Movie、Settings 等功能分目录想看某个界面背后的实现进对应目录直接找。日志与诊断工具箱三条命令加六步排查Radarr 日志写在数据目录下的logs/radarr.txt跨平台路径速查系统日志路径Linux~/.config/Radarr/logs/radarr.txtmacOS~/Library/Application Support/Radarr/logs/radarr.txtWindowsC:\ProgramData\Radarr\logs\radarr.txt 三条最常用的命令日志路径换成上表对应的tail -f ~/.config/Radarr/logs/radarr.txt | grep -E ERROR|WARN # 实时盯错误 tail -n 200 ~/.config/Radarr/logs/radarr.txt | grep -i port\|bind # 查端口问题 grep 2026-11-03 ~/.config/Radarr/logs/radarr.txt | head -20 # 按日期筛出问题时按这个顺序走一般五分钟内能锁定看控制台输出最后几行第一条异常往往就是根因lsof查 7878 是否被占确认数据目录和媒体目录对运行用户可读写xmllint验证 config.xml 的 XML 格式检查 PostgreSQL 连接如果用了和代理配置LogLevel改 trace 重启拿最详细的日志查完再改回 info文件日志之外控制台输出级别由ConsoleLogLevel单独控制前台跑的时候留意它。Web 界面 System 页下的 Tasks 和 Health 也值得常看定时任务状态和健康检查结果都在那里很多部署问题会先以健康告警的形式冒出来。日志默认滚动保留 50 个文件LogRotate可调不用操心撑爆磁盘。部署后运维清单首次跑通之后把这份清单过一遍能挡掉大部分后续麻烦每周备份一次数据目录重点是 config.xml 和数据库文件System 页有内置备份下载换机器时直接还原LogLevel 设成 info需要排错时临时切 trace查完切回去给 Web 界面启用认证7878 端口别裸奔在公网至少挂个反代升级方式心里有数Windows 默认开启内置自动更新源码构建的按上面四步重新编译替换卡住时先翻 README.md 和 CONTRIBUTING.md提交问题附上日志和复现步骤【免费下载链接】RadarrMovie organizer/manager for usenet and torrent users.项目地址: https://gitcode.com/GitHub_Trending/ra/Radarr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考