本文介绍魔笔空间中的环境和域名。
什么是环境
环境是魔笔应用运行时基础设施资源的抽象。为了避免在每一个应用中重复地操作环境,魔笔提供空间级别的环境管理能力。空间级别的环境管理并不意味着同一空间内的应用共享没有隔离的物理环境,而指的是空间内的应用都使用同一份环境配置(如环境标识、域名等)。
环境类型
在空间完成初始化后,魔笔会自动为每个空间创建两个默认的环境,分别是开发环境和生产环境。特别地,开发环境中发布成功的应用将在24小时后失效,失效之后想要访问开发环境的应用需要重新进行发布操作。魔笔设置开发环境的初衷是为客户提供开发测试的环境,而不作为长久使用的站点存在。
魔笔未来将支持用户在空间中创建和管理自己的环境,目前暂未开放。
如何添加域名
下面以具体域名为例介绍魔笔添加域名流程。
前提条件
拥有一个经过 ICP 备案 的域名
1. 录入域名
在魔笔控制台->空间设置->域名设置中点击添加域名,录入待绑定域名。
添加域名前,必须先完成域名备案。
建议设置三级域名。例如您的二级域名的格式是 xxx.yyy,则在平台录入的域名是 zzz.xxx.yyy。
2. 配置 Web 应用防火墙
录入域名成功后,将看到魔笔引导配置界面如下:
配置 DNS 解析 TXT 记录
将上面步骤中的 TXT 记录2995c31dc3824df48dc836f75ff86451
添加至 DNS 解析记录中。
配置 Web 应用防火墙
Web 应用防火墙配置 指引
在 Web 应用防火墙配置中,需要同时设置 HTTP 和 HTTPS协议。
服务器地址选择根据配置 Web应用防火墙配置提示的回源地址配置。
配置 DNS 解析 CNAME 记录
将 Web 应用防火墙中的 CNAME 添加到 DNS 解析中。
验证域名
刚配置完 DNS 解析有可能验证失败,耐心等待 DNS 配置生效即可验证成功。
第一次验证域名不成功时,添加域名面板被关闭后在域名列表可以看到处于新建状态的域名记录,可以点击该记录继续域名验证流程。
3. 关联环境
在配置面板中选择对应的环境关联即可。
免费测试 HTTPS 证书
为降低应用发布到生产环境的门槛,魔笔为您的域名提供免费测试 HTTPS 证书。您可以在配置 Web 应用防火墙处选择使用系统默认提供的免费证书。
魔笔平台提供的免费测试证书一般仅用于个人网站或测试使用,不建议业务成熟的企业类型网站使用。如果您使用的是企业类型网站,建议购买正式证书。
每个工作空间只支持添加一个免费测试 HTTPS 证书。
应用自定义路径设置
在设置域名后,您可以为生产环境的应用设置自定义路径
应用自定义路径可以为根路径 “/” 或一级子路径如 “/abc”。
子路径有效字符:
数字、英文、“-”、“_”,正则表示:[a-zA-Z0-9_-]
。
特殊说明:
假设应用A自定义路径为根路径,应用内有页面B子路径为“/abc”,应用C设置了同样的自定义路径“/abc”
此时访问路径 “/” 将跳转到应用A,若应用内访问页面B,URL会更新为“/abc”,但此时刷新页面,将跳转到应用C。
/abc/*
将匹配应用C,/*
将匹配应用A。
因此,若自定义路径设置了“根路径”应用,应避免将应用内的页面路径与其他应用的自定义路径相同。
域名关联/取消关联环境
域名校验通过后,可以在域名列表看到域名关联记录。在列表中,可以通过关联环境和取消关联来完成域名和环境的关联操作。
魔笔平台会在开发环境预置runtime.mobiapp.cloud
的默认域名,该域名无法被取消关联或者删除。