微信 IP 白名单

什么时候需要

只有微信副作用接口（素材上传、草稿创建、图片消息）会校验调用方 IP 是否在平台白名单内。Convert API 不是微信副作用，永远不需要白名单。

典型报错

ip xxx.xxx.xxx.xxx not in whitelist

添加出口 IP

1. 查询运行 CLI 机器的出口 IP：

curl ifconfig.me

2. 在微信公众平台「开发接口管理 → IP 白名单」里加入该 IP。
3. 等待 1-5 分钟生效。

动态 IP 与 CI

• 家庭/办公宽带的公网 IP 经常轮换，今天可用的条目明天可能失效。
• CI（如 GitHub Actions）每次运行使用新的出口网段，无法依赖静态白名单。

固定出口（付费）

配置固定出口，让所有微信副作用调用从同一稳定 IP 发出：

wechat:
  proxy_url: http://user:pass@host:port

• 也可用环境变量 WECHAT_PROXY_URL；仅支持 http/https，端口 1-65535。
• 代理只作用于微信副作用（upload、draft add、newspic），不影响 Convert API、图片供应商、discovery 与 preview。
• 启用代理需要有效 MD2WECHAT_API_KEY，副作用前经 HEAD /api/auth/validate 校验。
• md2wechat config show 始终对代理密码打码。

相关页面

• Auth
• 发布 API
• 多账号发布