如何让WordPress站点从GCS Bucket而非VPS托管wp-content/uploads文件夹？

核心思路 #

既然已将wp-content/uploads完整上传至GCS Bucket，只需通过配置让WordPress将所有媒体请求指向GCS，同时确保Bucket权限正确，即可实现全量媒体从GCS提供服务。

1. 修改WordPress媒体URL指向GCS #

方法一：通过wp-config.php全局配置

在网站根目录的wp-config.php文件末尾添加以下代码（替换your-bucket-name为你的Bucket名称）：

// 定义上传目录指向GCS Bucket
define('UPLOADS', 'gs://your-bucket-name/uploads');
// 设置WP内容的基础URL为GCS Bucket的公开访问地址
define('WP_CONTENT_URL', 'https://storage.googleapis.com/your-bucket-name');
// 明确上传目录的URL路径
define('UPLOADS_URL_PATH', WP_CONTENT_URL . '/uploads');

方法二：通过钩子动态替换媒体URL

若不想修改wp-config.php，可在当前主题的functions.php中添加过滤钩子，自动替换所有附件的URL：

add_filter('wp_get_attachment_url', 'redirect_media_to_gcs');
function redirect_media_to_gcs($original_url) {
    // 获取本地上传目录的URL
    $local_upload_base = wp_upload_dir()['baseurl'];
    // 替换为GCS Bucket的上传目录URL
    $gcs_upload_base = 'https://storage.googleapis.com/your-bucket-name/uploads';
    return str_replace($local_upload_base, $gcs_upload_base, $original_url);
}

2. 配置GCS Bucket的公开访问权限 #

确保Bucket内的uploads文件夹及所有文件可公开访问，否则用户打开媒体会出现403错误：

• 进入GCS控制台，找到目标Bucket
• 进入「权限」页面，点击「添加权限」
• 成员填写allUsers，角色选择「Storage Object Viewer」，保存设置

3. 批量更新数据库中的旧媒体路径（可选但推荐） #

旧媒体的元数据仍存储本地路径，可通过SQL语句批量更新（先备份数据库！）：

-- 替换wp_为你的数据库前缀
UPDATE wp_postmeta
SET meta_value = REPLACE(meta_value, '/wp-content/uploads/', 'https://storage.googleapis.com/your-bucket-name/uploads/')
WHERE meta_key IN ('_wp_attached_file', '_wp_attachment_metadata');

4. 验证与清理 #

• 访问网站内的旧PDF、图片链接，确认是否正常加载GCS上的资源
• 确认所有媒体均可正常访问后，删除VPS上的wp-content/uploads文件夹，释放存储空间

注意事项 #

• 如果网站启用了CDN，需刷新CDN缓存，确保新URL生效
• 若出现跨域问题，需在GCS Bucket的「权限」-「CORS」中配置允许网站域名访问的规则

内容的提问来源于stack exchange，提问作者Fahim Siddiq