Castopod Nginx配置镜像

镜像概述和主要用途

本镜像为Castopod播客平台设计，提供预配置的Nginx环境，旨在简化Castopod的Docker部署。通过集成针对Castopod优化的Web服务器配置，实现媒体文件托管、请求路由、HTTPS支持及安全加固，确保Castopod平台稳定高效运行。

核心功能和特性

• Castopod专用配置：内置针对Castopod的URL路由规则、PHP-FPM反向代理及媒体文件处理策略
• HTTPS支持：可配置SSL/TLS加密，支持证书挂载，满足生产环境安全需求
• 媒体优化：针对音频文件传输优化，支持断点续传与流式播放
• 缓存机制：静态资源（CSS/JS/图片）缓存配置，提升访问速度
• 安全加固：包含Content-Security-Policy、X-Frame-Options等安全HTTP头，防御常见Web***
• 灵活配置：支持通过环境变量或配置文件挂载自定义参数

使用场景和适用范围

适用于采用Docker部署Castopod的用户，包括：

• 个人或机构播客创作者搭建Castopod平台
• 开发/测试环境中快速部署Castopod服务
• 生产环境下为Castopod提供稳定的Web服务器支持

详细使用方法和配置说明

前提条件

• Docker Engine 20.10+ 或 Docker Desktop
• Castopod应用容器（如castopod/app）已部署且网络互通

镜像获取

docker pull castopod/nginx:latest

基础部署（docker run）

docker run -d \
  --name castopod-nginx \
  --network castopod-net \  # 与Castopod应用容器共享网络
  -p 80:80 \
  -p 443:443 \
  -v /path/to/ssl:/etc/nginx/ssl:ro \  # 挂载SSL证书（可选）
  -v castopod-media:/var/www/castopod/public/media \  # 媒体文件持久化卷
  -e SERVER_NAME=podcast.example.com \  # 自定义域名
  -e PHP_FPM_HOST=castopod-app \  # Castopod应用容器名称
  -e ENABLE_HTTPS=true \  # 启用HTTPS（需确保ssl目录存在证书）
  castopod/nginx:latest

Docker Compose配置示例

推荐与Castopod应用容器联动部署：

version: '3.8'

services:
  nginx:
    image: castopod/nginx:latest
    container_name: castopod-nginx
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./ssl:/etc/nginx/ssl:ro  # SSL证书目录（cert.pem和key.pem）
      - castopod-media:/var/www/castopod/public/media
    environment:
      - SERVER_NAME=podcast.example.com
      - PHP_FPM_HOST=app
      - PHP_FPM_PORT=9000
      - ENABLE_HTTPS=true
      - CACHE_MAX_AGE=31536000  # 静态资源缓存1年
    depends_on:
      - app
    networks:
      - castopod-net

  app:
    image: castopod/app:latest
    # Castopod应用容器配置（参考Castopod***文档）
    networks:
      - castopod-net

volumes:
  castopod-media:  # 媒体文件持久化卷

networks:
  castopod-net:

环境变量配置

自定义配置

如需修改Nginx规则，可挂载自定义配置文件覆盖默认设置：

docker run -d \
  # 其他参数省略
  -v ./custom-castopod.conf:/etc/nginx/conf.d/castopod.conf \  # 自定义配置文件
  castopod/nginx:latest

注意事项

• 生产环境必须启用HTTPS，建议使用Let's Encrypt获取免费证书
• 媒体文件目录需通过持久化卷挂载，避免容器重启导致数据丢失
• 修改配置后需重启容器使变更生效：docker restart castopod-nginx
• 高流量场景下建议配置Nginx日志轮转，避免日志文件过大