简介：

这是一个功能强大的抖音主页内容自动监控系统，旨在帮助用户实时掌握指定抖音账号的内容更新动态，并通过自动化手段进行下载、管理和通知，适用于内容创作者、营销人员及数据分析从业者。

核心特性

• 智能解析引擎：自动探测并解析抖音主页的视频与图片链接，支持多种链接格式。
• 即时邮件通知：集成 SMTP 服务，可根据多种触发条件（如新内容发布、解析错误等）发送邮件警报。
• 全自动下载：一旦发现目标账号有新内容发布，系统将自动下载并保存至本地指定目录。
• 实时状态监控：直观展示系统运行状态、任务执行历史及解析记录，便于用户快速掌握全局。
• 计划性自动更新：基于 Cron 等计划任务，可自定义监控频率，实现无人值守的持续内容追踪。

用户体验

• 响应式界面设计：完美适配桌面与移动设备，在任何屏幕尺寸下都能提供出色的操作体验。
• 精美邮件模板：采用专业 SVG 图标和现代化设计语言，使通知邮件既美观又易于阅读。
• 高度灵活配置：允许用户自定义监控间隔、文件命名规则等关键参数，以适应多样化的使用场景。
• 在线文件预览：支持直接在系统内预览已下载的视频和图片文件，提升内容管理效率。

技术特性

• 可靠数据库存储：采用 MySQL 数据库持久化存储解析记录、配置信息和更新日志，确保数据安全。
• 多重邮件保障：集成 PHPMailer 库，并提供备用邮件发送方案，增强邮件通知的稳定性。
• 健壮的错误处理：完善的异常捕获机制和详细的日志记录系统，便于快速定位和解决问题。
• 全方位安全防护：包含文件路径安全检查、输入验证等措施，有效抵御潜在的安全风险。

系统架构

核心文件说明

文件	功能描述
index.html	系统主界面，提供用户操作和数据展示的交互窗口。
Douyin.php	抖音链接解析核心类，封装了所有与抖音数据交互的逻辑。
auto_update.php	自动更新管理接口，处理单次内容更新检查任务。
cron_auto_update.php	计划任务执行脚本，供服务器 Cron 调用以实现周期性监控。
file_manager.php	文件管理模块，负责已下载文件的预览、删除等操作。
manage_records.php	解析记录管理界面，允许用户查看和管理历史解析任务。
file_preview.php	文件在线预览功能实现页面。
config.php	系统核心配置文件，包含数据库连接信息等敏感设置。

数据库结构

• 解析记录表 (parse_records): 存储所有已解析的抖音内容信息及其状态。
• 自动更新日志表 (auto_update_logs): 记录每次自动更新任务的执行结果和详细信息。
• 邮件配置表 (email_configs): 保存用于发送通知的 SMTP 服务器配置。

环境要求

• PHP: 7.4 或更高版本
• MySQL: 5.7 或更高版本
• 扩展: 已安装并启用 cURL 扩展
• 邮件服务: 可访问的 SMTP 服务器（用于发送邮件通知，可选）

快速开始

环境部署

