第14章 腾讯云 COS 集成指南
Tencent Cloud COS 使用腾讯云 COS 存储桶来存储文件。
配置 CORS 策略 在使用 Cloudreve 的 Web 客户端上传或浏览文件之前，存储桶必须已配置 CORS 策略。通常，在添加存储策略时，你可以让 Cloudreve 自动配置 CORS 策略。如果需要手动配置，请在“安全管理” -> “跨域访问 CORS” 中添加该策略。
使用自定义域名 Endpoint 如果仅在文件下载链接中使用自定义域名（例如 CDN），你可以配置“下载 CDN”。配置完成后，文件下载链接中的主机名和路径将替换为你提供的 CDN URL，但文件上传和管理请求仍会使用 COS 提供的官方 Endpoint。本节将说明如何为所有请求配置自定义 Endpoint。
准备自定义域名 请将你的自定义域名通过 CNAME 解析或反向代理指向带有 Bucket 名称前缀的 Endpoint，并在 COS 存储桶配置的“域名管理”中添加并验证该域名。
如果不想在 COS 存储桶配置中添加自定义域名，你仍可继续，但该域名必须通过反向代理访问 Endpoint；直接 CNAME 解析不起作用。配置反向代理时，请重写请求的 Host 头为带有 Bucket 名称的官方 Endpoint，否则 OSS 无法识别你的 Bucket。参考配置方法如下：
nginxlocation / {
proxy_pass https://
启用自定义 Endpoint 在“基本信息” -> “Endpoint”下的存储策略配置中填写你的自定义域名。
FAQ 上传错误：Request failed: AxiosError: Network Error xxx 检查存储策略的 Endpoint 设置是否正确： 确保该 Endpoint 在用户端可访问； 如果站点启用了 HTTPS，确保填写的 Endpoint 也以 HTTPS 开头且拥有有效的 SSL 证书； 检查 CORS 策略是否已设置且配置正确；
传输上传失败，信息：Unable to parse response 展开详细错误信息，检查错误消息中是否包含 413 Request Entity Too Large。 如果有，请修改 Nginx 反向代理配置以设置或增加 client_max_body_size 的值，例如 client_max_body_size 20000m;。此设置值应大于上传文件的大小。 检查外部 WAF 防火墙是否拦截了上传请求。
上传错误：Unable to complete file upload: One or more of the specified parts could not be found xxx 该错误的根本原因是 Cloudreve 客户端无法读取分块上传请求返回的 Etag 头。 如果你的 Endpoint 使用自己的反向代理服务器，检查反向代理过程中是否过滤掉了 Etag 头。 某些用户端防火墙（如 TPLink）会过滤 Etag 头，请检查防火墙配置。
启用自定义下载 CDN 域名后，文件下载报错 InvalidAccessKeyId？ 在为 COS 存储桶添加自定义 CDN 加速域名时，检查是否启用了回源鉴权： 如果已启用，使用 CDN 时文件下载请求无需签名，请在 Cloudreve 存储策略设置中启用“下载” -> “下载 CDN” -> “跳过 CDN URL 签名”； 如果未启用，请检查你的 CDN CNAME 是否正确配置，以及存储策略凭证是否正确填写；
图片可以查看和下载，但使用 Photopea 打开时始终处于加载状态 检查存储桶的 referer 策略，允许 Referer 为 https://photopea.com 的请求。
