castopod/app

Castopod Docker镜像文档

镜像概述和主要用途

Castopod是一款开源播客托管平台，该Docker镜像为Castopod应用的官方捆绑包，集成了运行Castopod所需的全部依赖项（包括Web服务器、PHP环境、必要扩展及工具等）。该镜像旨在简化播客平台部署流程，用户无需手动配置底层依赖，可快速搭建功能完善、独立可控的播客托管服务。

核心功能和特性

• 完整播客生命周期管理：支持播客创建、节目编辑、发布管理及订阅者维护
• 直观Web管理界面：提供图形化后台，简化内容上传、元数据配置和平台设置
• 多媒体处理能力：集成音频文件上传、转码、存储及分发功能，支持主流音频格式
• SEO与分发优化：内置播客SEO工具，自动生成符合行业标准的播客Feed，提升在搜索引擎和播客目录中的可见性
• 多语言与本地化：支持多语言界面及内容本地化，满足国际化播客需求
• 安全加固：包含基础安全配置，保护用户数据及播客内容安全
• 依赖全集成：预装Nginx、PHP-FPM、数据库驱动等所有运行依赖，开箱即用

使用场景和适用范围

• 个人播客创作者：无需依赖第三方平台，自建专属播客站点，完全掌控内容与数据
• 小型媒体团队：低成本搭建团队播客平台，支持多创作者协作与内容管理
• 教育与培训机构：用于托管教学播客，实现知识共享与远程学习资源建设
• 企业内部沟通：创建企业内部播客频道，用于员工培训、公告发布等内部沟通场景

详细使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+）及Docker Compose（v2+）
• 具备基础Docker命令操作能力
• 生产环境需准备域名及SSL证书（推荐Let's Encrypt）
• 建议分配至少2GB内存及20GB存储空间（根据媒体文件规模调整）

快速启动（单容器模式）

注：单容器模式需外部数据库支持，推荐使用MariaDB/MySQL

bash
docker run -d \
  --name castopod \
  -p 80:80 \
  -e CP_BASEURL="https://podcast.example.com" \
  -e CP_DATABASE_HOST="db-host" \
  -e CP_DATABASE_NAME="castopod_db" \
  -e CP_DATABASE_USER="castopod_user" \
  -e CP_DATABASE_PASSWORD="your_strong_password" \
  -v castopod_media:/var/www/html/media \
  docker.xuanyuan.run/castopod/app:latest

推荐部署（Docker Compose）

创建docker-compose.yml文件，配置完整服务栈（含应用、数据库、缓存）：

yaml
version: '3.8'

services:
  app:
    image: docker.xuanyuan.run/castopod/app:latest
    container_name: castopod_app
    restart: always
    ports:
      - "80:80"    # HTTP端口（生产环境建议配合反向代理使用HTTPS）
      - "443:443"  # HTTPS端口（需挂载SSL证书）
    environment:
      # 基础配置
      - CP_BASEURL="https://podcast.example.com"
      - CP_ENV="production"
      
      # 数据库配置
      - CP_DATABASE_HOST="db"
      - CP_DATABASE_NAME="castopod"
      - CP_DATABASE_USER="castopod"
      - CP_DATABASE_PASSWORD="your_db_password"
      
      # Redis缓存配置
      - CP_REDIS_HOST="redis"
      - CP_REDIS_PASSWORD="your_redis_password"
      
      # 媒体存储配置（默认本地存储）
      - CP_MEDIA_STORAGE="local"
    volumes:
      - castopod_media:/var/www/html/media       # 媒体文件存储
      - ./ssl:/etc/nginx/ssl                     # SSL证书挂载（生产环境）
      - ./config:/var/www/html/.env              # 配置文件持久化（可选）
    depends_on:
      - db
      - redis

  db:
    image: docker.xuanyuan.run/mariadb:10.11
    container_name: castopod_db
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD="root_password"
      - MYSQL_DATABASE="castopod"
      - MYSQL_USER="castopod"
      - MYSQL_PASSWORD="your_db_password"
    volumes:
      - castopod_db:/var/lib/mysql
    command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci

  redis:
    image: docker.xuanyuan.run/redis:7-alpine
    container_name: castopod_redis
    restart: always
    command: redis-server --requirepass "your_redis_password"
    volumes:
      - castopod_redis:/data

volumes:
  castopod_media:
  castopod_db:
  castopod_redis:

启动服务：

bash
docker-compose up -d

核心环境变量配置

部署后配置流程

1. 初始化安装：访问CP_BASEURL，通过Web向导完成管理员账户创建及基础设置
2. 媒体存储配置：在管理后台「设置-媒体」中配置存储策略（本地/云存储）
3. SSL配置：生产环境需通过反向代理（如Nginx）或直接挂载证书配置HTTPS
4. 备份策略：定期备份castopod_db卷（数据库）和castopod_media卷（媒体文件）
5. 更新维护：通过docker-compose pull && docker-compose up -d更新镜像

注意事项

• 生产环境必须启用HTTPS，否则可能影响播客客户端订阅功能
• 媒体文件建议使用外部存储（如S3兼容对象存储），避免容器存储容量限制
• 数据库定期备份，可通过docker exec castopod_db mysqldump -u castopod -p'your_db_password' castopod > backup.sql实现
• 详细文档及最新更新请参考官方指南：Castopod Docker文档