madeofpendletonwool/pinepods

PinePods

镜像概述和主要用途

PinePods是一个基于Rust的播客管理系统，具备多用户支持，依赖中央数据库存储数据，客户端可连接服务器访问。它采用浏览器界面，所有播客和设置均存储在服务器端，实现跨设备同步。支持移动设备访问，并可与Nextcloud服务器同步，允许使用Antennapod等外部应用。该系统完全自托管且开源，提供现代化UI，支持播客搜索、用户管理及主题切换。

核心功能和特性

• 完整播客管理：支持播放、下载播客，跟踪用户（及多用户）喜爱的播客内容
• 播客搜索：通过The Podcast Index或iTunes搜索新播客
• 现代化UI：提供直观界面浏览播客节目和 episodes
• 多用户支持：支持多用户同时使用，提供简单的用户管理功能
• 数据存储：使用MySQL数据库（计划支持其他数据库）存储用户设置、播客和episodes信息
• 自托管与开源：完全自托管，源代码开放
• 搜索API选项：可使用托管的搜索API，或通过Podcast Index获取API密钥使用自有API
• 主题选择：提供多种主题供用户选择
• 跨设备同步：通过服务器存储实现跨设备访问
• Nextcloud集成：支持与Nextcloud同步，兼容外部播客应用

使用场景和适用范围

• 自托管用户：希望完全控制播客数据和服务的个人或组织
• 多用户环境：家庭、团队或小型组织共享播客服务
• 跨设备用户：需要在不同设备（电脑、手机等）访问播客的用户
• 外部应用用户：希望使用Antennapod等外部播客应用的用户
• 开源爱好者：偏好使用开源软件并参与项目改进的用户

详细使用方法和配置说明

服务器安装

推荐使用Docker Compose部署PinePods服务器。以下是基本的compose文件模板和配置说明。

Docker Compose配置

yaml
version: '3'
services:
  db:
    image: mariadb:latest
    command: --wait_timeout=1800
    environment:
      MYSQL_TCP_PORT: 3306
      MYSQL_ROOT_PASSWORD: myS3curepass  # 数据库root密码
      MYSQL_DATABASE: pypods_database    # 数据库名称
      MYSQL_COLLATION_SERVER: utf8mb4_unicode_ci
      MYSQL_CHARACTER_SET_SERVER: utf8mb4
      MYSQL_INIT_CONNECT: 'SET @@GLOBAL.max_allowed_packet=64*1024*1024;'
    volumes:
      - /home/user/pinepods/sql:/var/lib/mysql  # 数据库数据持久化路径
    ports:
      - "3306:3306"
    restart: always
  pinepods:
    image: madeofpendletonwool/pinepods:latest
    ports:
      - "8040:8040"  # PinePods主端口
    environment:
      # 基本服务器信息
      SEARCH_API_URL: 'https://search.pinepods.online/api/search'  # 搜索API地址
      # 默认管理员用户信息
      USERNAME: myadminuser01       # 管理员用户名
      PASSWORD: myS3curepass        # 管理员密码
      FULLNAME: Pinepods Admin      # 管理员全名
      EMAIL: user@pinepods.online   # 管理员邮箱
      # 数据库配置
      DB_TYPE: mariadb              # 数据库类型
      DB_HOST: db                   # 数据库服务名（与compose中db服务对应）
      DB_PORT: 3306                 # 数据库端口
      DB_USER: root                 # 数据库用户名
      DB_PASSWORD: myS3curepass     # 数据库密码（需与MYSQL_ROOT_PASSWORD一致）
      DB_NAME: pypods_database      # 数据库名称（需与MYSQL_DATABASE一致）
      # 调试模式
      DEBUG_MODE: False             # 是否启用调试模式
    volumes:
      - /home/user/pinepods/downloads:/opt/pinepods/downloads  # 播客下载文件存储路径
      - /home/user/pinepods/backups:/opt/pinepods/backups      # 备份文件存储路径
    depends_on:
      - db

配置变量说明

1. 数据库配置

   • MYSQL_ROOT_PASSWORD：数据库root用户密码，需与DB_PASSWORD保持一致
   • MYSQL_DATABASE：数据库名称，需与DB_NAME保持一致
   • MYSQL_CHARACTER_SET_SERVER：数据库字符集，建议使用utf8mb4

2. 管理员用户信息

   • USERNAME：默认管理员用户名，用于初始登录
   • PASSWORD：管理员密码，建议设置强密码
   • FULLNAME：管理员显示名称
   • EMAIL：管理员***地址

   若未指定管理员信息，系统将自动创建随机密码的账户，建议手动配置

3. 搜索API配置

   • SEARCH_API_URL：播客搜索API地址，可使用官方托管API（https://search.pinepods.online/api/search）或自建API

   官方托管API不保证100% uptime，推荐自建API（详见搜索API文档）

4. 存储卷配置

   • downloads：播客下载文件存储路径，可挂载NAS或其他存储设备
   • backups：系统备份文件存储路径（Web端备份使用，客户端备份本地存储）

启动服务

1. 根据需求修改compose文件中的配置变量（尤其是密码和路径）
2. 执行以下命令启动服务：

   bash
   sudo docker-compose up
   

3. 服务启动后，通过http://<服务器IP>:8040访问PinePods界面
4. 使用配置的管理员账户登录，开始使用系统

测试实例

官方提供测试实例供体验：try.pinepods.online，可创建临时账户测试功能。注意：测试实例账户会定期清理，不适合长期使用。

更多资源

• 官方网站
• https://github.com/madeofpendletonwool/PinePods
• 完整文档
• 基础使用教程