# 域名管理

在微信开发生态中，各个业务依据业务的需求，在对应的功能模块中设置支持了不同的域名配置和管理，例如小程序业务中有服务器域名和业务域名，而在服务号中则有 JS 接口安全域名、网页授权域名以及业务域名。本文将区分不同的业务进行对应的域名的功能介绍，方便开发者理解以及进行管理。

各个业务具备的“域名”概览如下：

其他业务，例如微信小店、移动应用、带货助手等等，尚不涉及进行域名的配置。

# 1. 小程序和小游戏的域名

在小程序和小游戏业务中，分别有「服务器域名」和「业务域名」两类域名，对应的介绍如下：

# 1.1 小程序和小游戏业务域名

功能介绍

• 配置为业务域名后，可调用 web-view 组件在小程序和小游戏中打开指定域名内的网页。即，可在小程序和小游戏中实现内嵌网页的能力。

操作路径

• 开发者登录小程序后台（https://mp.weixin.qq.com），前往「管理 - 开发管理 - 开发设置 - 业务域名」，即可新增或修改业务域名，操作界面如下：
• 补充说明：配置服务器域名，需管理员扫码授权确认

限制说明

1）仅支持非个人主体类型的小程序和小游戏账号可配置业务域名（即，个人主体类型的账号不支持）

2）每个小程序和小游戏账号支持配置最多 300 个域名；

3）每个域名支持绑定最多 100 个企业主体的小程序；

4）域名只支持 https 协议，不支持IP地址；

5）域名需经过ICP备案，新备案域名需24小时后才可配置。域名格式只支持英文大小写字母、数字及“-”，不支持IP地址

6）需将校验文件放置在域名根目录下，并确保可以访问该文件，否则无法添加业务域名

7）配置业务域名后，可打开任意合法的子域名；

其他注意事项

• 如果当前小程序账号将权限 id 为 18 的权限集授权给第三方平台（即，将小程序代开发权限授权给第三方平台），则该小程序账号不可再在小程序后台控制台中配置和管理业务域名，关于第三方平台服务商使用小程序业务域名的详细介绍可查看第三方平台代开发的小程序域名配置说明

# 1.2 小程序和小游戏服务器域名

功能介绍

• 配置为服务器域名后，小程序或小游戏可以跟指定的域名进行网络通信 。包括普通 HTTPS 请求 (wx.request）、上传文件（wx.uploadFile）、下载文件（wx.downloadFile) 和 WebSocket 通信（wx.connectSocket）、TCP 通信（wx.createTCPSocket）、UDP 通信（wx.createUDPSocket）。以及 DNS 预解析域名和预连接域名也是在此处配置。

操作路径

• 开发者登录小程序后台（https://mp.weixin.qq.com），前往「管理 - 开发管理 - 开发设置 - 服务器域名」，即可新增或修改服务器域名，操作界面如下：
• 补充说明：配置服务器域名，需管理员扫码授权确认

限制说明

1）域名不能使用 IP 地址（小程序的局域网 IP 除外）或 localhost；

2）每类服务器域名最多支持配置 200 个；

3）对于 https 域名，可以配置端口，如 https://myserver.com:8080，但是配置后只能向 https://myserver.com:8080 发起请求。如果向 https://myserver.com、https://myserver.com:9091 等 URL 请求则会失败。如果不配置端口。如 https://myserver.com，那么请求的 URL 中也不能包含端口，甚至是默认的 443 端口也不可以。如果向 https://myserver.com:443 请求则会失败；

4）出于安全考虑，api.weixin.qq.com 不能被配置为服务器域名，相关API也不能在小程序内调用。 开发者应将 AppSecret 保存到后台服务器中，通过服务器使用 getAccessToken 接口获取 access_token，并调用相关 API；

5）域名需经过ICP备案，新备案域名需24小时后才可配置；

6）不支持配置父域名，使用子域名；

其他注意事项

• 如果当前小程序账号将权限 id 为 18 的权限集授权给第三方平台（即，将小程序代开发权限授权给第三方平台），则该小程序账号不可再在小程序后台控制台中配置和管理服务器域名，关于第三方平台服务商使用小程序服务器域名的详细介绍可查看第三方平台代开发的小程序域名配置说明

