Castopod简介(一)在NAS上部署
真简介
castopod是啥?简单说是一个播客服务器,与很多播客托管服务器不同,它是一个“生产”服务器,也就是说你自己上传了播客内容,可以通过它来托管,并且分发到所有主流播客平台,例如apple podcast、YouTube podcast等,还可以通过该服务来查看听众数据,并且有很强的管理能力,例如设置付费播客等。
它还兼容podcast 2.0协议,以及去中心化的社交activityPub协议等。
我用来干啥?
其实我一直都有一个播客服务器,主要是用来上传一些自己的音频文件来方便收听的,因为可以用任何泛用性播客客户端来订阅,随时想听就听,很方便。
之前采用的方案是wordpress里安装Seriously Simple Podcasting插件来实现的,到今天我依然推荐这个方案,因为依托于wordpress功能非常强大,而且除了播客你也可以用来干别的。
但是这个方案对于我来说就是干这一件事,wordpress显得太“重”了,我想尝试一下新的方案。
内容
打算写两篇关于castopod的文章:
如何在自己家NAS上使用
docker compose来部署。如何尽量让服务器“私有”化,让别人无法收听你上传的内容。
安装
本来通过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”大版本下目前最新的镜像。官方现在还有
2.0.0-next.4镜像,属于测试阶段,我没部署成功。上面这个官方部署文件,只要修改
CP_BASEURL就可以跑起来了,要注意的是,访问链接只支持https,我是采用cloudflare tunnle来访问的,所以后面的ports参数只要保留http协议的端口号就行了。跑起来不等于能用,还要做文件的持久化,这里就是我碰到的最大的坑,根据文档,我们需要在本地创建
media、db、cache三个文件夹来映射容器内部文件夹,本来是特别简单的事,但这三个文件夹需要不同的权限。后来我发现其实官方文档也写的非常清楚了,这三个文件夹的权限要根据你的系统来设置。不过要注意的是,开始我以为在
docker compose文件里用user参数来定义就可以,其实不行,这还是最后问了AI才搞清楚的,要用ssh方式连接到NAS,然后用命令来设置这三个文件夹的权限,具体权限怎么设置可以问AI。到这里就容器就可以跑起来了,不过还有我没搞清楚的地方,就是数据库的密码和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 。
结束
祝大家玩的开心♥