环境和域名

本文介绍魔笔空间中的环境和域名。

什么是环境

环境是魔笔应用运行时基础设施资源的抽象。为了避免在每一个应用中重复地操作环境,魔笔提供空间级别的环境管理能力。空间级别的环境管理并不意味着同一空间内的应用共享没有隔离的物理环境,而指的是空间内的应用都使用同一份环境配置(如环境标识、域名等)。

环境类型

在空间完成初始化后,魔笔会自动为每个空间创建两个默认的环境,分别是开发环境和生产环境。特别地,开发环境中发布成功的应用将在24小时后失效,失效之后想要访问开发环境的应用需要重新进行发布操作。魔笔设置开发环境的初衷是为客户提供开发测试的环境,而不作为长久使用的站点存在。

image

说明

魔笔未来将支持用户在空间中创建和管理自己的环境,目前暂未开放。

如何添加域名

您可以将已备案的域名添加到魔笔平台中,应用发布后即可以使用自己的域名通过 HTTPS 协议访问。

魔笔平台支持两种方式添加域名和设置 SSL 证书:

  1. 使用 阿里云 Web 应用防火墙,将域名接入到 Web 应用防火墙之后再添加到魔笔平台。

  2. 使用魔笔平台免费提供的测试证书和内置 WAF 服务(仅用于测试场景,如做大规模生产发布请自行配置 WAF 防火墙及 HTTPS 证书)

说明

无论哪种添加方式,域名本身都需要经过 ICP 备案

下面介绍魔笔添加域名详细流程。

1. 域名接入阿里云 Web 应用防火墙

  • 添加域名

在魔笔控制台->空间设置->域名设置中点击添加域名,录入待绑定域名。

image

重要
  1. 建议设置三级域名。例如您的二级域名的格式是 xxx.yyy,则在平台录入的域名是 zzz.xxx.yyy。

  2. 域名填写不要有大写英文字母。

录入域名成功后,将看到魔笔引导配置界面如下:

image

  • 域名校验

将上面步骤中的 TXT 记录2995c31dc3824df48dc836f75ff86451添加至 DNS 解析记录中。

image

  • 配置 Web 应用防火墙

Web 应用防火墙配置 指引

image

重要

在 Web 应用防火墙配置中,需要选择 HTTPS 协议。

服务器地址选择根据配置 Web 应用防火墙配置提示的回源地址配置。

image

  • 配置 DNS 解析 CNAME 记录

将 Web 应用防火墙中的 CNAME 添加到 DNS 解析中。

image

  • 验证域名

点击按钮开始验证域名,刚配置完 DNS 解析有可能验证失败,耐心等待 DNS 配置生效即可验证成功。

image

说明

第一次验证域名不成功时,添加域名面板被关闭后在域名列表可以看到处于新建状态的域名记录,可以点击该记录继续域名验证流程。

image

2. 使用魔笔平台免费提供的测试证书和内置WAF服务

  • 添加域名

在魔笔控制台->空间设置->域名设置中点击添加域名,录入待绑定域名。

image

添加完域名之后,在类型中选择系统默认,会出现以下提示页面。

image

  • 域名校验

根据页面提示,将上面步骤中的 TXT 记录添加至 DNS 解析记录中。

  • 配置 DNS 解析 CNAME 记录

根据页面提示,将魔笔平台默认的 CNAME 地址添加到 DNS 解析记录中。

  • 验证域名

点击按钮开始验证域名,刚配置完 DNS 解析有可能验证失败,耐心等待 DNS 配置生效即可验证成功。

重要
  1. 魔笔平台提供的免费测试证书一般仅用于个人网站或测试使用,不建议业务成熟的企业类型网站使用。如果您使用的是企业类型网站,建议购买正式证书。

  2. 每个工作空间只支持添加一个免费测试 HTTPS 证书。

域名关联环境

域名校验通过后,可以在域名列表看到域名关联记录。在列表中,可以通过关联环境和取消关联来完成域名和环境的关联操作。

image

说明
  1. 魔笔平台会在开发环境预置runtime.mobiapp.cloud的默认域名,该域名无法被取消关联或者删除。

  2. 如果域名有关联的应用配置了自定义路径,也不能被取消关联或者删除。

应用自定义路径设置

在设置域名后,您可以使用“应用地址”访问应用,也可以为生产环境的应用设置自定义的访问地址,即“自定义路径”。

image

应用自定义路径可以为根路径 “/” 或一级子路径如 “/abc”。

子路径有效字符:

数字、英文、“-”、“_”,正则表示:[a-zA-Z0-9_-]

特殊说明:

假设应用A自定义路径为根路径,应用内有页面B子路径为“/abc”,应用C设置了同样的自定义路径“/abc”

  1. 此时访问路径 “/” 将跳转到应用A ,若应用内访问页面B ,URL会更新为“/abc”,但此时刷新页面,将跳转到应用C 。

  2. /abc/* 将匹配应用C ,/* 将匹配应用A 。

因此,若自定义路径设置了“根路径”应用,应避免将应用内的页面路径与其他应用的自定义路径相同。