微信如何设置域名白名单？教程步骤详解！，域名白名单怎么设置？

登录微信公众平台后台，进入「设置与开发」-「安全中心」-「域名白名单」模块完成配置，生效时间通常为几分钟。

很多人第一次接触这个功能会摸不着头脑，看着后台一堆按钮不敢乱点，别急，这篇文章帮你从头到尾梳理清楚，从概念到实操、从常规站点到本地调试，一次讲透，微信生态对域名的管控逻辑这几年调整了不少，2026年这套操作基本稳定,照着做就行。

加载中

微信小程序的域名配置

T

True丶吻痕

8567--

原视频地址

域名白名单到底是什么

域名白名单是微信服务端提供的一个域名授权机制，只有你在后台登记过的域名，才有权限调用微信开放接口，比如你做了一个网站，首页里要调微信登录、要拉取用户信息、要发模板消息，这些动作发生前，微信会先检查你的域名是不是在白名单里,不在就拒绝服务。

行业共识认为，这是微信为了拦截恶意站点、保障用户数据安全设的一道闸门，它是服务器层面的校验,跟用户在手机端看到什么页面没有直接关系。

这里要特别区分「业务域名」和「JS接口安全域名」以及「IP白名单」，三者在2026年的微信后台机制中分工明确,容易混淆的人不在少数。

• 业务域名：控制的是微信内置浏览器（WebView）允许访问的域名范围。
• JS接口安全域名：控制的是哪些域名可以调用微信JS-SDK，比如分享到朋友圈、扫码、调起支付组件。
• IP白名单：控制的是哪些服务器IP能用你公众号的access_token调接口。

现在微信公众平台后台已经把「域名白名单」这个概念整合进了「安全中心」，操作入口压得更深了一些,但逻辑没变。

为什么有人不需要设置，有人必须设置

这个问题的答案取决于你的业务形态。

如果你只是用公众号发文章、做客服消息，纯手工操作后台，基本不会碰到域名白名单这个词，但如果你有一个独立站点，要在H5页面上引导用户用微信授权登录，或者历史消息页要跳转到你自己的页面，那就必须设置，不设置直接报错 invalid domain,前端接口全部失效。

微信公众号域名白名单设置教程里绕不开的场景分为几类：

1. PC端网页管理后台需要调用微信扫码登录
2. 移动端H5使用了微信JS-SDK能力（自定义分享、支付、定位等）
3. 服务器端需要调取用户unionid、发送模板消息
4. 小程序后台配置合法请求域名（逻辑一致,入口不同）

多数情况下，个人开发者容易遗漏第三个场景，认为页面上能打开就没问题,结果后端一调access_token接口就提示ip不在白名单。

微信域名白名单设置步骤详解

进入后台的方式有几种，但主路径是固定的，以2026年公众平台最新UI为基准,操作步骤如下。

第一步：确认账号类型

域名白名单功能对账号类型有要求。

• 订阅号（个人主体）：只开放部分基础接口，域名白名单入口存在，但能配置的域名数量少，仅支持5个
• 服务号（企业主体）：完整开放，支持配置的域名数量最多，可达100个
• 微信认证账号：接口权限进一步扩充，域名校验更严格，需要下载校验文件

如果你搞不清自己是哪种账号，登进后台看首页左侧菜单，服务号会有「接口权限」这个完整模块，订阅号没有，个人订阅号其实大部分场景用不上域名白名单,除非你接了第三方平台做跳转。

第二步：登录后台找到入口

在电脑浏览器打开微信公众平台官网，扫码登录，注意这里说的「域名白名单设置入口」在2026年做过一次界面改版，旧教程里说的「开发-接口权限-修改」路径已经不适用。

正确路径是：

• 左侧菜单最底部找到「设置与开发」
• 展开后点击「安全中心」
• 页面渲染后，往下滑能看到「域名白名单」卡片
• 点击「查看」按钮进入配置面板

