简介 | uniCloud

前端网页托管适于uni-app的h5页面发布。尤其是配搭uniCloud云开发，将彻底不用再租用任何传统的服务器。
前端网页托管适于所有前后端分离的网站中的前端页面发布，包括pc网页。
仅支持html、CSS、JavaScript、字体、图片、音视频、json等文件。不支持php、java、python、ruby、go、c++等其他需要额外语言解释器解释的语言文件。
如果开发者需要做a/b test或灰度新功能，需要自己在js里写代码实现，不能通过路由到不同服务器实现。
uni-app项目编译为h5时，在项目的manifest中配置二级目录。上传时无需重复设置二级目录。
一个前端网页托管的空间里，可以上传多个网站，用不同目录区分开，访问时使用同一个域名后加不同目录的方式访问。不支持每个目录单独设置不同域名。
部署到不同的服务空间的前端网页托管内的网站，也是可以访问同一个服务空间内的云函数的，只需要在部署云函数的服务空间的跨域配置内添加部署前端页面的域名即可
腾讯云缓存时间默认为1天，阿里云一般情况下文件变动后会一小段时间内自动刷新缓存

# 基础配置

本章节介绍前端网页托管提供的各种配置项目说明。其中配置域名、网站首页、404页面，是阿里云和腾讯云均支持的，其他配置仅腾讯云支持。

# 配置域名

前端网页托管，自带一个测试域名，仅用于产品体验及测试可快速体验前端网页部署的完整流程，该域名有如下限制：

阿里云每分钟最多60次请求，默认每日仅允许10个公网IP访问，超出部分，需通过手动方式将来源IP加入白名单,IP白名单也会有数量限制
腾讯云限速100K/s

业务如要上线商用，请配置自己的正式域名，配置自己的正式域名后，将不受上述测试域名的限制。（尤其注意阿里云测试域名是公共的，任意一个服务空间如果有上传恶意文件被投诉，会导致测试域名被微信内置浏览器整体禁封）

前端网页托管配置自己域名的步骤如下：

1、登录uniCloud控制台。 2、进入前端网页托管页面，选择【基础设置】，单击【添加域名】，进行域名添加，（注意：域名是需要自行购买的）如下图所示：

3、添加后，系统会自动分配一个 CNAME 域名，CNAME 域名不能直接访问，您需要在域名服务提供商处完成 CNAME 配置（将添加的域名CNAME到此域名），配置生效后，新域名即可使用。

阿里云现已支持http强制跳转https，在上述添加界面打开对应开关即可

域名备案

如果你已经有备案过的域名，直接解析过来即可；如果你要新注册域名，首先自行在网上购买，然后注意域名如果想在国内正常绑定阿里云或腾讯云，需要域名备案。这里的备案流程和传统云主机略有不同，涉及一个uniCloud没有固定ip的问题。此时可以去买花生壳的备案服务；也可以临时买一个短期传统云，走传统备案；还有授权码方案，这里有开发者分享的经验贴：https://ask.dcloud.net.cn/article/38116

关于证书内容与私钥

域名如果使用https，则需要证书。证书签发后，可下载到本地，然后将内容复制黏贴到uniCloud web控制台。

注意：各运营商下载证书的后缀可能不同，一般来说，.key文件对应私钥，.pem或.crt文件对应证书。这几种类型文件都是文本内容，可选择记事本打开查看内容。

如果您还没有SSL证书，点此快速获取。

注意事项

在阿里云开启了泛域名加速的情况下，对应的子域名可能无法配置到前端网页托管，这种情况下可能会提示：该域名已被添加过，不能重复添加
暂不支持绑定中文域名
阿里云要求必须有一个备案在阿里才可以绑定，按照uniCloud web控制台提示操作即可，腾讯云没有此条限制。

务必注意，如果你是在腾讯购买并备案的域名需要保留一个到腾讯ip的解析，否则备案会被撤销，阿里云同理。具体细节可以咨询购买域名的云厂商

# 路由规则

网站首页

设置网站首页文档名

404页面

访问静态网站出错后返回的页面。

如需在阿里云正式版支持history模式，请将404页面配置为网站首页。注意正式版404页面不支持目录，即阿里云仅能在根目录下支持history模式

重定向规则

仅腾讯云支持

支持以下三种组合配置

类型：错误码、规则：替换路径。将特定错误码的请求重定向到目标文档，仅支持对4xx错误码。

例：将404错误码重定向至index.html，需做如下配置（uni-app项目使用history模式发行到h5时可以使用此配置）：

类型	描述	规则	替换内容
错误码	404	替换路径	index.html

类型：前缀匹配、规则：替换路径。将匹配到特定前缀的请求重定向到目标文档

例：当您删除了images/文件夹（即删除了具有前缀images/的所有对象）。您可以添加重定向规则，将具有前缀images/的任何对象的请求重定向至test.html页面。

类型	描述	规则	替换内容
前缀匹配	images/	替换路径	test.html

类型：前缀匹配、规则：替换前缀。将匹配到特定前缀的请求中的前缀替换为替换内容，例：

例：当您将文件夹从docs/重命名为documents/后，用户在访问docs/文件夹会产生错误。所以，您可以将前缀docs/的请求重定向至documents/。