1. 导入数据库:bash运行mysql -u username -p < database.sql
2. 配置数据库连接:编辑 config.php 文件，找到 Database 类并更新数据库连接信息：php运行class Database { private $host = 'localhost'; private $db_name = 'douyin_parser'; private $username = 'your_username'; // 你的数据库用户名 private $password = 'your_password'; // 你的数据库密码 // ... }
3. 目录权限设置:bash运行chmod 755 downloads/ chmod 755 logs/
4. 计划任务配置（自动更新）:
   • 任务类型: Shell 脚本
   • 执行周期: 推荐每 30 分钟执行一次
   • 脚本内容:bash运行cd /你的项目路径/ /usr/bin/php cron_auto_update.php

功能详解

链接解析功能

支持解析多种抖音链接格式，确保最大兼容性：

• 抖音短链接 (e.g., https://v.douyin.com/xxxx/)
• 用户主页链接 (e.g., https://www.douyin.com/user/MS4wLjABAAAA...)
• 其他官方认可的抖音链接格式

系统会自动识别链接类型并提取关键信息。

邮件通知配置

• SMTP 配置: 支持 SSL/TLS 加密连接，兼容主流邮件服务商（如 QQ 邮箱、163 邮箱、Gmail 等）。
• 通知触发条件:
  • 成功发现并下载新内容时
  • 解析过程中发生错误时
  • 系统运行出现异常时

文件管理

• 在线预览: 直接在浏览器中查看已保存的视频和图片，无需下载到本地。
• 批量操作: 支持一次性删除多个选中的文件，提升管理效率。
• 自动清理: 可设置自动清理规则，按文件保存时间（1 小时～30 天）自动删除旧文件。
• 安全下载: 提供安全的文件下载链接，防止未授权访问。

自动更新系统

• 智能检测: 系统会智能对比新内容与历史记录，只有在发现真正的新内容或内容有变化时才执行下载和更新操作。
• 频率控制: 用户可在界面上自由配置监控检查的频率，以平衡实时性和服务器资源消耗。
• 错误重试: 对于因网络波动等临时问题导致的失败任务，系统具备完善的错误重试机制。
• 状态监控: 在主界面实时显示最后一次自动更新的状态、时间和结果日志。

使用指南

基本操作流程

1. 输入抖音链接:在系统主界面的输入框中，粘贴有效的抖音主页链接。系统支持自动识别剪贴板内容，方便快速操作。
2. 配置解析参数:
   • 选择需要解析的内容类型（视频 / 图片）。
   • （可选）设置自定义的文件命名规则。
   • （可选）配置是否启用自动更新监控。
3. 获取并查看结果:点击开始按钮后，系统将立即执行解析任务，并在页面上展示解析到的视频 / 图片数量及相关信息。用户可在此进行下载或复制文件链接等操作。
4. 管理解析记录:通过 “解析记录” 管理页面，用户可以查看所有历史解析任务，并对特定任务进行再次解析、查看详情或删除等操作。

高级功能使用

自动更新管理

1. 在执行首次解析时，勾选 “启用自动更新” 选项。
2. 系统将通过已配置的计划任务，周期性地自动检查该抖音主页的内容变化。
3. 一旦发现新内容，系统会自动下载文件并根据配置发送邮件通知。

邮件配置

1. 进入系统设置页面，找到邮件配置 section。
2. 填写 SMTP 服务器信息（例如 smtp.qq.com）、端口（例如 465 用于 SSL）、加密方式（SSL/TLS）。
3. 输入发件人邮箱地址、用户名和授权码（请注意：部分邮箱服务商需要使用独立的授权码而非登录密码）。
4. 填写发件人名称（例如 “抖音监控系统”）。
5. 保存配置并进行发送测试，以确保邮件服务工作正常。

文件清理策略

1. 进入系统设置页面，找到文件清理 section。
2. 选择自动清理的时间阈值（例如，清理超过 7 天的文件）。
3. 启用自动清理功能。系统将在每次执行自动更新任务时，检查并删除符合清理条件的旧文件。
4. 用户也可以随时在文件管理页面，使用 “手动清理” 功能立即执行清理操作。所有清理操作都会被记录在日志中。

故障排除

常见问题

• Q: 解析失败怎么办？
  • A: 请尝试更换其他抖音主页链接进行测试，某些链接可能因平台限制或隐私设置而无法解析。同时，请检查服务器网络是否能正常访问抖音官网，并查看 logs 目录下的错误日志以获取详细信息。
• Q: 自动更新功能不工作？
  • A: 首先，请检查服务器的计划任务（Cron Job）是否已正确配置，并且 PHP 的路径是否正确。其次，查看 logs/cron_auto_update.log 文件，检查是否有任何错误信息。最后，确认在解析记录中，目标任务的 “自动更新” 选项已被正确启用。
• Q: 邮件发送失败？
  • A: 请仔细核对 SMTP 配置信息，特别是 SMTP 服务器地址、端口、加密方式以及发件人邮箱的授权码。建议先使用系统提供的 “发送测试邮件” 功能进行诊断。同时，检查服务器的防火墙策略，确保出站 SMTP 端口（如 25, 465, 587）未被封禁。详细的错误信息会记录在系统日志中。
• Q: 提示数据库连接错误？
  • A: 请检查 config.php 文件中的数据库配置项（主机、数据库名、用户名、密码）是否与实际的 MySQL 服务器设置一致。同时，确认 MySQL 服务是否正常运行，并且该数据库用户拥有足够的权限（如 SELECT, INSERT, UPDATE, DELETE）。

日志查看

系统运行日志是排查问题的重要工具，所有日志文件均保存在 logs/ 目录下：

• cron_auto_update.log: 记录了每次计划任务执行的详细过程、结果和任何可能发生的错误。
• php_error.log: 记录了 PHP 脚本在运行过程中产生的警告和致命错误。
• mail.log: (若启用) 记录了所有邮件发送的尝试及其结果。