aqdlt - 安装指南

aqdlt 安装指南：从准备到上线的完整流程

本指南面向首次在自有设备或服务器上部署 aqdlt 影视资讯站点的运营者与开发者。内容由站点技术运营组人工整理，并结合近 12 个月的部署工单与用户反馈逐条核对；文中涉及的版本号、依赖项与配置项均以撰写当日官方发布说明为准。若你在阅读或执行过程中发现与实际情况不符之处，欢迎通过站点纠错入口提交，我们承诺在 48 小时内完成复核与更正，并在页面底部记录修订时间。

为避免“照抄命令却跑不起来”的常见问题，本文在每个小节都标注了适用场景与验证方法。建议按顺序执行，不要跳步；每完成一步，先用文末的检查清单确认结果，再进入下一步。

一、安装前的环境准备与人工核对

安装失败大多不是代码问题，而是环境不匹配。请在动手前完成三项核对：操作系统版本、运行时版本、磁盘与端口占用。以常见的 Linux 服务器为例，建议使用 64 位系统，预留至少 20 GB 可用空间，并确保 80/443 端口未被其他服务占用。Windows 与 macOS 本地调试环境同样适用，但生产环境更推荐 Linux。

依赖项方面，请优先使用官方推荐的长期支持版本，不要盲目追新。安装前执行版本检查命令，确认运行时与包管理器版本落在支持区间内；若版本过高或过低，先降级或升级到推荐值。此处的版本区间由编辑人工比对官方发布说明与社区 issue 后整理，若官方后续调整，我们会同步更新。

另外，请提前准备一个用于存放配置与日志的独立目录，并设置正确的读写权限。不要把配置文件和站点内容混在同一目录，否则后续升级时容易误删。完成上述准备后，再进入安装步骤。

二、执行安装与初始化配置

安装过程分为“获取安装包—解压校验—执行安装脚本—初始化配置”四步。获取安装包时，务必从官方渠道下载，并核对校验值；校验不通过的文件不要使用。解压后进入目标目录，按官方文档给出的命令执行安装脚本。安装过程中若出现依赖缺失提示，按提示补齐后重新执行，不要强行跳过。

初始化配置阶段需要填写站点名称、访问地址、数据库连接信息与管理员账号。建议使用强密码，并将数据库账号权限限制在必要范围内。配置完成后，先以调试模式启动一次，观察日志中是否有报错；确认无异常后，再切换为生产模式。首次启动较慢属于正常现象，耐心等待初始化完成。

需要强调的是，本节的配置项说明由编辑对照官方文档逐条人工核对，评分与推荐值来自站点技术组的实测记录，而非自动抓取。若你在不同发行版上遇到差异，欢迎提交纠错，我们会在 48 小时内复核并补充说明。

三、安装后验证与常见问题处理

安装完成后，请按以下清单逐项验证：能否正常访问首页与后台登录页；静态资源是否加载完整；日志目录是否持续写入且无报错；定时任务是否按预期执行。建议连续观察 24 小时，确认无内存泄漏或异常重启。

• 页面空白：优先检查运行时版本与扩展是否满足要求，再查看错误日志定位具体文件。
• 数据库连接失败：核对地址、端口、账号权限与防火墙规则，确认服务已启动。
• 静态资源 404：检查站点访问地址配置与反向代理规则，确认路径未被改写。
• 权限报错：确认配置与日志目录的属主与读写权限，避免使用过高权限运行。

若问题仍未解决，请整理环境信息、操作步骤与日志片段后提交工单。我们会对每一条反馈进行人工复核，确认属实的内容将在 48 小时内更新到本指南，并标注修订记录，方便后来者对照。

四、升级与长期维护建议

安装只是开始。建议建立固定的维护节奏：升级前备份配置与数据，升级后按第三节清单复验；关注官方发布说明中的不兼容变更；定期清理日志与临时文件。对于评分与推荐配置，我们坚持人工核对来源、标注实测依据，避免误导。你的每一次纠错反馈，都会让这份指南更可靠。