# 2. 公众号的域名

在公众号业务中，仅支持「JS 接口安全域名」配置

# 2.1 公众号的 JS 接口安全域名

功能介绍

• 设置 JS 接口安全域名后，微信网页应用可在该域名下调用微信开放的公众号 JS 接口。

操作路径

• 登录微信开发者平台（https://developers.weixin.qq.com/platform），前往「我的业务 - 公众号 - 基础信息 - 域名与消息推送配置 - JS接口安全域名」，即可新增或修改JS接口安全域名，操作界面如下：
• 补充说明：配置服务器域名，需管理员扫码授权确认

限制说明

1）每个公众号账号支持配置最多 5 个域名；

2）每个月最多可修改 5 次；

3）域名只支持 https 协议，不支持IP地址；

4）域名需经过ICP备案，新备案域名需24小时后才可配置。域名格式只支持英文大小写字母、数字及“-”，不支持IP地址；

5）需将校验文件放置在域名根目录下，并确保可以访问该文件，否则无法添加域名

其他注意事项

• 如果当前公众号账号将权限 id 为 4 的权限集授权给第三方平台（即，将网页服务代开发权限授权给第三方平台），第三方服务商可代开发网页应用，详情可查看代公众号使用js sdk

# 3. 服务号的域名

在服务号业务中，分别有「JS 接口安全域名」和「业务域名」以及「网页授权域名」3类域名，对应的介绍如下：

# 3.1 服务号的 JS 接口安全域名

功能介绍

• 设置 JS 接口安全域名后，微信网页应用可在该域名下调用微信开放的服务号 JS 接口。

操作路径

• 登录微信开发者平台（https://developers.weixin.qq.com/platform），前往「我的业务 - 服务号 - 基础信息 - 域名与消息推送配置 - JS接口安全域名」，即可新增或修改JS接口安全域名，操作界面同公众号 JS 接口安全域名。
• 补充说明：配置服务器域名，需管理员扫码授权确认

限制说明

1）每个服务号账号支持配置最多 5 个域名；

2）每个月最多可修改 5 次；

3）域名只支持 https 协议，不支持IP地址；

4）域名需经过ICP备案，新备案域名需24小时后才可配置。域名格式只支持英文大小写字母、数字及“-”，不支持IP地址；

5）需将校验文件放置在域名根目录下，并确保可以访问该文件，否则无法添加域名

其他注意事项

• 如果当前服务号号账号将权限 id 为 4 的权限集授权给第三方平台（即，将网页服务代开发权限授权给第三方平台），第三方服务商可代开发网页应用，详情可查看代服务号使用js sdk

# 3.2 服务号的网页授权域名

功能介绍

• 设置服务号网页授权域名后，微信网页应用可在该域名下调用实现微信网页应用的授权登录功能。

操作路径

• 登录微信公众平台（https://developers.weixin.qq.com/platform），选择已认证的服务号登录，前往「设置与开发 - 账号设置 - 功能设置 - 网页授权域名」，即可新增或修改网页授权域名，操作界面如下：
• 补充说明：配置服务器域名，需管理员扫码授权确认

限制说明

1）每个已认证的服务号账号支持配置最多 2 个网页授权域名；（公众号或者未认证的服务号不支持配置网页授权域名）

2）每个月最多可修改 5 次；

3）域名只支持 https 协议，不支持IP地址；

4）域名需经过ICP备案，新备案域名需24小时后才可配置。域名格式只支持英文大小写字母、数字及“-”，不支持IP地址；

5）需将校验文件放置在域名根目录下，并确保可以访问该文件，否则无法添加域名

其他注意事项

• 如果当前服务号号账号将权限 id 为 4 的权限集授权给第三方平台（即，将网页服务代开发权限授权给第三方平台），第三方服务商可代开发网页应用，详情可查看代服务号发起网页授权

# 3.3 服务号的业务域名

功能介绍

• 置服务号业务域名后，在微信内访问该域名下页面时，不会被重新排版。

