1.9 KiB
1.9 KiB
企业微信IP白名单配置指南
问题现象
同步企业微信客户时报错：
errcode: 60020
errmsg: not allow to access from your ip
问题原因
企业微信API有IP白名单限制，只有在白名单中的IP才能调用API。
解决方法
1. 获取服务器IP地址
在服务器上运行以下命令获取公网IP：
curl ifconfig.me
或者查看日志中的IP地址，例如：
from ip: 8.219.70.152
2. 配置企业微信IP白名单
- 登录企业微信管理后台：https://work.weixin.qq.com/
- 进入"应用管理"
- 选择你配置的应用（使用该应用的Secret）
- 找到"企业可信IP"设置
- 点击"配置"或"修改"
- 添加服务器的公网IP地址
- 保存配置
3. 验证配置
配置完成后，等待几分钟让配置生效，然后重新运行同步命令：
php think qywx:sync-customer --force
注意事项
-
IP地址格式：
- 单个IP：
8.219.70.152 - IP段：
8.219.70.0/24
- 单个IP：
-
多个IP：如果有多个服务器，需要添加所有服务器的IP
-
动态IP：如果服务器IP会变化，建议：
- 使用固定IP的服务器
- 或配置IP段
- 或使用代理服务器
-
测试环境：开发环境和生产环境可能有不同的IP，都需要添加
常见问题
Q: 添加IP后还是报错？
A: 等待5-10分钟让配置生效，清除缓存后重试：
php think clear
php think qywx:sync-customer --force
Q: 不知道服务器IP？
A: 在服务器上运行：
curl ifconfig.me
# 或
curl ip.sb
# 或
curl ipinfo.io/ip
Q: 本地开发如何测试？
A: 将本地公网IP也添加到白名单，或使用内网穿透工具（如ngrok）