项目简介、功能概览 — 入门导读
一、项目简介时光邮局是一个可以独立部署在你自己服务器上的信件投递平台。用户在线撰写信件，设定未来某个日期，系统会在指定时间自动将信件以邮件形式发送到收件人邮箱。核心场景：给一年后的自己写一封信给朋友/家人在特殊日期发送祝福建立公开信件墙，分享故事与感悟作为企业/社区的纪念日营销工具架构说明： 本项目
技术栈、运行环境、服务器配置参考
三、技术栈与运行环境3.1 技术栈层级技术选型后端语言PHP 8.1+数据库MySQL 5.7+（InnoDB 引擎，utf8mb4 字符集）Web 服务器Nginx（推荐）或 Apache邮件库PHPMailer 6.6+（已内置）前端框架Bootstrap 5 + jQuery图表库Chart.
5 步安装流程（含 Mermaid 流程图）
五、安装步骤详解（共 5 步）以下步骤请严格按顺序操作，不要跳过任何一步。安装流程总览flowchart TD A[开始安装] --> B[第一步：宝塔创建网站站点] B --> C[第二步：安装 PHP 必需扩展] C --> D[第三步：上传项目文件]
SMTP、Cron、站点信息等必要配置
六、安装后必要配置6.1 配置邮件发送（SMTP）不配置此项，所有信件无法发送。登录后台 → 系统设置 → 邮件配置填写 SMTP 信息：以 QQ 邮箱 为例：字段填写内容SMTP 服务器smtp.qq.comSMTP 端口465加密方式SSL发件邮箱你的QQ号@qq.comSMTP 授权码16位授
管理后台各功能模块使用说明
七、管理后台使用指南7.1 访问后台http://你的域名/admin/使用安装时设置的管理员邮箱和密码登录。7.2 管理功能速览仪表盘（首页）查看核心运行数据：总用户数、总信件数、已发送/待发送数量、今日新增、发送成功率。用户管理搜索：按用户名、邮箱、ID 搜索筛选：按状态（正常/禁用/封禁）、角
定时任务工作机制、日志查看、手动测试
八、定时任务详解8.1 工作流程cron/run.php 每分钟执行一次，自动完成：发信：查询到期信件，逐封通过 SMTP 发送，失败自动重试（最多 3 次）系统自检：定时校验站点运行状态8.2 日志查看# 查看定时任务日志 tail -100 /www/wwwroot/你的域名/logs/cron
宝塔面板常用操作速查表
宝塔面板常用操作速查操作路径添加站点网站 → 添加站点修改 PHP 版本网站 → 域名 → 设置 → PHP 版本安装 PHP 扩展软件商店 → PHP-8.1 → 设置 → 安装扩展配置伪静态网站 → 域名 → 设置 → 伪静态添加 SSL网站 → 域名 → 设置 → SSL文件管理文件 → 进入