akhilrex/podgrab

Podgrab Docker镜像文档

镜像概述

Podgrab是一个自托管的播客管理器，采用GO语言构建，轻量级设计，能够自动下载最新发布的播客集。它特别适合需要直接获取播客MP3文件的用户，解决了多数播客应用不直接暴露音频文件的问题。支持通过RSS链接、OPML导入或iTunes搜索添加播客，并提供本地存储管理和内置播放器。

核心功能与特性

• 自动与手动下载：支持自动下载新发布的播客集，也可按需手动下载
• 完整播客归档：可下载并归档整个播客历史内容
• 播客发现：通过iTunes API实现播客搜索功能
• 多添加方式：支持直接RSS链接、OPML导入和搜索添加
• 内置播放器：可播放已下载文件或直接流播放客源
• 文件检测：自动检测已存在文件，避免重复下载
• OPML导入/导出：方便播客列表的备份与迁移
• 自定义文件名：支持自定义播客集文件名格式
• 基本认证：可通过用户名密码保护访问（用户名为podgrab）
• 暗黑模式：提供深色主题，优化夜间使用体验
• 自托管与开源：完全本地部署，代码开源可审计
• Docker支持：提供Docker镜像，简化部署流程

使用场景

• 希望离线收听播客，需要本地存储音频文件
• 在智能手表、MP3播放器等设备上播放播客（需直接MP3文件）
• 需要管理多个播客源，集中管理收听历史
• 希望控制播客内容的存储位置和备份
• 对第三方播客平台隐私或功能限制有顾虑的用户

安装与使用方法

Docker快速部署

测试/评估部署（无持久化存储）

bash
docker run -d -p 8080:8080 --name=podgrab akhilrex/podgrab

生产部署（带持久化存储）

挂载本地目录以持久化配置和播客文件：

bash
docker run -d -p 8080:8080 --name=podgrab \
  -v "/host/path/to/config:/config" \
  -v "/host/path/to/assets:/assets" \
  akhilrex/podgrab

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: "2.1"
services:
  podgrab:
    image: akhilrex/podgrab
    container_name: podgrab
    environment:
      - CHECK_FREQUENCY=240  # 检查新集的频率（分钟）
      # - PASSWORD=your_password  # 取消注释以启用基本认证，用户名为podgrab
    volumes:
      - /path/to/config:/config  # 配置文件存储路径
      - /path/to/data:/assets    # 播客文件存储路径
    ports:
      - 8080:8080  # 访问端口
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

环境变量配置

初始设置注意事项

1. 反向代理配置：若使用反向代理，需启用WebSocket支持，以确保"添加到播放列表"功能正常
2. 首次使用：建议先访问设置页面（http://<ip>:8080/settings）调整参数，再添加播客

许可协议

Podgrab基于MIT许可协议开源，详见https://github.com/akhilrex/podgrab/blob/master/LICENSE.txt%E3%80%82

开发路线图

已实现功能：

• 基本认证
• 文件名日期追加
• iTunes搜索
• 已存在文件检测
• 下载状态指示
• 播放状态标记（已播放/未播放）
• OPML导入/导出
• 内置播放器

计划功能：

• ID3标签自动补全
• 内容过滤与排序
• Windows/Linux/MacOS原生安装包