操作路径

• 登录微信公众平台（https://developers.weixin.qq.com/platform），选择已认证的服务号登录，前往「设置与开发 - 账号设置 - 功能设置 - 网页授权域名」，即可新增或修改业务域名，操作界面如下：
• 补充说明：配置服务器域名，需管理员扫码授权确认

限制说明

1）每个服务号账号支持配置最多 3 个业务域名；（公众号或者未认证的服务号不支持配置业务域名）

2）每个月最多可修改 5 次；

3）域名只支持 https 协议，不支持IP地址；

4）域名需经过ICP备案，新备案域名需24小时后才可配置。域名格式只支持英文大小写字母、数字及“-”，不支持IP地址；

5）需将校验文件放置在域名根目录下，并确保可以访问该文件，否则无法添加域名

# 4. 网站应用的域名

在网站应用业务中，分别有「授权回调域」和「业务域名」2 类域名，对应的介绍如下：

# 4.1 网站应用的授权回调域名

功能介绍

• 设置授权回调域名后，微信扫码登录后的回调只能回调至该域名下的页面，是网站应用微信登录的前置必要配置。

操作路径

• 登录微信开放平台（https://open.weixin.qq.com），前往「管理中心 - 网站应用 - 详情 - 开发配置 - 开发信息 - 域名信息 - 授权回调域」，即可新增或修改网站应用的授权回调域，操作界面如下：

限制说明

1）每个网站应用账号支持配置最多 1 个域名；

2）每个月最多可修改 5 次；

# 4.2 网站应用的业务域名

功能介绍

• 设置业务域名后，网站应用可在该域名下调用 PC OpenSDK 能力，详情可查看网站应用调用 PC 微信能力。

操作路径

• 登录微信开放平台（https://open.weixin.qq.com），前往「管理中心 - 网站应用 - 详情 - 开发配置 - 开发信息 - 域名信息 - 业务域名」，即可新增或修改网站应用的业务域名，操作界面同授权回调域名的操作路径。

限制说明

1）每个网站应用账号支持配置最多 3 个域名；

2）每个月最多可修改 5 次；

3）仅支持 https，且不能有 "/" 后缀

4）域名需经过ICP备案，新备案域名需24小时后才可配置；

5）需将校验文件放置在域名根目录下，并确保可以访问该文件，否则无法添加域名

# 5. 第三方平台的域名

在第三方平台业务中，属于第三方平台账号纬度的域名配置仅有「授权发起页域名」，而需代公众号和服务号实现网页应用开发时，需配置「网页开发域名」，代开发小程序业务时需配置「小程序服务器域名」和「小程序业务域名」

操作路径

• 登录微信开放平台（https://open.weixin.qq.com），前往「管理中心 - 第三方平台 - 详情 - 开发配置 - 开发资料 」，即可新增或修改第三方平台的域名配置，操作界面如下：

授权发起页域名限制说明

1）每个第三方平台账号支持配置最多 1 个授权发起页域名；必须从本域名内网页跳转到授权页，才可完成授权，否则会出现“授权入口页域名为空”或者“授权入口页域名不一致”的报错，详情可查看第三方授权常见问题

第三方平台的网页开发域名限制说明

1）每个第三方平台账号支持配置最多 3 个域名；

2）每个月最多可修改 3 次；

3）域名需经过ICP备案，新备案域名需24小时后才可配置；

4）需将校验文件放置在域名根目录下，并确保可以访问该文件，否则无法添加域名

第三方平台的小程序服务器域名限制说明

1）每个第三方平台账号支持配置最多 1000 个小程序服务器域名；

2）每个月最多可修改 50 次；

更多规则和介绍可查看第三方平台代开发的小程序域名配置说明。

第三方平台的小程序业务域名限制说明

1）每个第三方平台账号支持配置最多 300 个小程序业务域名；

2）域名需经过ICP备案，新备案域名需24小时后才可配置；

3）需将校验文件放置在域名根目录下，并确保可以访问该文件，否则无法添加域名

更多规则和介绍可查看第三方平台代开发的小程序域名配置说明。