五花肉肉's Blog

五花肉肉

Castopod简介(一)在NAS上部署

NAS
37
2026-09-09

真简介

castopod是啥?简单说是一个播客服务器,与很多播客托管服务器不同,它是一个“生产”服务器,也就是说你自己上传了播客内容,可以通过它来托管,并且分发到所有主流播客平台,例如apple podcast、YouTube podcast等,还可以通过该服务来查看听众数据,并且有很强的管理能力,例如设置付费播客等。

它还兼容podcast 2.0协议,以及去中心化的社交activityPub协议等。

我用来干啥?

其实我一直都有一个播客服务器,主要是用来上传一些自己的音频文件来方便收听的,因为可以用任何泛用性播客客户端来订阅,随时想听就听,很方便。

之前采用的方案是wordpress里安装Seriously Simple Podcasting插件来实现的,到今天我依然推荐这个方案,因为依托于wordpress功能非常强大,而且除了播客你也可以用来干别的。

但是这个方案对于我来说就是干这一件事,wordpress显得太“重”了,我想尝试一下新的方案。

内容

打算写两篇关于castopod的文章:

  1. 如何在自己家NAS上使用docker compose来部署。

  2. 如何尽量让服务器“私有”化,让别人无法收听你上传的内容。

安装

本来通过docker来安装是非常简单的事,而且官方还给了完整的docker compose文件,各参数也解释的很详细,但我愣是折腾了一天才安装好,所以要记录一下。

首先看看官方的docker compose文件。

services:
  castopod:
    image: castopod/castopod:1 # Pin to a specific version during production
    container_name: "castopod"
    volumes:
      - castopod-media:/app/public/media
    environment:
      MYSQL_DATABASE: castopod
      MYSQL_USER: castopod
      MYSQL_PASSWORD: changeme
      CP_BASEURL: "https://castopod.example.com"
      CP_ANALYTICS_SALT: changeme
      CP_CACHE_HANDLER: redis
      CP_REDIS_HOST: redis
      CP_REDIS_PASSWORD: changeme
    networks:
      - castopod-app
      - castopod-db
    ports:
      - "8080:8080" # HTTP
      - "8443:8443" # HTTPS
      - "8443:8443/udp" # HTTP/3
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 30s # allows bootstrap/migrations time
    depends_on:
      mariadb:
        condition: service_healthy
        restart: true
      redis:
        condition: service_started

  mariadb:
    image: mariadb:12.1
    container_name: "castopod-mariadb"
    networks:
      - castopod-db
    volumes:
      - castopod-db:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: changeme
      MYSQL_DATABASE: castopod
      MYSQL_USER: castopod
      MYSQL_PASSWORD: changeme
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      start_period: 10s
      interval: 10s
      timeout: 5s
      retries: 3

  redis:
    image: redis:8.4-alpine
    container_name: "castopod-redis"
    command: --requirepass changeme
    volumes:
      - castopod-cache:/data
    networks:
      - castopod-app

volumes:
  castopod-media:
  castopod-db:
  castopod-cache:

networks:
  castopod-app:
  castopod-db:
    internal: true

我最后部署好了以后发现其实非常简单,有几个地方注意一下就行了

  1. 其中第一个容器镜像的版本号“1”,意思是“1”大版本下目前最新的镜像。官方现在还有2.0.0-next.4镜像,属于测试阶段,我没部署成功。

  2. 上面这个官方部署文件,只要修改CP_BASEURL 就可以跑起来了,要注意的是,访问链接只支持https,我是采用cloudflare tunnle来访问的,所以后面的ports参数只要保留http协议的端口号就行了。

  3. 跑起来不等于能用,还要做文件的持久化,这里就是我碰到的最大的坑,根据文档,我们需要在本地创建media、db、cache三个文件夹来映射容器内部文件夹,本来是特别简单的事,但这三个文件夹需要不同的权限。

  4. 后来我发现其实官方文档也写的非常清楚了,这三个文件夹的权限要根据你的系统来设置。不过要注意的是,开始我以为在docker compose文件里用user参数来定义就可以,其实不行,这还是最后问了AI才搞清楚的,要用ssh方式连接到NAS,然后用命令来设置这三个文件夹的权限,具体权限怎么设置可以问AI。

  5. 到这里就容器就可以跑起来了,不过还有我没搞清楚的地方,就是数据库的密码和redis容器的密码,我尝试更改docker compose文件里设置的密码,改了后就会有问题,后来改一个就试一下,如果有问题就退回原样,其实容器都是跑在本地的,密码改不改我觉得问题不大。

其他参数

按照上面注意事项设置好以后castopod项目就可以跑起来了,要注意的是,只能使用CP_BASEURL设置的地址来访问。

除了上面文件中已经列出的参数外文档中还列出了其他参数,可以根据自己需要进行设置。castopod项目里很多参数是无法在网页端设置的,只能在部署容器的时候设置。

我还设置了发送邮件需要的参数,这个与后面要讲的内容有关。例如我用的Gmail,所以在第一个容器的environment 下再插入以下参数设置。

 # Gmail SMTP 邮件服务配置
      CP_EMAIL_FROM: "your_gmail_username@gmail.com"            # 填入您的 Gmail 邮箱地址
      CP_EMAIL_SMTP_HOST: "smtp.gmail.com"                      # Gmail SMTP 服务器地址
      CP_EMAIL_SMTP_USERNAME: "your_gmail_username@gmail.com"   # 您的 Gmail 账号
      CP_EMAIL_SMTP_PASSWORD: "xxxxxxxxxxxxxxxx"                # Google 16 位“应用专用密码” 不能有空格
      CP_EMAIL_SMTP_PORT: 587                                   # Gmail 推荐的 TLS 端口
      CP_EMAIL_SMTP_CRYPTO: "tls"                               # 端口 587 对应加密协议为 "tls" 

第一次

项目跑起来后第一次打开网页,也就是CP_BASEURL 设置的网址是看不到什么设置、登录之类的选项的,要在网址后添加cp-install来创建一个管理员账户。也就是访问连接应该为https://your-CP_BASEURL/cp-install。

后续要进入管理后台的话,网址后面加上cp-admin,也就是https://your-CP_BASEURL/cp-admin 。

结束

祝大家玩的开心♥