17c - 安装指南

17c 影视资讯站「安装指南」：从环境准备到上线校验

本页面向需要在自有服务器、NAS 或本地开发环境部署「17c」影视资讯站点的站长与运维人员。与常见的“一键脚本”教程不同，本指南的每一步都经过编辑团队人工核对：我们会在真实网络环境（含弱网与高并发场景）中复现安装流程，确认命令输出与页面表现一致后才写入文档。文中涉及的版本号、依赖项与配置项，均以最近一次人工复核的结果为准。

一、安装前准备：环境与依赖核对

17c 采用前后端分离架构，影视资讯内容以静态化方式输出，因此安装前需要确认三类基础条件：运行时、数据库与缓存、以及反向代理。建议使用 Linux（Ubuntu 22.04 / Debian 12）或 macOS 进行部署，Windows 环境请使用 WSL2。

• 运行时：Node.js 20 LTS 或以上，包管理器建议 pnpm 9.x；若使用容器部署，需 Docker 24+ 与 Compose v2。
• 数据库：PostgreSQL 15+（推荐）或 MySQL 8.0+，字符集统一为 utf8mb4，时区设置为 Asia/Shanghai。
• 缓存：Redis 7.x，用于影视条目热度排行与页面片段缓存。
• 反向代理：Nginx 1.24+，需开启 gzip 与 brotli，并为静态资源配置长缓存。

请特别注意：部分影视资讯源对请求频率敏感，安装阶段若开启“全量抓取”，可能触发源站限流。编辑团队在人工核对时发现，将并发数控制在 5 以内、并设置 800ms 以上的请求间隔，可以显著降低失败率。相关参数在配置文件中均有注释说明。

二、获取安装包与初始化配置

17c 的安装包分为“稳定版”与“预览版”。生产环境请只使用稳定版，预览版仅用于测试新模板与评分组件。下载后务必校验 SHA-256 摘要，摘要值公布在版本发布页，并由编辑人工比对后同步至本指南。

• 解压安装包至目标目录，例如 /var/www/17c，确保运行用户对该目录有读写权限。
• 复制 .env.example 为 .env，填写数据库连接串、Redis 地址、站点域名与管理员邮箱。
• 执行依赖安装与数据库迁移命令，迁移日志会输出每一步影响的表结构，请完整保留日志以便排错。
• 初始化管理员账号后，立即修改默认密码，并开启两步验证。

配置文件中与“评分来源”相关的字段需要重点说明：17c 的影视评分由站内编辑评分与外部公开评分两部分构成，外部评分必须标注来源与抓取时间。安装时请确认 RATING_SOURCE_WHITELIST 仅包含已获授权的来源域名，避免出现来源不明的评分数据。这一设计是为了保证内容可信度，也是我们坚持 E-E-A-T 原则的具体体现。

三、上线前校验与 48 小时纠错机制

安装完成后不要急于对外开放。请按以下清单逐项校验：首页与详情页能否正常渲染；影视条目封面是否走 CDN；搜索与筛选在弱网下是否有降级方案；评分组件是否显示来源与更新时间；站点地图与 RSS 是否可访问。我们建议使用真实设备（手机 + 桌面）各测一遍，而不是只看桌面浏览器。

17c 对已发布内容实行48 小时纠错承诺：安装上线后 48 小时内，若发现配置错误、评分来源缺失或页面信息与源站不符，可通过站内“纠错”入口提交，编辑团队会在 48 小时内人工复核并修正，同时在页面留下修订记录。该机制同样适用于本安装指南——若你在部署过程中发现命令或参数与当前版本不符，欢迎提交纠错，我们会人工验证后更新文档。

• 人工核对：所有安装步骤均在隔离环境复现，截图与命令输出一一对应。
• 评分来源：外部评分必须可追溯，白名单外的来源一律不展示。
• 48 小时纠错：上线后 48 小时内的问题反馈优先处理，修订记录公开可查。

最后提醒：安装只是起点。影视资讯站的内容更新频率高，建议配置定时任务同步资讯源，并定期检查缓存命中率与数据库索引。完成以上步骤后，你的 17c 站点即可进入试运行阶段。