从安装到日常管理，按步骤完成。

1. 宝塔安装

准备一个已解析到服务器的域名和空网站目录。无需创建 MySQL 数据库，也不需要安装码。

1. 宝塔 → 网站 → 添加站点：填写域名，PHP 选择 8.0 或以上，数据库选择“不创建”。
2. 下载本页的完整安装包，上传到网站根目录并解压。解压后应直接看到 app、public 和 bootstrap.php，不要多套一层文件夹。
3. 网站 → 设置 → 网站目录：网站目录保持解压目录，运行目录选择 /public，保存。为域名配置 HTTPS。

打开网页完成安装

1. 访问网站域名；若未自动进入安装页，打开 https://你的域名/install.php。
2. 查看环境检查结果。缺少扩展或目录不可写时，按提示修复，重新检查通过后继续。
3. 填写管理员账号和密码，点击“开始安装”，等待页面显示安装完成。
4. 访问 https://你的域名/adminx/，使用刚设置的账号和密码登录。

完成标准：安装页显示完成，后台可以正常登录。

2. 首次设置

1. 确认使用安装时自己设置的管理员密码。后续修改密码进入“账号与安全”，新版没有统一公开默认密码。
2. 进入“站点设置”→“网站信息”，填写网站名称、关键词和描述，保存设置。
3. 在“Logo 与联系”中选择文件上传 Logo，填写联系邮箱。
4. 在“展示模板”中分别选择电脑模板和手机模板，保存后打开前台查看效果。
5. 确认宝塔中的域名绑定、解析和 HTTPS 正常。添加其他独立站点时，在“站群管理”中配置对应域名和网站信息。

完成标准：电脑与手机访问正确域名，网站名称、Logo 和模板符合设置。

3. 执行器配置

执行器负责数据下载、模板安装、程序更新等后台任务。网页能打开，不代表任务会自动执行。

1. 进入“运行与配置管理”→“执行器状态”，复制页面生成的执行命令。命令包含本站实际 PHP 和文件路径。
2. 打开宝塔 → 计划任务，添加 Shell 脚本任务，名称可填写“玉兔 CMS 执行器”，粘贴刚复制的命令。
3. 面板支持秒级调度时，执行周期设置为每 10 秒，保存并启用任务。
4. 手动执行一次，查看计划任务日志，再回后台检查执行器最近执行时间。
5. 等待几个执行周期并刷新状态，确认时间持续更新，而不是只成功执行一次。

命令怎么用？

直接复制自己后台生成的命令，不必手动拼接路径。该命令执行一轮后退出，需要调度器持续调用；不要重复创建多个相同计划任务。

完成标准：执行器最近执行时间持续更新，提交的后台任务能开始处理。

4. 数据更新

手动获取数据

1. 进入“数据与备份”→“数据更新”，点击“下载并更新数据”。
2. 打开“任务进度与历史”，查看任务是排队中、执行中、已完成还是失败。
3. 点击“详情”查看进度和结果。任务完成后，检查前台首页、分类、搜索和播放页面。

开启自动更新

1. 在数据更新页面点击“自动更新数据”，开启自动更新。
2. 设置每天执行时间并保存。时间使用北京时间，默认值是 23:57，可自行修改。
3. 保持执行器正常运行，在计划时间后到任务历史和通知中心查看结果。

默认不会自动采集，需主动开启。实际开始时间取决于执行器调度和任务排队；停机错过后，恢复运行时补交一次，已有更新任务时不会重复创建。

完成标准：任务显示已完成，前台能看到数据，自动更新时间与预期一致。

5. 模板中心与版本更新

安装或更新模板

1. 登录自己的网站后台，打开“模板中心”，选择模板并按页面提示安装或更新。
2. 到任务进度中确认安装成功，再进入“站点设置”→“展示模板”选择电脑端和手机端模板。
3. 查看电脑与手机的首页、分类页和播放页。预览效果与实际站点有差异时，以实际站点检查结果为准。

更新程序

1. 确认执行器正常，并保留当前网站备份。
2. 进入“版本更新”，点击“检查更新”，阅读版本说明后按提示提交更新。
3. 到任务历史查看结果。完成后刷新后台，核对版本和主要页面。

本页提供 2.16.43 完整安装包，已包含当前已发布的程序更新。新网站直接安装即可；后续版本在后台“版本更新”中检查。

6. 常用功能

广告管理

选择对应广告位置，填写图片与跳转地址或该位置支持的广告代码，保存后检查电脑端和手机端。使用广告排期时，同时确认启用状态与投放时间。

友情链接

填写链接标题和完整网址，保存后检查前台展示与跳转。批量导入时按页面示例准备内容，先核对确认列表再导入；可使用友链检测查看可访问状态。

站群管理

添加站点时填写域名、标题、关键词和描述，可上传独立 Logo、选择模板。对应域名还要解析到服务器并在宝塔绑定到该程序网站；使用 HTTPS 时证书也需覆盖该域名。保存后逐个域名检查站点信息是否匹配。

访问验证

进入“站点设置”→“访问验证”开启或关闭。开启后，用无痕窗口测试从首页进入、完成验证和访问内容页的流程。访问验证可能影响搜索引擎抓取，请按需要启用。

伪静态

全新安装默认关闭。需要开启时，先在宝塔 → 对应网站 → 设置 → 伪静态中保存以下 Nginx 规则：

location / {
    try_files $uri $uri/ /index.php$is_args$args;
}

随后打开程序“站点设置”→“伪静态设置”的开关。检查首页、分类、详情、播放、搜索和分页；如出现 404，先关闭程序开关恢复访问，再核对宝塔规则及 /public 运行目录。

日志管理

进入“运行与配置管理”→“日志管理”，设置记录保留期限并保存；执行器会定期检查清理。手动清理前确认范围，需要排查的问题处理完毕后再清理相关记录。

每次修改后保存设置，并到实际前台检查结果；涉及站群时，分别检查对应域名。

7. 常见问题