WordPress如何使用腾讯云COS

Wed, 03 May 2017 00:00:00 +0000

COS 是腾讯云的对象存储服务，免费 50G 存储空间，按外网流量收费，内网调用免流量。本文介绍如何让 WordPress 使用 COS 存储图片并享受内网流量。

一、COS 开通与配置

1. 开通对象存储服务

登录腾讯云控制台，按照提示开通 COS 服务。

2. 创建 Bucket

⚠️ 重要：Bucket 所属地域必须与 ECS 服务器一致，否则无法享受内网流量！

在 COS 控制台创建存储桶：

选择与 ECS 相同地域（如广州、上海等）
设置访问权限（建议私有读写）
记录 Bucket 名称和地域

3. 获取密钥

在访问密钥管理页面获取：

SecretId
SecretKey

二、安装 COS 插件

本文采用 cos-sync 插件，上传图片时自动同步到 COS。

安装步骤

下载插件并解压
上传到 WordPress 插件目录
在 WordPress 后台启用插件
配置插件参数（SecretId、SecretKey、Bucket、地域等）

插件配置

// 插件配置参数示例
cos_options = [
 'secretId' => '你的SecretId',
 'secretKey' => '你的SecretKey',
 'bucket' => 'your-bucket-1250000000',
 'regional' => 'ap-guangzhou', // 地域代码
 'domain' => 'https://your-bucket.cos.ap-guangzhou.myqcloud.com'
];

三、享受 COS 内网流量

方法 A：自建代理服务

在服务器上实现一个读取 COS 图片的服务：

<?php
// proxy.php - COS 代理服务
if (empty($_GET["file"])) {
 die('no access');
}

require_once __DIR__ . '/../../../wp-blog-header.php';
require_once 'vendor/autoload.php';

use Qcloud\Cos\Client;
use Qcloud\Cos\Exception\ServiceResponseException;

$cos_options = get_option('cos_options', true);
$secretId = $cos_options['secretId'];
$secretKey = $cos_options['secretKey'];
$bucket = $cos_options['bucket'];
$region = $cos_options['regional'];

$client = new Client([
 'region' => $region,
 'credentials' => [
 'secretId' => $secretId,
 'secretKey' => $secretKey,
 ],
]);

$file = $_GET["file"];

try {
 $result = $client->getObject([
 'Bucket' => $bucket,
 'Key' => ltrim($file, '/'),
 ]);
 
 // 设置 Content-Type
 $contentType = $result['ContentType'] ?? 'application/octet-stream';
 header('Content-Type: ' . $contentType);
 echo $result['Body'];
} catch (ServiceResponseException $e) {
 http_response_code(404);
 die('File not found');
}

评价：

✅ 实现灵活，可自定义缓存、压缩等
❌ 需要处理 COS 的 keep-alive 问题
❌ 需要设置合理的超时时间

方法 B：Nginx 反向代理（推荐）

使用 Nginx 代理 COS 请求，实现内网访问：

server {
 listen 80;
 server_name your-blog.com;
 
 # WordPress 其他请求
 location / {
 try_files $uri $uri/ /index.php?$query_string;
 }
 
 # COS 图片代理
 location ^~ /cos/ {
 # 去掉 /cos/ 前缀，重写为实际 COS 路径
 rewrite ^/cos/(.*) /$1 break;
 
 # 代理到 COS
 proxy_pass https://your-bucket.cos.ap-guangzhou.myqcloud.com/;
 
 # 代理配置
 proxy_set_header Host $host;
 proxy_set_header X-Real-IP $remote_addr;
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 
 # 超时设置
 proxy_connect_timeout 60s;
 proxy_read_timeout 60s;
 proxy_send_timeout 60s;
 
 # 缓存设置
 proxy_cache cache;
 proxy_cache_valid 200 7d;
 add_header X-Cache-Status $upstream_cache_status;
 }
 
 location ~ \.php$ {
 fastcgi_pass unix:/run/php/php-fpm.sock;
 fastcgi_index index.php;
 include fastcgi_params;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 }
}