如果左侧菜单没有「安全中心」选项，大概率你的公众号还没有完成微信认证，未认证的账号在2026年已关闭大部分域名配置权限,先去走认证流程。

第三步：填写域名信息

进入配置面板后，你会看到一个文本框和一行小字「格式：example.com、sns.example.com，多个域名用换行分隔」，这里有几个容易踩坑的点,逐一说明。

• 不带协议头：https:// 和 http:// 都不能填，微信会自动补全协议
• 不带路径：填到顶级域名或二级域名为止
• 支持通配符：在域名前加 代表子域名全授权，仅支持一级通配

如果你的站点跑在 www.example.com，建议直接填 example.com，这样 m.example.com、api.example.com 等子域都覆盖到了，微信后台在这个环节会校验域名是否可访问，要求你在服务器根目录放一个微信提供的校验文件 MP_verify_xxxxxx.txt。

这个步骤是卡住最多人的地方。

具体操作：

1. 不用关闭配置面板，新开一个浏览器标签页
2. 登录你的服务器或虚拟主机面板，打开网站根目录
3. 新建一个txt文件，文件名改成微信显示的完整文件名，内容填入微信给出的那一串校验码
4. 保存后用浏览器访问 http://你的域名/文件名.txt，能看到内容即生效
5. 回到微信后台，点击「保存」按钮

第四步：等待生效并验证

保存成功后，微信会提示「配置已生效」，大多数情况下，接口调用会在5分钟内恢复正常，如果5分钟后依然报错，最常见的原因是本地DNS缓存没有刷新，你可以尝试用手机流量访问接口测试,绕过本地网络环境。

如何正确设置IP白名单

很多人分不清域名白名单和IP白名单的区别，这两个设置会在同一个后台页面出现，你可能遇到的问题是域名配对了，接口依然报错,那问题多半出在IP白名单上。

微信在2026年对IP白名单的管控力度有所加强，未配置IP白名单的开发者账号，在调用access_token时直接返回错误码40164，IP白名单用来识别你的服务器，填写格式是标准的IPv4地址，0.113.10。

获取自己服务器公网IP的方法也很简单,登录服务器终端执行命令：

curl ifconfig.me

返回的IP就是你要填的内容，如果你使用的是负载均衡或多区域部署，需要把每个出口IP都填进去，一共可以填最多31个IP。

填完保存后，微信会提示需要管理员扫码确认，这个二次确认机制是2026年新增的，扫码的人必须是公众号管理员本人,运营者权限无法通过。

微信域名白名单和业务域名的区别

后台「安全中心」里的域名白名单，和「公众号设置-功能设置-业务域名」不是同一个东西,这个要分清。

业内专家指出，业务域名的主要作用是消灭微信内置浏览器底部“非官方页面”的提示，让用户点进你的H5时不会看到安全警告，2026年的微信版本已经强化了这个提示频率，不配置业务域名的页面在微信里打开时，页面底部会常驻一条灰色警示条,非常影响转化率。

业务域名配置时同样需要域名校验文件，但它在微信后台可以设置三个域名，每个域名分类填写对应的校验文件，注意业务域名使用的是不同校验文件，不要和IP白名单混淆，别把MP_verify_A.txt当作MP_verify_B.txt使用。

如果你要做一个完整的微信生态站点，两个地方都需要配置,不能只设置其中一个。

业务域名配置操作路径

• 公众号后台 → 设置与开发 → 公众号设置 → 功能设置
• 找到业务域名 → 点击修改
• 填写域名 → 下载校验文件 → 放置根目录 → 回后台确认保存

本地开发环境怎么设置

开发阶段，你的代码跑在localhost或局域网IP上，这类域名微信没法直接授权，2026年微信开发者工具内置了域名校验的模拟功能,新手常忽略这个入口。

在微信开发者工具中：

• 点击右上角「详情」
• 选择「本地设置」
• 勾选「不校验合法域名、web-view（业务域名）、TLS版本以及HTTPS证书」

