在 WordPress 插件中使用自有存储
WordPress + AWS S3
用于 WordPress 的 Alter Product 插件内置了 AWS S3 存储模块。您可以将插件支持的文件组保存在自己的私有存储桶中,在 WordPress 中连接存储桶,并使用插件工具迁移现有文件。
扩展此已连接存储的容量时,Alter Product 不收取额外的存储容量费用。AWS 会向您的账户收取存储、请求和数据传输费用。WordPress 托管费用以及常规套餐和嵌入会话规则仍然适用。
本说明遵循插件内的设置指南。AWS 控制台标签保留英文。
存储、文件交付与费用
S3 保存插件的文件对象。WordPress 仍负责检查访问权限并将文件交付给浏览器。
供插件使用的私有存储后端
浏览器不会直接从 S3 下载文件。WordPress 从私有存储桶获取并校验文件,再通过自身端点提供文件。请将 S3 CORS 留空,并启用 Block Public Access;这不是公开存储桶,也不是直连 CDN。
此模块仅覆盖受支持的 Alter Product 文件组。连接存储桶不会迁移 WordPress 中的所有文件,也不会更改嵌入工具的限额。

按实际使用的资源向 AWS 付费
增加已连接存储桶的容量不会产生额外的 Alter Product 费用。AWS 费用取决于使用量、区域和存储类别;请查看最新 S3 价目表,不要假定价格固定。
文件由 WordPress 提供,因此相关流量也可能计入托管服务的带宽用量。使用 S3 不意味着托管流量为零,也不意味着服务器吞吐量无限。
按支持的设置创建存储桶
以下字段名称与英文 AWS 控制台及插件内置设置指南保持一致。
创建通用存储桶
登录 AWS,打开 Amazon S3,选择 General purpose buckets → Create bucket。选择区域,并使用小写英文字母、数字和连字符命名,不要使用句点。复制存储桶的完整名称,包括 AWS 添加的任何后缀。
- 应用表格中的设置,然后选择 Create bucket。
- 记下存储桶完整名称、区域和存储桶所有者的 12 位 AWS 账户 ID。
- 将 Cross-origin resource sharing (CORS) 留空。S3 请求来自 WordPress 服务器。
| AWS 字段 | 设置 |
|---|---|
| Bucket type | General purpose |
| Bucket namespace | Account Regional namespace (推荐) |
| Object Ownership | ACLs disabled / Bucket owner enforced |
| Block Public Access | Block all public access (全部四项设置) |
| Bucket Versioning | Enable |
| Default encryption | Server-side encryption with Amazon S3 managed keys (SSE-S3 / AES256) |
| Bucket Key | Disable |
| Advanced settings → Object Lock | Disable |
强制使用 HTTPS
添加传输规则,而不公开存储桶或授予对象访问权限。
添加存储桶策略
打开 Permissions → Bucket policy → Edit。将两处 EXAMPLE-BUCKET 替换为存储桶完整名称。如果已有策略,请保留现有语句,并在检查整个文档后添加此规则。
- 检查编辑器提示,然后选择 Save changes。
- 确认规则已保存。保持 Block all public access 启用。
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "DenyInsecureTransport",
"Effect": "Deny",
"Principal": "*",
"Action": "s3:*",
"Resource": [
"arn:aws:s3:::EXAMPLE-BUCKET",
"arn:aws:s3:::EXAMPLE-BUCKET/*"
],
"Condition": {
"Bool": {
"aws:SecureTransport": "false",
"aws:PrincipalIsAWSService": "false"
}
}
}
]
}创建受限 IAM 访问权限
为此存储桶和前缀使用专用策略,不要使用 AdministratorAccess 或 AmazonS3FullAccess。
创建插件策略
在 IAM → Policies → Create policy → JSON 中粘贴以下文档。将每处 EXAMPLE-BUCKET 替换为完整存储桶名称。前缀 alter-product 必须与 WordPress 中的 Folder prefix 一致;如果选择其他前缀,请修改每个对象 Resource 中的前缀。
- 验证策略,选择 Next,并为其命名,例如 AlterProductS3Storage。
- 选择 Create policy,并记下名称以供用户设置时使用。
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ReadRequiredBucketControls",
"Effect": "Allow",
"Action": [
"s3:GetBucketVersioning",
"s3:GetBucketOwnershipControls",
"s3:GetBucketPublicAccessBlock",
"s3:GetEncryptionConfiguration"
],
"Resource": "arn:aws:s3:::EXAMPLE-BUCKET"
},
{
"Sid": "WriteAndReadVersionedPluginObjects",
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObjectVersion"
],
"Resource": [
"arn:aws:s3:::EXAMPLE-BUCKET/alter-product/objects/*",
"arn:aws:s3:::EXAMPLE-BUCKET/alter-product/.storage-tests/*"
]
},
{
"Sid": "RecoverJournalOwnedObjects",
"Effect": "Allow",
"Action": "s3:GetObject",
"Resource": "arn:aws:s3:::EXAMPLE-BUCKET/alter-product/objects/*"
},
{
"Sid": "DeleteOnlyConnectionTestVersions",
"Effect": "Allow",
"Action": "s3:DeleteObjectVersion",
"Resource": "arn:aws:s3:::EXAMPLE-BUCKET/alter-product/.storage-tests/*"
}
]
}创建专用用户和访问密钥
选择 IAM → Users → Create user。不要勾选 Provide user access to the AWS Management Console。
- 选择 Next → Attach policies directly,仅附加上述策略,然后完成 Create user。
- 打开该用户的 Security credentials → Access keys → Create access key。手动配置此插件时,选择 Other → Next,然后选择 Create access key。
- 将 Access key ID 和 Secret access key 保存在密码管理器中。私有访问密钥仅显示一次。请通过 HTTPS 直接将其输入 WordPress,不要通过消息或截图分享。
保存并测试 WordPress 连接
通过 HTTPS 打开商店后台,进入 Alter Product → Settings → Storage。选择 AWS S3 和 + / Add connection。
输入连接详情
选择 New connection。相同的内置说明也可在 AWS S3 setup guide 中查看。
- 选择 Save connection,等待确认。
- 选择 Test connection。再次测试前先保存修改。
- 在对话框和 Last connection test 列中检查结果。保存后密钥字段变空是预期行为。
| 字段 | 填写内容 |
|---|---|
| Bucket name | 存储桶完整名称,不是 ARN、s3:// URL 或 HTTPS 地址;不要包含句点。 |
| Folder prefix | alter-product,须与 IAM 策略一致。可使用字母、数字、连字符、下划线和分隔的文件夹;开头和结尾不要带斜杠。 |
| Bucket owner AWS account ID | 所有者的 12 位账户 ID,不含空格。 |
| AWS region | 存储桶的实际区域。表单默认值为 eu-central-1。 |
| AWS access key ID / AWS secret access key | 已保存的专用 IAM 用户密钥对。 |
| Use temporary AWS credentials | 使用此 IAM 用户的长期密钥时不要勾选。仅在使用临时凭证时启用,并提供 AWS session token。 |
连接测试失败时
核对存储桶名称、所有者、区域、必需设置,以及 WordPress 和 IAM 中的前缀是否完全一致。将 CORS 留空;不要关闭公开访问保护。
已保存的存储桶、前缀、所有者和区域共同确定连接身份。要使用其他目标,请选择 New connection。Edit → Reconnect 用于替换凭证,同时保留现有文件引用。
向支持人员提供测试结果,不要提供访问密钥。将此 S3 设为默认存储之前,连接测试必须成功。
选择默认存储并迁移现有文件
选择默认目标与迁移是两个独立操作。
将 S3 用于新文件组
在已保存连接的所在行选择 Make default。插件会测试连接,且仅在成功后更改默认存储。此设置适用于新文件组;现有组及后续修订在迁移前仍使用已记录的目标。
迁移受支持的现有文件组
首次迁移前,请一起备份数据库、WordPress 盐值和文件。先从测试环境或小型文件组开始。在目标 S3 所在行打开 Migrate;仅打开面板不会复制文件。
Auto migration 会处理当前不在所选目标中的受支持文件组。它不会自动迁移无关的 WordPress 文件。
- 选择 Start migration。插件会测试 S3,准备每个文件组,复制并校验后切换引用。
- 保持页面打开。Pause 会在当前组完成后停止;Resume migration 会从已保存的进度继续。如果关闭了页面,请重新打开以恢复后续步骤的执行。
- 若某组失败,请检查提示和 Advanced,排除原因后继续。不要盲目重复上传结果未知的操作。
- 显示 Migration completed 后,测试正常资源读取、编辑、预览和订单文件访问。扫描期间新建的组可能需要再次运行迁移。
移除行不会删除已存储文件
如有需要,请先切换默认存储。Remove 会将连接从列表中停用,但现有文件及其已保存凭证仍然可用。这不是 AWS 对象清理命令。
在 WordPress 节点间共享存储
共享 S3 目标可以降低对单个节点文件磁盘的依赖。但负载均衡器仍需要正确共享状态的 WordPress 部署。
多个节点的要求
对于负载均衡器后的一套 WordPress 安装,必须同时满足以下条件:
- 一个保持一致的 SQL 写入节点,以及共享的插件数据库状态。
- 共享 uploads 目录,用于仍保存在本地的文件及保留的迁移源文件。
- 所有节点使用相同的原始 WordPress 盐值,以便读取保存的凭证和加密文件。
- 每个节点有独立的私有临时目录,用于传输处理。
- 一致的插件配置,以及对同一私有 S3 存储桶和对象版本的访问权限。
- 使用标准 wpdb、原生 mysqli 和 InnoDB 表。不支持 HyperDB 等数据库路由替换组件;这里的负载均衡仅指 HTTP 层。
确保恢复和密钥轮换可用
请一并保留数据库、盐值及被引用的文件版本。
备份、重新连接并验证
使用 Edit → Reconnect 替换同一已保存连接的凭证。停用旧密钥之前,请测试当前及历史文件的读取,也要检查可能仍使用该密钥的其他已保存连接。
保持 S3 版本控制启用,并保留插件引用的版本。不要应用会删除所需历史版本的 lifecycle 清理规则。测试数据库、盐值和已保存文件的一同恢复。
临时凭证会过期,需要新的有效令牌和密钥;插件不会自动更新。随着商店发展,请监控 AWS 使用量及托管服务的数据传输量。