17c - 安装指南

17c 安装指南：从环境准备到上线校验

本指南面向首次在自有服务器或本地环境部署「17c」影视资讯站的运营与技术人员。全文步骤均经过编辑团队人工核对，涉及依赖版本、目录权限与缓存策略的说明以 2024 年第四季度实测环境为准。若你在执行中发现与本文不符之处，欢迎通过站内纠错通道反馈，我们承诺在 48 小时内完成核实与修订。

一、安装前的环境确认

17c 采用前后端分离架构，安装前请先确认基础环境满足最低要求。建议使用 Linux（Ubuntu 22.04 或 CentOS 8 以上）作为生产环境，Windows 与 macOS 可用于本地调试。

• 运行时：Node.js 18.x 或 20.x LTS，包管理器建议 pnpm 8 以上。
• 数据库：MySQL 8.0 或 PostgreSQL 14，字符集统一为 utf8mb4。
• 缓存：Redis 6.2 以上，用于会话与热点榜单缓存。
• Web 服务：Nginx 1.20 以上，负责静态资源与反向代理。
• 磁盘：预留不少于 20GB，海报与剧照资源建议单独挂载数据盘。

需要特别说明的是，17c 的影视条目评分与榜单数据来自编辑人工复核后的入库结果，安装过程不会自动抓取第三方评分。因此环境准备阶段无需配置外部评分接口，但请确保数据库时区设置为 Asia/Shanghai，以免榜单按日切分时出现偏差。

二、获取安装包与依赖安装

请从官方发布渠道下载对应版本的安装包，下载后务必校验 SHA256 摘要。编辑团队在每次发版前会人工核对发布包的哈希值与变更日志，校验不一致的包请勿使用。

• 解压安装包至目标目录，例如 /opt/17c，并确保运行用户对该目录具备读写权限。
• 进入项目根目录执行 pnpm install --frozen-lockfile，锁定依赖版本，避免因小版本漂移导致构建失败。
• 复制 .env.example 为 .env，填写数据库连接、Redis 地址、站点域名与上传目录。
• 执行数据库迁移命令，初始化表结构与基础字典数据。

安装过程中若出现依赖下载缓慢，可切换至国内镜像源，但请勿修改 lockfile 中的版本号。我们曾在测试环境遇到过因手动升级某图像处理依赖导致海报裁剪异常的问题，此类改动建议在独立分支验证后再合并。

三、站点配置与首次启动

配置文件是安装环节中最容易出错的部分，请逐项核对。站点名称、备案信息、版权声明等展示字段会直接影响页面合规性，编辑团队会在上线前进行人工核对，但部署方仍需自行确认主体资质。

• 站点域名：填写正式域名，若启用 HTTPS，请同步配置证书路径并开启强制跳转。
• 上传目录：指向数据盘挂载路径，权限设置为运行用户可读写，禁止对外直接执行脚本。
• 缓存策略：首页与榜单页建议设置 60 秒页面缓存，详情页按条目更新时间做增量失效。
• 安全项：关闭调试模式，设置管理后台访问白名单，修改默认管理员密码。

完成配置后执行启动命令，观察日志中是否出现数据库连接失败、Redis 超时或目录不可写等报错。首次启动会自动生成站点地图与静态化页面，耗时通常在 1 至 3 分钟，期间请勿重复触发启动脚本。

四、上线校验与纠错机制

启动成功后，请按以下清单完成上线校验：访问首页与至少三个详情页，确认海报、剧照与简介正常加载；检查榜单页排序是否与后台配置一致；提交一条测试评论验证审核流程；使用移动端访问确认响应式布局无错位。

17c 的评分与榜单数据均标注来源与复核时间，安装完成后请勿擅自修改评分计算逻辑，以免与展示口径不一致。若你在校验中发现文档描述与实际行为存在差异，可通过站内纠错入口提交，附上环境信息与复现步骤。我们承诺在 48 小时内完成人工核实，确认问题后同步更新本指南与变更日志。安装不是一次性工作，后续版本升级前请先阅读升级说明，并在测试环境完成验证后再操作生产环境。