WP AI1 OSS Auto Backup

将 All-in-One WP Migration（及 Pro）生成的 .wpress 备份，自动上传到独立的阿里云 OSS 私有 Bucket。支持定时调度、保留策略、上传日志、从 OSS 拉取回本地、远端存在性校验。

基本信息

• 作者：biancaplus
• 当前版本：1.0.1
• WordPress：5.8+
• PHP：7.4+
• 许可证：GPL-2.0-or-later
• 后台入口：设置 → AI1 OSS 自动备份（仅管理员）

功能概览

依赖

1. All-in-One WP Migration（或 Pro）：负责导出 .wpress
2. 阿里云 OSS SDK：默认复用已安装的 oss-aliyun 插件中的 SDK（wp-content/plugins/oss-aliyun/sdk/vendor）。若站点没有该插件，需自行保证 \OSS\OssClient 可加载。

安装

1. 将 wp-ai1-oss-auto-backup 目录上传至 /wp-content/plugins/。
2. 在 WordPress 后台的「插件」页面启用 WP AI1 OSS Auto Backup。
3. 进入 设置 → AI1 OSS 自动备份。

使用方法

1. 配置 OSS

在设置页填写：

• AccessKey ID / Secret
• Endpoint（如 oss-cn-hangzhou.aliyuncs.com，一般不带协议）
• 备份专用 Bucket
• Object 路径前缀（可留空；留空则对象落在桶根）
• 若 ECS 与 OSS 同地域，可勾选内网 Endpoint

点击「测试 OSS 连接」确认可用后保存。

2. 配置调度与保留

• 调度模式：每天 / 每周 / 每月，并设置执行时刻
• 建议将本工具时刻设在 All-in-One 导出完成之后（例如 AI1WM 周六 03:00，本工具 04:00）
• 单次 Job 上限：控制每轮上传个数，避免一次拖垮 PHP
• OSS 滚动保留数：按一份 .wpress（一条成功上传日志）计，兼作总地板
• 可选：上传成功后删本地、清理 OSS/本地超额、启用月度锚点（按文件名日期每月留最后一个包）

3. 生产环境 Cron（强烈建议）

WP-Cron 依赖访问才能触发。生产环境请用系统 Cron 定期唤醒，例如每 5 分钟：

*/5 * * * * curl -fsS -o /dev/null "https://你的站点/wp-cron.php?doing_wp_cron"

若已设置 DISABLE_WP_CRON，则必须配置系统 Cron，否则定时上传不会执行。

4. 手动操作

• 立即执行上传：上传当前待传完整包（受单次上限约束）
• 刷新状态 / 清除任务锁：排查卡住的任务
• 日志：复制 OSS Key、拉取到本地、删除本地 .wpress、重新上传
• 校验远端对象：对成功日志做存在性检查并打标
• OSS 对象列表：列举前缀内 .wpress；可拉取、删除本地或删除 OSS

5. 与 All-in-One 联调

1. 用 AI1WM 导出一份备份
2. 确认文件出现在备份目录且已写完
3. 在本插件点「立即执行上传」或等待调度
4. 在 AI1WM「备份」页与本插件 OSS 列表对照；需要时可从 OSS「拉取到本地」后再用 AI1WM 还原

数据与权限

停用插件会清除 WP-Cron 钩子，但保留设置与日志表。卸载插件默认仍保留设置与日志表，仅清除任务锁；可按需手工清理数据库。

安全提示

• AccessKey 仅管理员可见；页面与成功 JSON 不回传 Secret 明文
• 拉取 / 删除受 Object 前缀与 .wpress 后缀约束
• OSS 清理采用「仅删本工具成功日志对应对象」策略，避免空前缀误扫桶

更新日志

1.0.1

• 月度锚点改为按备份文件名 YYYYMMDD 定月，每月保留该月最后一个包（不再按上传完成时间）。
• 开启月度保留或上传成功后会重算锚点，便于补传历史包后正确挂上 6 月 / 7 月等锚点。

1.0.0

• 首次通用版发布。
• All-in-One .wpress 自动上传 OSS、调度、保留、日志、拉取与远端校验。