# 域名管理

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

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

| 业务名称 | 域名名称 | 域名介绍 |
| :--- | :--- | :--- |
| 小程序 | 小程序业务域名 | 配置为业务域名后，可调用 `web-view` 组件在小程序和小游戏中打开指定域名内的网页 |
|  | 小程序服务器域名 | 配置为服务器域名后，小程序**可以跟指定的域名进行网络通信** |
| 小游戏 | 小游戏业务域名 | 配置为业务域名后，可调用 `web-view` 组件在小程序和小游戏中打开指定域名内的网页 |
|  | 小游戏服务器域名 | 配置为服务器域名后，小游戏**可以跟指定的域名进行网络通信** |
| 公众号 | 公众号 JS 接口安全域名 | 设置 JS 接口安全域名后，微信网页应用可在该域名下调用微信开放的公众号 JS 接口 |
| 服务号 | 服务号 JS 接口安全域名 | 设置 JS 接口安全域名后，微信网页应用可在该域名下调用微信开放的服务号 JS 接口 |
|  | 服务号业务域名 | 设置服务号业务域名后，在微信内访问该域名下页面时，不会被重新排版 |
|  | 服务号网页授权域名 | 设置服务号网页授权域名后，微信网页应用可在该域名下实现**微信网页应用的授权登录**功能 |
| 网站应用 | 网站应用授权回调域名 | 设置授权回调域名后，微信扫码登录后的回调只能回调至该域名下的页面，是**网站应用微信登录**的前置必要配置 |
|  | 网站应用业务域名 | 设置业务域名后，网站应用可在该域名下调用 PC OpenSDK 能力 |
| 第三方平台 | 第三方平台授权发起页域名 | 必须从本域名内网页跳转到第三方平台扫码授权页，才可完成将权限集授权给第三方平台 |
|  | 第三方平台网页开发域名 | 第三方平台在代公众号或服务号做网页授权、调用 JS SDK 等网页开发工作时所用的域名 |
|  | 第三方平台服务器域名 | 第三方平台在代开发小程序时所用的小程序服务器域名 |
|  | 第三方平台业务域名 | 第三方平台在代开发小程序时所用的小程序业务域名 |

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

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

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

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

**功能介绍**

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

**操作路径**

