简体中文

English

简体中文

English

主题

阿里云 OSS ​

使用 阿里云 OSS 存储桶存储文件。

配置 ​

地区代码 ​

创建 OSS 存储策略时，需要提供存储桶所在的地区代码。你可以在 OSS 地域和访问域名 的表格中找到对应地域，并填写对应的 地域 ID，比如 cn-hangzhou，注意不要包含 oss- 前缀。

你也可以根据 OSS 提供的存储桶 Endpoint 推测出地区代码，比如 oss-cn-beijing.aliyuncs.com 对应的地区代码为 cn-beijing。

跨域策略 ​

存储桶需要配置跨域策略后才能使用 Cloudreve 网页端上传或浏览文件。正常情况下，你可以在添加存储策略时让 Cloudreve 自动配置跨域策略。如果需要手动配置，请在 数据安全 -> 跨域设置 中添加。

cors

内网 Endpoint ​

如果你的 Cloudreve 部署在阿里云计算服务中，并且与 OSS 处在同一可用区下，你可以额外指定使用内网 EndPoint 以节省流量开支, Cloudreve 会在条件满足时切换到内网 EndPoint 发送请求。

internal-endpoint

为存储策略配置内网 Endpoint 时，下列场景会切换到内网 Endpoint：

  • 服务端转存上传文件；
  • 服务端中转上传（当存储策略开启 中转上传 时）；
  • 文件管理请求（删除、创建上传会话等）；
  • 服务端中转下载（当存储策略开启 下载中转 时）；
  • 其他需要服务端下载文件的请求；

当使用从机节点处理任务时，会强制使用非内网 Endpoint。

使用自定义域名 Endpoint ​

如果你只需要在文件下载 URL 中使用自定义域名（如 CDN），你可以在存储策略中配置 下载 CDN。配置后，文件下载 URL 中的域名和路径会被替换为你所填写的 CDN 地址，但是文件上传和管理请求仍然使用的是 OSS 官方提供的 Endpoint。本节会介绍如何在所有请求中都配置使用自定义 Endpoint。

准备自定义域名 ​

请将自定义域名 CNAME 解析或反向代理到带有 Bucket 名称前缀的 Bucket 域名，请在 OSS 存储桶配置的 Bucket 配置 -> 域名管理 中添加并验证此域名。

如果你不想在 OSS 存储桶配置中添加你的自定义域名，你仍然可以继续，但此域名必须反向代理 Bucket 域名，直接 CNAME 解析无法使用。在配置反向代理时，请重写请求 Host 头为带有 Bucket 名称的官方 Bucket 域名，否则 OSS 无法识别你的 Bucket，参考配置方法如下：

nginx
location / {
    proxy_pass https://<bucket-name>.oss-<region>.aliyuncs.com;
    proxy_set_header Host <bucket-name>.oss-<region>.aliyuncs.com;
}

WARNING

无论是反代还是 CNAME 解析，目标 Endpoint 都是带有 Bucket 名称的 Bucket 域名，不要错填成不带 Bucket 名称前缀的 Endpoint。

启用自定义 Endpoint ​

在存储策略配置的 基本信息 -> Endpoint 中填写你的自定义域名，并勾选 这是一个自定义域名 选项。

常见问题 ​

上传报错 无法完成文件上传: Private address is forbidden to callback. (InvalidArgument)

请检查 参数设置 -> 站点信息 -> 站点 URL 中 主要 站点 URL 是否正确，必须为公网可以访问的地址。

上传报错 无法完成文件上传: xxxxx (CallbackFailed)

这一报错说明 OSS 无法请求你的回调地址。请检查 参数设置 -> 站点信息 -> 站点 URL 中 主要 站点 URL 是否正确，必须为公网可以访问的地址。

在报错中，xxxx 为请求回调地址时具体的报错信息，请根据报错信息进行排查。

上传报错 无法创建上传会话: xxxxx The bucket you are attempting to access must be addressed using the specified endpoint. Please send all future requests to this endpoint
  1. 检查存储策略中 Endpoint 设置，避免使用官方 Endpoint 的情况下仍然勾选 这是一个自定义域名;
  2. 如果正在使用自定义 Endpoint：
    • 请检查其指向的是否为带有 Bucket 名称的 Bucket 域名，而不是官方 Endpoint;
    • 请检查是否在 OSS 存储桶配置中添加并验证了了该自定义域名; 或者在反代配置中是否正确重写了 Host 头;
中转上传失败，提示 无法解析响应

  1. 展开详细错误，检查错误信息中是否含有 413 Request Entity Too Large 字样。

    如果有，请修改 Nginx 反代配置，设定或增大 client_max_body_size 的值，比如 client_max_body_size 20000m;。此设定值应大于上传文件的大小。

  2. 检查是否有外部 WAF 防火墙拦截了上传请求。

上传报错 请求失败: AxiosError: Network Error xxx

  1. 检查存储策略 Endpoint 设置是否正确:

    • 用户侧是否能够访问到此 Endpoint;
    • 站点如果启用了 HTTPS，请确保你填写的 Endpoint 也是 HTTPS 开头，并配置了有效的 SSL 证书;

  2. 检查跨域策略是否设置，以及设置是否正确；

图片可以浏览和下载，但是使用 Photopea 打开时一直卡在 Loading 状态

检查存储桶的防盗链设置，需要允许 Refer 为 https://photopea.com 的请求。