--- title: 安装 sidebarDepth: 3 --- # 如何安装 Castopod ？ Castopod 的安装非常简单。 你能在大多数兼容的 PHP-MySQL 的服务器上安装 Castopod， 无论是专用还是 共享主机。 ::: 注意 我们已经发布 Castopod 的官方 Docker 镜像！ 如果你更喜欢使用 Docker，则可以跳过此步骤，直接前往 Castopod 的 [Docker 文档](./docker.md)。 ::: ## 要求 - PHP 8.1 或更高版本 - MySQL 5.7 或更高版本与 MariaDB 10.2 或更高版本 - HTTPS 支持 ### PHP 8.1 或更高版本 需要 PHP 8.1 或更高版本，并安装以下扩展： - [intl](https://php.net/manual/en/intl.requirements.php) - [libcurl](https://php.net/manual/en/curl.requirements.php) - [mbstring](https://php.net/manual/en/mbstring.installation.php) - [gd](https://www.php.net/manual/en/image.installation.php) 与 **JPEG**, **PNG** 和 **WEBP** 库。 - [exif](https://www.php.net/manual/en/exif.installation.php) 此外，请确保在 PHP 中启用以下扩展： - json (默认启用-不要关闭) - xml (默认启用-不要关闭) - [mysqlnd](https://php.net/manual/en/mysqlnd.install.php) ### 兼容 MySQL 的数据库 > 我们建议使用 [MariaDB](https://mariadb.org)。 ::: 警告 Castopod 仅适用于受支持的 MySQL 5.7 或更高版本的兼容数据库。 例如，MySQL 5.6 已 经不受支持，因为它于 2021 年 2 月 5 日已停止更新。 ::: 你需要填写服务器主机名、数据库名称、用户名和密码才能完成安装过程。 如果没有这些 ，请与你的服务器管理员联系。 #### 权限 用户至少需要在数据库中有这些权限，Castopod 才能工作： `CREATE`，`ALTER`，`DELETE`，`EXECUTE`，`INDEX`，`INSERT`，`SELECT`，`UPDATE`，`REFERENCES`，`CREATE VIEW`。 ### （可选）FFmpeg v4.1.8 或更高版本，用于视频素材 如果你需要视频素材，则需要 [FFFmpeg](https://www.ffmpeg.org/) 4.1.8 或更高版本。 必须安装以下扩展： - **FreeType 2** 来自库 [gd](https://www.php.net/manual/en/image.installation.php) ### （可选）其他建议 - 使用 Redis 提高缓存性能。 - CDN 用于静态文件缓存以实现更好的性能。 - 电子邮件用于找回密码。 ## 安装说明 ### 准备环境 0. 需要一台已经实现 [环境要求](#requirements)的 Web 服务器 1. 为 Castopod 创建一个 MySQL 数据库，其中用户具有访问和修改权限（有关详细信息， 请参阅 [MySQL 兼容数据库](#mysql-compatible-database)）。 2. 使用 _SSL 证书_ 在您的域激活 HTTPS。 3. 下载最新的 [Castopod](https://castopod.org/) 到 web 服务器并解压（如果尚未下 载）。 - ⚠️ 将 web 服务器根目录设置为 `castopod` 文件夹中的 `public/` 子文件夹。 4. 在 Web 服务器上为各种后台进程添加 **cron 任务** （相应地替换路径） - 为了使社交功能正常工作，此任务用于向联邦宇宙中的关注者发送活动： ```bash * * * * * /path/to/php /path/to/castopod/public/index.php scheduled-activities ``` - 使用 [WebSub](https://en.wikipedia.org/wiki/WebSub) 在发布时将您的剧集广播 在公共平台： ```bash * * * * * /usr/local/bin/php /castopod/public/index.php scheduled-websub-publish ``` - 如果需要使用视频素材(请参阅 [FFmpeg 要求](#ffmpeg-v418-or-higher-for-video-clips))： ```bash * * * * * /path/to/php /path/to/castopod/public/index.php scheduled-video-clips ``` > 这些任务 **每分钟**运行一次。 你可以根据需要设置频率：每 5 分钟，10 分钟或 > 更长的时间。 ### (推荐) 安装向导 1. 前往你最喜欢的浏览器并跳转至安装向导页面 (`https://your_domain_name.com/cp-install`)运行 Castopod 安装脚本。 2. 请按照屏幕上的说明进行操作。 3. 开始播客！ ::: 注意 安装脚本将会在根目录中创建一个 `.env` 文件并写入数据。 如果你不能执行安装向导， 那么可以基于 `.env.example` 文件手动创建和编辑 `.env` 文件。 ::: ### 邮箱/SMTP 设置 某些功能需要电子邮件配置才能正常工作（例如： 找回密码，向高级订阅者发送说明， …) 你可以在实例的 `.env` 中添加你的电子邮件配置，如下所示： ```ini # […] email.fromEmail="你的邮件地址" email.SMTPHost="你的邮件主机" email.SMTPUser="你的邮件用户名" email.SMTPPass="你的邮件密码" ``` #### 电子邮件配置选项 | 变量名称 | 类型 | 默认 | | ---------------- | -------------------- | ------------ | | **`fromEmail`** | string | `undefined` | | **`fromName`** | string | `"Castopod"` | | **`SMTPHost`** | string | `undefined` | | **`SMTPUser`** | string | `undefined` | | **`SMTPPass`** | string | `undefined` | | **`SMTPPort`** | number | `25` | | **`SMTPCrypto`** | [`"tls"` or `"ssl"`] | `"tls"` | ## 社区套餐 如果你不想手动安装 Castopod，可以使用一个 由开源社区创建和维护的软件包。 ### 使用 YunoHost 安装 [YunoHost](https://yunohost.org/) 是一个基于 Debian GNU/Linux 的发行版，由免费和 开源软件包组成。 它可以为你解决自托管的困难。
从 YunoHost 安装 Castopod Github Repo