- [微信公众平台](https://mp.weixin.qq.com) - 管理 - 开发管理 - 开发设置 - 业务域名
- 补充说明：配置业务域名，需管理员扫码授权确认

![](https://res8.wxqcloud.qq.com.cn/wxdoc/919be53d-9493-4339-bd24-a86ff8aa590e.png)

**限制说明**

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

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

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

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

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

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

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

**其他注意事项**

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

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

**功能介绍**

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

**操作路径**

- [微信公众平台](https://mp.weixin.qq.com) - 管理 - 开发管理 - 开发设置 - 服务器域名
- 补充说明：配置服务器域名，需管理员扫码授权确认

![](https://res8.wxqcloud.qq.com.cn/wxdoc/126d4680-6f35-4560-8371-51b5f39a018f.png)

**限制说明**

1）域名不能使用 IP 地址（小程序的[局域网](/miniprogram/dev/framework/ability/mDNS.md) 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 的权限集授权给第三方平台（即，将小程序代开发权限授权给第三方平台），则该小程序账号不可再在小程序后台控制台中配置和管理服务器域名，关于第三方平台服务商使用小程序服务器域名的详细介绍可查看[第三方平台代开发的小程序域名配置说明](/doc/oplatform/Third-party_Platforms/2.0/product/domain.md)

## 2、公众号的域名

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

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

**功能介绍**

- 设置 JS 接口安全域名后，微信网页应用可在该域名下调用微信开放的[公众号 JS 接口](/doc/subscription/guide/h5/jssdk.md)。

**操作路径**

- [微信开发者平台](https://developers.weixin.qq.com/platform/) - 我的业务 - 公众号 - 基础信息 - 域名与消息推送配置 - JS 接口安全域名
- 补充说明：配置 JS 接口安全域名，需管理员扫码授权确认

![](https://res8.wxqcloud.qq.com.cn/wxdoc/7c11514f-4138-4402-b246-59043f24c6a9.png)

**限制说明**

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

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

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

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

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

**其他注意事项**

- 如果当前公众号账号将权限 id 为 4 的权限集授权给第三方平台（即，将网页服务代开发权限授权给第三方平台），第三方服务商可代开发网页应用，详情可查看[代公众号使用 JS SDK](/doc/oplatform/Third-party_Platforms/2.0/Before_Develop/Official_Accounts/js_sdk_instructions.md)

## 3、服务号的域名

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

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

**功能介绍**

- 设置 JS 接口安全域名后，微信网页应用可在该域名下调用微信开放的[服务号 JS 接口](/doc/subscription/guide/h5/jssdk.md)。

**操作路径**

- [微信开发者平台](https://developers.weixin.qq.com/platform/) - 我的业务 - 服务号 - 基础信息 - 域名与消息推送配置 - JS 接口安全域名
- 补充说明：配置 JS 接口安全域名，需管理员扫码授权确认

**限制说明**

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

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

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

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

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

**其他注意事项**

- 如果当前服务号账号将权限 id 为 4 的权限集授权给第三方平台（即，将网页服务代开发权限授权给第三方平台），第三方服务商可代开发网页应用，详情可查看[代服务号使用 JS SDK](/doc/oplatform/Third-party_Platforms/2.0/Before_Develop/Official_Accounts/js_sdk_instructions.md)

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

**功能介绍**

- 设置服务号网页授权域名后，微信网页应用可在该域名下实现微信[网页应用的授权登录](/doc/service/guide/h5/auth.md)功能。

**操作路径**

- [微信公众平台](https://mp.weixin.qq.com) - 设置与开发 - 账号设置 - 功能设置 - 网页授权域名
- 补充说明：配置网页授权域名，需管理员扫码授权确认
- 注意事项：已认证的服务号或部分已认证的政府和媒体类型的公众号才能看到此域名配置

![](https://res8.wxqcloud.qq.com.cn/wxdoc/1df7dc0b-6ed9-4997-b457-a6d818a39f5d.png)

**限制说明**

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

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

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

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

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

**其他注意事项**

- 如果当前服务号账号将权限 id 为 4 的权限集授权给第三方平台（即，将网页服务代开发权限授权给第三方平台），第三方服务商可代开发网页应用，详情可查看[代服务号发起网页授权](/doc/oplatform/Third-party_Platforms/2.0/Before_Develop/Official_Accounts/official_account_website_authorization.md)

### 3.3 服务号的业务域名

**功能介绍**

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

**操作路径**

- [微信公众平台](https://mp.weixin.qq.com) - 设置与开发 - 账号设置 - 功能设置 - 业务域名
- 补充说明：配置业务域名，需管理员扫码授权确认

![](https://res8.wxqcloud.qq.com.cn/wxdoc/5c8233f1-5ed9-4298-ac47-6abaad241131.png)

**限制说明**

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

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

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

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

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

## 4、网站应用的域名

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

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

**功能介绍**

- 设置授权回调域名后，微信扫码登录后的回调只能回调至该域名下的页面，是[网站应用微信登录](/doc/oplatform/Website_App/WeChat_Login/Wechat_Login.md)的前置必要配置。

**操作路径**

- [微信开放平台](https://open.weixin.qq.com) - 管理中心 - 网站应用 - 详情 - 开发配置 - 开发信息 - 域名信息 - 授权回调域

![](https://res8.wxqcloud.qq.com.cn/wxdoc/68d5c70c-08cd-4c98-9396-0bd2c928a46a.png)

**限制说明**

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

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

### 4.2 网站应用的业务域名

**功能介绍**

- 设置业务域名后，网站应用可在该域名下调用 PC OpenSDK 能力，详情可查看[网站应用调用 PC 微信能力](/doc/oplatform/Website_App/WeChat_PC_APIs/guideline.md)。

**操作路径**

- [微信开放平台](https://open.weixin.qq.com) - 管理中心 - 网站应用 - 详情 - 开发配置 - 开发信息 - 域名信息 - 业务域名

**限制说明**

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

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

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

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

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

## 5、第三方平台的域名

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

**操作路径**

- [微信开放平台](https://open.weixin.qq.com) - 管理中心 - 第三方平台 - 详情 - 开发配置 - 开发资料

![](https://res8.wxqcloud.qq.com.cn/wxdoc/64600ba4-59c4-41c7-9b3a-2b2f47190433.png)

**授权发起页域名限制说明**

1）每个第三方平台账号支持配置最多 1 个授权发起页域名。必须从本域名内网页跳转到授权页，才可完成授权，否则会出现「授权入口页域名为空」或者「授权入口页域名不一致」的报错，详情可查看[第三方授权常见问题](/doc/oplatform/Third-party_Platforms/2.0/troubleshooting/authorization_troubleshooting.md)

**网页开发域名限制说明**

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

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

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

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

**小程序服务器域名限制说明**

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

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

更多规则和介绍可查看[第三方平台代开发的小程序域名配置说明](/doc/oplatform/Third-party_Platforms/2.0/product/domain.md)。

**小程序业务域名限制说明**

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

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

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

更多规则和介绍可查看[第三方平台代开发的小程序域名配置说明](/doc/oplatform/Third-party_Platforms/2.0/product/domain.md)。