Back to Chats
微信公众号 API 代理设置指南
Summary
🔧 微信公众号 API 代理设置指南
由于微信公众号 API 强制要求 IP 白名单验证，而本地电脑通常使用动态 IP 或 VPN，这会导致请求被微信拦截。可以通过部署一个代理服务来解决此问题，利用相对固定的服务器出口 IP 进行白名单配置。
目前提供两种代理部署方案：如果你没有自己的服务器，推荐使用 方案一：Cloudflare Worker；如果你有配置好环境的服务器，可以选择 方案二：PHP 服务器。
方案一：Cloudflare Worker (推荐)
免费且无需维护自己的服务器，适合大多数用户。
第一步：创建 Cloudflare Worker
- 登录 Cloudflare Dashboard。
- 在左侧菜单选择 Workers & Pages → Create Application → Create Worker。
- 为服务命名（建议命名为
wechat-proxy），点击 Deploy 部署初始版本。
第二步：编辑 Worker 代码
请前往 微信公众号 API 代理配置指南 页面，点击复制 Cloudflare Worker 方案的完整代理代码。
回到 Cloudflare 仪表盘，点击 Edit code 进入代码编辑器，删除所有原有代码，粘贴复制的代码。
点击 Deploy 保存并发布。
第三步：配置微信 IP 白名单
你需要将 Cloudflare 的出口 IP 添加到微信公众号后台。
- 登录 微信公众号平台。
- 进入 基本配置 → IP白名单 → 修改。
- 复制以下 IP 列表，粘贴到输入框中并保存：
173.245.48.0/20
103.21.244.0/22
103.22.200.0/22
103.31.4.0/22
141.101.64.0/18
108.162.192.0/18
190.93.240.0/20
188.114.96.0/20
197.234.240.0/22
198.41.128.0/17
162.158.0.0/15
104.16.0.0/13
104.24.0.0/14
172.64.0.0/13
131.0.72.0/22
⚠️ 提示：Cloudflare 的 IP 列表可能会偶发变动，若出现连接问题，请查阅 Cloudflare 官方 IP 列表。 官方页面同时包含 IPv4 和 IPv6 列表，请仅复制 IPv4 列表。
方案二：PHP 服务器
如果你已经有一台配置好的服务器（或者是虚拟主机），你可以直接使用这段 PHP 代码进行部署。
第一步：准备 PHP 环境
- 确保你的服务器已经安装了 PHP 8.0 或以上版本。
- 确认启用了 PHP cURL 扩展。
- 服务器的公网 IP 必须是固定的，或者是你能够绑定到微信公众平台白名单中的 IP。
第二步：部署代理代码
在你的网站目录下创建一个 wechat-proxy.php 文件。
请前往 微信公众号 API 代理配置指南 页面，点击复制 PHP 服务器 方案的完整代码，粘贴到你创建好的文件中保存并完成发布。
第三步：配置微信 IP 白名单
- 登录 微信公众号平台。
- 进入 基本配置 → IP白名单 → 修改。
- 填入你部署该 PHP 文件的服务器的出口 IP，并保存。
插件设置（通用）
- 打开 Obsidian，进入本插件设置页。
- 找到 高级设置 (Advanced Settings)。
- 在 API 代理地址 中填入你的代理 URL：
- 若选择方案一，例如：
https://wechat-proxy.your-name.workers.dev - 若选择方案二，例如：
https://your-domain.com/wechat-proxy.php
- 若选择方案一，例如：