访问方式：http://your-blog.com/cos/uploads/2023/01/image.jpg

评价：

✅ 实现简单，配置灵活
✅ 响应及时，支持缓存
✅ 可复用 Nginx 的各种优化

四、插件优化配置

问题 A：媒体库缩略图显示异常

现象：不勾选"本地保存"后，媒体库缩略图显示不正确

原因：服务器不存储图片，无法获取尺寸，默认宽高为 1px

解决：修改 WordPress 核心文件最小尺寸

// wp-includes/media.php，约 444 行
// 将 $w 和 $h 的最小值改为 150
$w = max(150, (int) round($current_width * $ratio));
$h = max(150, (int) round($current_height * $ratio));

// wp-admin/includes/image-edit.php，约 606 行
$w2 = max(150, $w * $ratio);
$h2 = max(150, $h * $ratio);

问题 B：预览看不到图片

解决：修改媒体模板文件

// wp-includes/media-template.php，约 680 行和 931 行
// 在 else 分支中设置 size 为 full
<# } else { #>
 <label class="setting">
 <input type="hidden" name="size" value="full" />
 </label>
<# } #>

五、完整配置示例

docker-compose.yml

version: '3.8'

services:
 wordpress:
 image: wordpress:latest
 ports:
 - "8080:80"
 volumes:
 - ./wp-content:/var/www/html/wp-content
 environment:
 - WORDPRESS_DB_HOST=db
 - WORDPRESS_DB_NAME=wordpress
 - WORDPRESS_DB_USER=wp_user
 - WORDPRESS_DB_PASSWORD=wp_password

 db:
 image: mysql:8.0
 environment:
 - MYSQL_ROOT_PASSWORD=root_password
 - MYSQL_DATABASE=wordpress
 - MYSQL_USER=wp_user
 - MYSQL_PASSWORD=wp_password
 volumes:
 - db_data:/var/lib/mysql

volumes:
 db_data:

Nginx 配置（生产环境）

upstream wordpress {
 server 127.0.0.1:8080;
}

server {
 listen 443 ssl http2;
 server_name your-blog.com;
 
 ssl_certificate /etc/ssl/certs/your-blog.crt;
 ssl_certificate_key /etc/ssl/private/your-blog.key;
 
 root /var/www/html;
 index index.php index.html;
 
 # COS 代理
 location ^~ /cos/ {
 rewrite ^/cos/(.*) /$1 break;
 proxy_pass https://your-bucket.cos.ap-guangzhou.myqcloud.com/;
 proxy_cache_valid 200 30d;
 expires 30d;
 }
 
 # WordPress
 location / {
 proxy_pass http://wordpress;
 proxy_set_header Host $host;
 proxy_set_header X-Real-IP $remote_addr;
 }
 
 location ~ \.php$ {
 proxy_pass http://wordpress;
 fastcgi_pass unix:/run/php/php-fpm.sock;
 include fastcgi_params;
 }
}

六、常见问题

Q: Bucket 地域选错了怎么办？

A: 可以删除重建，或在插件中手动指定地域参数。

Q: 内网流量仍然收费？

A: 检查 ECS 和 COS 是否同地域，确保使用内网域名访问。

Q: 图片加载很慢？

A: 建议开启 CDN 加速，配合 Nginx 缓存优化。

七、费用说明

项目	说明
存储空间	免费 50GB
内网流量	免费
外网下行流量	按量计费
请求次数	按量计费

💡 建议：将 ECS 和 COS 放在同一地域，使用 内网 Endpoint（内网域名） 访问存储与回源，可省去外网下行流量费用并降低访问延迟。若站点必须对公网用户分发图片，可在 COS 或 CDN 侧单独配置外网访问与缓存策略，按业务场景权衡成本与性能。

八、小结

按本文完成 COS 对接与域名配置后，媒体资源可走对象存储承载流量，ECS 专注计算；后续若有访问热点，再结合 CDN 与缓存策略进一步优化即可。

COS on Yison's Blog