微信公众号域名配置指南

# 微信公众号域名配置指南

> 本文档说明如何在宝塔面板配置反向代理，绑定自定义域名用于微信公众号开发测试。

## 背景

由于FutureBirdAadminAi沙箱域名被微信屏蔽，需要通过反向代理绑定自己的域名才能在微信中使用。

## 前提条件

- ✅ 有自己的域名
- ✅ 有安装宝塔面板的服务器
- ✅ 域名已解析到服务器 IP

## 一、宝塔面板配置反向代理

### 1.1 添加网站

1. 登录宝塔面板
2. 点击左侧菜单 **网站** → **添加站点**
3. 填写配置：

| 配置项 | 值 |
|--------|-----|
| 域名 | 你的域名（如 `weixin.example.com`） |
| PHP版本 | 纯静态 |
| 数据库 | 不创建 |

4. 点击 **提交**

### 1.2 配置反向代理

1. 点击刚添加的网站名称，进入站点设置
2. 点击左侧 **反向代理** 选项卡
3. 点击 **添加反向代理**
4. 填写配置：

| 配置项 | 值 |
|--------|-----|
| 代理名称 | `wechat-proxy` |
| 目标URL | `https://50152300-70a2-4d03-8e14-81c025a9710b.dev.FutureBirdAadminAi.site` |
| 发送域名 | `$host` |

### 1.3 高级配置（重要）

点击 **自定义配置**，替换为以下内容：

```nginx
#PROXY-START/
location /
{
    proxy_pass https://50152300-70a2-4d03-8e14-81c025a9710b.dev.FutureBirdAadminAi.site;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header REMOTE-HOST $remote_addr;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    
    # 关键：解决 SSL 问题
    proxy_ssl_server_name on;
    proxy_ssl_protocols TLSv1.2 TLSv1.3;
    
    # 超时设置
    proxy_connect_timeout 60s;
    proxy_read_timeout 60s;
    proxy_send_timeout 60s;
    
    # 缓存设置
    proxy_buffering off;
}
#PROXY-END/
```

### 1.4 申请 SSL 证书

1. 在站点设置中点击 **SSL** 选项卡
2. 选择 **Let's Encrypt**
3. 勾选域名，点击 **申请**
4. 申请成功后，开启 **强制HTTPS**

## 二、验证配置

### 2.1 浏览器测试

访问 `https://你的域名`，应该能看到系统登录页面。

### 2.2 接口测试

```bash
# 测试微信验证接口
curl -s "https://你的域名/api/wechat/message?signature=test&timestamp=123&nonce=456&echostr=hello"
```

## 三、更新微信配置

### 3.1 微信公众平台后台

1. 登录 [微信公众平台](https://mp.weixin.qq.com)
2. 进入 **开发** → **基本配置**
3. 修改 **服务器配置**：

| 配置项 | 值 |
|--------|-----|
| URL | `https://你的域名/api/wechat/message` |
| Token | `2f4d7f12607bb00cb2d1542925a5ac71` |
| EncodingAESKey | 随机生成 |
| 消息加解密方式 | 明文模式 |

### 3.2 网页授权域名

1. 进入 **公众号设置** → **功能设置**
2. 配置 **网页授权域名**：`你的域名`（不带 https://）

### 3.3 更新系统配置

在系统后台 **微信公众号管理** 页面更新：

| 配置项 | 值 |
|--------|-----|
| 服务器URL | `https://你的域名/api/wechat/mp/callback` |

## 四、常见问题

### Q1: 502 Bad Gateway

**原因**：代理目标无法访问或 SSL 配置问题

**解决**：
- 确保添加了 `proxy_ssl_server_name on;`
- 检查服务器是否能访问外网

### Q2: 微信验证失败

**原因**：Token 不一致

**解决**：
- 确保微信后台和系统配置的 Token 一致
- 当前系统 Token: `2f4d7f12607bb00cb2d1542925a5ac71`

### Q3: 网页授权域名验证失败

**原因**：域名未正确解析或 SSL 证书问题

**解决**：
- 确认域名 A 记录指向服务器 IP
- 确认 SSL 证书已正确安装

## 五、配置信息汇总

### 沙箱原始地址
```
https://50152300-70a2-4d03-8e14-81c025a9710b.dev.FutureBirdAadminAi.site
```

### 微信测试号信息
| 配置项 | 值 |
|--------|-----|
| AppID | `wx88e32e86f8bb9ecd` |
| AppSecret | `4b3fbbce20dcf16f42e842fedeb5602d` |
| Token | `2f4d7f12607bb00cb2d1542925a5ac71` |

### 接口路径
| 接口 | 路径 |
|------|------|
| 消息验证 | `/api/wechat/message` |
| OAuth回调 | `/api/wechat/mp/callback` |
| 员工端入口 | `/employee/wechat-mp` |

---

## 配置完成后

请告知你的域名，我们可以：
1. 验证反向代理是否正常工作
2. 测试微信服务器配置是否成功
3. 测试微信登录功能

---

*文档创建时间：2026-02-25*