17c - 安装指南

17c 安装指南：从环境准备到首次启动

本指南面向首次在本地或私有服务器部署 17c 影视资讯站点的用户。17c 是一套以影视资讯聚合、评分展示与片单管理为核心的内容系统，安装过程并不复杂，但对运行环境、目录权限与数据初始化有一定要求。为保证你获得可复现的结果，本文所有步骤均由编辑团队在真实环境中人工核对，并标注了常见失败点。若你在安装过程中发现文档与实际版本不一致，欢迎通过站内纠错通道反馈，我们承诺在 48 小时内完成核实与修订。

一、安装前的环境核对

开始之前，请先确认服务器满足最低运行条件。17c 依赖 PHP 8.1 及以上版本、MySQL 5.7 或 MariaDB 10.3 以上、以及开启 URL 重写能力的 Web 服务器（Nginx 或 Apache 均可）。建议预留至少 2GB 可用磁盘空间，用于存放海报缓存与日志文件。编辑团队在撰写本节时，分别在一台 2 核 4G 的云主机和一台本地虚拟机中完成了完整安装，两次结果一致，因此以下参数可以作为可靠基线。

• PHP 扩展：需启用 pdo_mysql、mbstring、gd、curl、fileinfo，缺一不可。
• 目录权限：storage/ 与 public/uploads/ 需可写，推荐权限 755、属主为 Web 运行用户。
• 数据库：提前创建空库并设置 utf8mb4 字符集，避免中文片名出现乱码。
• 伪静态：Nginx 需配置 try_files 回退规则，否则详情页会返回 404。

需要说明的是，17c 的评分数据并非抓取后直接展示。所有评分来源均在后台标注了出处与采集时间，并由编辑人工抽检核对，确保展示的分数与来源站点一致。安装完成后，你可以在「数据源管理」中看到每个来源的核对状态标记。

二、上传程序与执行安装向导

将发行包解压至站点根目录后，通过浏览器访问 /install 进入安装向导。向导共分四步：环境检测、数据库配置、管理员账号创建、示例数据导入。环境检测页面会逐项列出扩展与权限状态，任何一项标红都应先处理再继续，强行跳过往往会在后续导入阶段报错。

数据库配置环节需填写主机、端口、库名、用户名与密码。若你的数据库端口非默认 3306，请显式填写，否则连接会超时。管理员账号建议使用独立强密码，并妥善保存——17c 不提供默认账号，这一点与部分同类系统不同，请勿在安装后尝试用 admin/admin 登录。

示例数据导入为可选项。若你希望站点上线即有内容结构，可勾选导入；若计划接入自有片单，建议跳过，避免后期清理示例条目。导入过程约需 1–3 分钟，期间请勿刷新页面。

三、安装后的必要配置

向导结束后，请立即删除或重命名 install 目录，防止被重复执行。随后登录后台完成三项基础配置：站点名称与备案信息、伪静态规则确认、以及计划任务（用于评分同步与缓存清理）。计划任务需在服务器 crontab 中添加一条每分钟执行的心跳命令，具体命令在后台「系统工具」页可直接复制。

• 伪静态验证：随机打开一部影片详情页与一个分类页，确认均返回 200。
• 缓存目录：首次访问后检查 storage/cache 是否生成文件，为空说明权限仍有问题。
• 邮件与通知：如需接收纠错提醒，配置 SMTP 后发送测试邮件。

关于内容可信度：17c 的影片条目、评分与简介均经过编辑人工核对，评分来源在条目页脚有明确标注；若用户发现信息有误，可通过条目页的「纠错」按钮提交，运营团队会在 48 小时内完成复核与修正，并在修订记录中留痕。这一机制同样适用于安装文档本身。

四、常见问题与排查思路

安装阶段最常见的问题是 500 错误与白屏，九成以上源于目录权限或 PHP 扩展缺失，可按第一节清单逐项回查。其次是数据库连接失败，请确认账号具备该库的全部权限，而不只是读取权限。若详情页 404 而首页正常，基本可判定为伪静态未生效。最后提醒：升级前务必备份数据库与 storage/ 目录，17c 的版本迭代较快，备份是最省时的排错手段。

如按本指南操作后仍无法完成安装，请附上环境检测页截图与错误日志片段提交反馈。我们会人工核对你的环境信息，并在 48 小时内给出可执行的排查建议。