Question 1

我该如何修复 PodFetch 在 Unraid/Docker 上将 SQLite 数据库创建在 /app 而不是持久化的 /app/db 卷中的问题？

Accepted Answer

设置 DATABASE_URL 环境变量，以便 PodFetch 使用挂载卷：

DATABASE_URL=sqlite:///app/db/podcast.db

在 Unraid Community Apps 中，将此变量添加到 PodFetch 容器配置，然后重新创建/应用容器。

要在重新创建之前保留现有数据库，请将数据库文件从运行中/已停止的容器复制到主机卷：

docker cp PodFetch:/app/podcast.db /mnt/docker_pool/appdata/podfetch/db/podcast.db
docker cp PodFetch:/app/podcast.db-shm /mnt/docker_pool/appdata/podfetch/db/podcast.db-shm
docker cp PodFetch:/app/podcast.db-wal /mnt/docker_pool/appdata/podfetch/db/podcast.db-wal

如果这些文件不存在，则省略 shm/wal 的复制。重新创建容器后，验证 /app/db 包含 podcast.db；docker diff PodFetch 不应再将 /app/podcast.db 显示为新创建的文件。Unraid 模板问题已在 podfetch-unraid-config 提交 b8dcde23c8b653a4108dba2967fd7087ed259619 中修复。

Question 2

如何修复 PodFetch 在 update_meta_data_mp3 中因 'No such file or directory' panic 而反复重新下载同一单集的问题？

Accepted Answer

当播客的封面图像已存储在本地，但某集的 MP3 没有嵌入封面时，这会影响 PodFetch v5.2.2 和当前的 main。下载 worker 在打开一个从未写入的每集图像时会 panic，因此 download_time 保持为 NULL，并且该集在每次轮询时都会再次下载。

立即变通方案：为 image_url 已被本地化的播客恢复远程图像 URL，迫使每集图像被写入：

SQL：
UPDATE podcasts
SET image_url = original_image_url
WHERE original_image_url LIKE 'http%'
  AND image_url NOT LIKE '%http%';

然后再次触发该集下载。验证 download_time 已填充，并且封面/章节已插入。

代码修复：不要将可选图像视为致命错误。将无条件的 unwrap() 替换为可失败打开，例如：

Rust：
if tag.pictures().count() == 0
    && let Ok(mut image_file) = File::open(&paths.image_filename)
{
    // 嵌入 image_file
}

或者，使图像读取条件与写入文件时使用的条件相同。还要考虑在元数据处理之前记录 download_time，这样元数据失败就不会导致无限重新下载循环。维护者报告该问题已修复；如果可用，请升级到包含该修复的版本。

Question 3

如何修复 PodFetch OIDC invalid_grant 和 redirect_uri 与 Authelia 不匹配的问题，尤其是在刷新内部页面后？

Accepted Answer

将 PodFetch 升级到比 2026-07-08 镜像更新的当前 latest/main 构建；该修复不再从 window.location.href 推导 redirect_uri，而是在授权请求和令牌交换中都使用服务器配置的 OIDC 重定向 URI。将 OIDC_REDIRECT_URI 设置为在 Authelia 中注册的确切回调，例如 https://podfetch.example.com/ui/，然后更新并重启：docker compose pull && docker compose up -d。如果无法立即升级，请修补 ui/src/main.tsx，使回调清理正则也移除 scope、error 和 error_description：redirectUri.replace(/[?&](code|state|iss|session_state|scope|error|error_description)=[^&]*/g, '')。永久修复方案是使用已配置的固定重定向 URI，而不是当前浏览器 URL，这还可以防止在 /ui/home/view 等路由上刷新时发送未注册的 redirect_uri。

Question 4

为什么在 Docker 中 PodFetch 的系统信息页面上版本和 commit 缺失或为空？

Accepted Answer

这是 PodFetch Docker 镜像中的一个 bug（使用 samuel19982/podfetch:latest 时报告，推测为 5.2.2），导致无法在 /ui/info 获取版本和 commit 数据。该问题已在最新镜像中修复。运行 docker pull samuel19982/podfetch:latest 更新容器，然后重新创建它。如果使用 Docker Compose，请运行 docker compose pull && docker compose up -d。更新后，再次打开系统信息页面，以确认版本和 commit 已显示。

Question 5

如何修复在我的 RSS 客户端中播客单集显示为“Podfetch”而不是播客名称的问题？

Accepted Answer

请为每个播客节目使用专用的 RSS feed 端点，而不是 Podfetch 的通用合并 feed。在 Podfetch 中打开该节目，复制其单独的 feed URL（由 podcast ID 标识的 feed），并在你的 RSS 客户端中订阅该 URL。通用 feed 使用单个 RSS `Podfetch`，因此客户端会将每一集都显示为“Podfetch”。RSS 不支持在一个 feed 内包含多个 channel 标题，而更改 author 字段可能会产生过长的标题。截至该讨论时，尚无修复方案能让聚合 feed 显示各个播客名称；管理多个按节目划分的 feed 是受支持的变通方法。

PodFetch

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