勾选后，本地开发环境就能绕过域名白名单的限制，正常调试微信JS-SDK接口，这个设置仅对工具内的模拟环境有效,真机预览时仍然会校验。

真机调试方案：如果你需要在真机上直接调用微信JS-SDK，把代码部署到测试服务器，用临时域名加白名单校验即可，微信后台支持随时修改、删除、替换域名配置,开发频次高的人可以重复操作。

配置完成后常见报错排查

虽然流程不复杂，但无数人在设置完以后仍然遇到各种怪问题，整理几个高频异常场景,遇到可以直接对照解决。

报错提示「url 域名不在白名单」

这个错误提示直白到不需要解释,排查步骤是：

1. 回到安全中心，检查域名是否有拼写错误（下划线、空格最常见）
2. 检查是否填了协议头或路径，微信不接受
3. 如果是子域名调用，父域名没有通配，也会报这个错
4. 域名解析是否生效，用 ping 命令试一下

报错提示「config:invalid signature」

签名错误不代表白名单有问题，它和白名单是独立的两个校验维度，签名生成时用到的 jsapi_ticket 时效只有7200秒，过期会导致签名变成旧值，重新获取后再生成签名即可解决，这个报错与域名白名单无直接关联,但初学者容易误判。

配置了白名单但接口依然403

域名明文没问题，那看看是不是服务端调用凭证没有刷新，access_token有效期也是7200秒，你之前获取的token在你配置白名单之前生成，微信服务端校验的是token创建时刻的域名上下文，去重新获取一遍,基本能解决。

2026年在配域名时要注意的新变化

微信官方在2026年底调整过一次安全策略,2026年执行层面有些细节值得留意。

• 域名数量收紧：个人主体订阅号历史可配置的域名数量已减少至5个，企业服务号维持100个
• HTTPS强制校验：2026年起，新配置的域名必须支持HTTPS，不支持HTTP的纯裸域名无法通过校验
• 扫描确认行为常态化：任何域名白名单的增删改，都会要求管理员微信扫码确认，账号共享给多人管理的团队要提前协调好

如果你是为区域连锁门店做微信网页应用，需要考虑每个门店的二级域名统一添加到白名单中，用通配符最省事，微信允许 .yourcompany.com 这种形式。

设置前先想清楚的一件事

域名白名单不是一次性配置就完事，后续换服务器、换域名、新增子站，都要回后台同步更新，比较稳妥的做法是把所有域名记录在案，包括已废弃的,避免误删后旧链接全部失效。

这类操作不需要代码能力，纯后台配置，你的网站、H5页面、小程序后端都能共用一套域名配置逻辑。

最后的操作总结

整个操作概括成一句话：用管理员微信登录公众平台，从「设置与开发-安全中心」进入域名白名单，填上你的根域名，下载校验文件放到网站根目录，保存即可。

如果你只是想快速跑通JS-SDK的分享功能，按本文第二步到第四步走完，总共耗时不超过十五分钟，过了校验,微信生态的大门就打开了。

Q&A

微信域名白名单设置教程中的校验文件下载后放在哪里

放在网站根目录，也就是wwwroot或public_html目录下直接可访问的路径，如果是thinkphp或laravel框架搭建的站点，不要放进public里，要放在真正指向域名的入口目录，校验完成后，这个文件可以删除,不影响白名单状态。

个人主体订阅号能配置微信域名白名单吗

可以配置，但个人主体订阅号在2026年可用接口权限较窄，白名单入口开放但仅支持5个域名，且要求全部为HTTPS协议，涉及支付类接口依然无法开通，如果你规划的业务需要收款功能,建议直接注册企业主体服务号。

一个域名能否同时用于多个微信公众号的域名白名单

可以，微信不限制多个公众号配置同一个域名，但每个公众号都需要单独放置各自的校验文件，文件名不同，内容不同,不能混用。