置顶
置顶
BUG反馈
14 个 Q&A，分安装阶段、运行阶段、后台三类
九、常见问题排查9.1 安装阶段问题Q1：访问 install.php 显示 404 或空白页最常见的 3 个原因（按概率排序）：PHP 版本不是 8.1 → 宝塔 → 网站 → 你的域名 → PHP 版本 → 选 PHP-81 → 保存域名解析未生效 → 用 ping 你的域名 确认 IP 是否正
项目简介、功能概览 — 入门导读
一、项目简介时光邮局是一个可以独立部署在你自己服务器上的信件投递平台。用户在线撰写信件，设定未来某个日期，系统会在指定时间自动将信件以邮件形式发送到收件人邮箱。核心场景：给一年后的自己写一封信给朋友/家人在特殊日期发送祝福建立公开信件墙，分享故事与感悟作为企业/社区的纪念日营销工具架构说明： 本项目
技术栈、运行环境、服务器配置参考
三、技术栈与运行环境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 搜索筛选：按状态（正常/禁用/封禁）、角