类型	描述	规则	替换内容
前缀匹配	docs/	替换前缀	documents/

注意

阿里云每天仅能修改3次路由规则

# 缓存配置

仅腾讯云、支付宝云支持

文件类型：根据填入的文件后缀进行缓存过期时间设置，格式为.jpg形式，不同后缀之间用;间隔。
文件夹：根据填入的目录路径进行缓存过期时间设置，格式为/test形式，无需以/结尾，不同目录之间用;间隔。
全路径文件：指定完整的文件路径进行缓存过期时间设置，格式为/index.html，支持完整路径加文件类型匹配模式，如/test/*.jpg。

注意

缓存过期规则最多可配置10条。
多条缓存过期规则之间的优先级为底部优先。
缓存过期时间最多可设置365天。

# 刷新缓存

仅腾讯云、阿里云商用版支持

腾讯云需要填写要刷新的链接，针对填写的链接进行刷新。阿里云对默认域名和自定义域名一键刷新。

注意

阿里云商用版限制每小时只允许刷新3次

# 防盗链配置

仅腾讯云、支付宝云支持

referer 黑名单：

若请求的 referer 字段匹配黑名单内设置的内容，CDN 节点拒绝返回该请求信息，直接返回403状态码。
若请求的 referer 不匹配黑名单内设置的内容，则 CDN 节点正常返回请求信息。
当勾选包含空 referer 选项时，此时若请求 referer 字段为空或无 referer 字段（如浏览器请求），则 CDN 节点拒绝返回该请求信息，返回403状态码。

referer白名单：

若请求的 referer 字段匹配白名单设置的内容，则 CDN 节点正常返回请求信息。
若请求的 referer 字段不匹配白名单设置的内容，则 CDN 节点拒绝返回该请求信息，会直接返回状态码403。
当设置白名单时，CDN 节点只能返回符合该白名单内字符串内容的请求。
当勾选包含空 referer 选项时，此时若请求 referer 字段为空或无 referer 字段（如浏览器请求），则 CDN 正常返回请求信息。

配置规则：

防盗链支持域名 / IP 规则，匹配方式为前缀匹配（仅支持路径情况下，域名的前缀匹配不支持），即假设配置名单为www.abc.com，则www.abc.com/123匹配，www.abc.com.cn不匹配；假设配置名单为127.0.0.1，则127.0.0.1/123也会匹配。防盗链支持通配符匹配，即假设名单为*.qq.com，则www.qq.com、a.qq.com均会匹配。

# IP黑白名单配置

仅腾讯云、支付宝云支持

IP 黑名单

用户端 IP 匹配黑名单中的 IP 或 IP 段时，访问 CDN 节点时将直接返回403状态码。

IP 白名单

用户端 IP 未匹配白名单中的 IP 或 IP 段时，访问 CDN 节点时将直接返回403状态码。

名单规则

IP 黑名单与 IP 白名单二选一，不可同时配置。
IP 段仅支持 /8、/16、/24 网段，不支持其他网段。
不支持IP：端口形式的黑白名单
名单最多可输入50个。

# 默认域名IP白名单

仅阿里云支持

为保障默认域名不被滥用，阿里云对默认域名做出了如下限制：每天前10个IP可以直接访问，超出10个IP后需要配置IP白名单才可以访问

仅支持配置ipv4，可以配置IP或者IP网段，掩码位数取值范围24-31。最多可同时配置三个，多个之间用逗号隔开，如：123.120.5.235/24,123.123.123.123

当访问IP超限或不在白名单时，前端网页托管将拒绝访问请求，并在页面输出错误码为ClientIpNotAllowed的提示：Your clientIp xxx does not in the whitelist.

您可以通过配置自定义域名并使用自定义域名访问来规避此问题。

# IP访问限频配置

仅腾讯云支持

配置说明

配置开启后，超出 QPS 限制的请求会直接返回514，设置较低频次限制可能会影响您的正常高频用户的使用，请根据业务情况、使用场景合理设置阈值。
限频仅针对与单 IP 单节点访问次数进行约束，若恶意用户海量 IP 针对性的进行全网节点攻击，则通过此功能无法进行有效控制。

# 跨域

web浏览器有跨域限制，A域名的网站如果通过js请求另一个域名B，且另一个B域名并没有放开跨域策略，那么浏览器就会报跨域错误。

在前端网页托管里，托管前端网页的网站就是A域名。要连接的服务器接口就是B域名。

B域名是uniCloud的云函数/云对象

也就是业务后台也在uniCloud的云函数或云对象上。此时需要在uniCloud的web控制台的跨域配置中，把A域名填写在Web安全域名中。

B域名是开发者自己的传统服务器

需要在开发者自己的传统服务器上配置跨域，允许A域名跨域访问自己。

# 缓存问题

如果在更新页面后浏览器访问到的仍是旧页面，可以通过如下流程排查

客户端禁用缓存或无痕模式打开是否正常，如果是就是客户端缓存问题，需要等浏览器缓存失效
排除了第一步的影响后，访问页面路径后加参数比如 /admin#/pages/index/index 改为 /admin?v=1#/pages/index/index，如果正常则是cdn缓存问题，在uniCloud前端网页托管配置页面刷新缓存即可