灵问

腾讯云 COS 跨域配置指南

为了让用户能够从浏览器直接上传文件到腾讯云 COS 存储桶，你需要在 COS 控制台配置跨域访问规则（CORS）。

重要提示

如果不配置 CORS，前端直传会被浏览器拦截，系统将自动降级为服务器中转上传（速度较慢且占用服务器带宽）。

1

登录腾讯云 COS 控制台

打开腾讯云对象存储控制台，找到你为灵问创建的存储桶。

前往 COS 控制台
2

进入跨域访问 CORS 设置

在存储桶详情页中，依次点击左侧菜单：

安全管理→跨域访问 CORS 设置

点击「添加规则」按钮。

3

填写 CORS 规则

按以下配置填写各项内容。请将 AllowedOrigins 替换为你的实际网站域名。

配置项填写内容
来源 Origin你的网站域名（如 https://lingwen.top）
操作 MethodsGET, POST, PUT, HEAD
Allow-Headers*
Expose-HeadersETag, Content-Length, x-cos-request-id
超时 Max-Age3600

如果你更习惯使用 JSON 配置，可以直接复制以下内容：

{
  "AllowedOrigins": [
    "https://lingwen-ai-bwwvzays.manus.space",
    "https://lingwen.top",
    "https://www.lingwen.top",
    "http://localhost:3000"
  ],
  "AllowedMethods": [
    "GET",
    "POST",
    "PUT",
    "HEAD"
  ],
  "AllowedHeaders": [
    "*"
  ],
  "ExposeHeaders": [
    "ETag",
    "Content-Length",
    "x-cos-request-id"
  ],
  "MaxAgeSeconds": 3600
}
4

保存并验证

点击「保存」后，CORS 规则会在几秒内生效。回到灵问工作台，尝试上传一个文件，如果上传进度条正常显示且没有报错，说明配置成功。

配置成功后，文件将直接从用户浏览器上传到腾讯云 COS，不再经过服务器中转，上传速度将大幅提升。

常见问题

配置后仍然无法上传？

请检查 Origin 是否包含了协议前缀（https://），且与浏览器地址栏中的域名完全一致。注意 www 和非 www 是不同的域名，需要分别添加。

需要添加多个域名怎么办？

在「来源 Origin」中可以添加多条规则，每行一个域名。建议同时添加生产域名和本地开发域名（http://localhost:3000）。

COS 未配置时会怎样？

系统会自动降级为服务器中转上传，功能不受影响，但上传速度会较慢且会占用服务器带宽。