# ESP32服务器地址配置指南

## 📍 **配置文件位置**

```
xiaozhi-esp32_music/main/server_config.h
```

## 🔧 **如何修改服务器地址**

### **步骤1：查看您的服务器IP地址**

#### **Windows系统**
打开命令提示符（CMD），输入：
```cmd
ipconfig
```

查找"IPv4 地址"，例如：`192.168.1.100`

#### **Linux/Mac系统**
打开终端，输入：
```bash
ifconfig
# 或
ip addr
```

查找局域网IP地址。

---

### **步骤2：编辑配置文件**

打开文件：
```
d:\esp32-music-server\Meow\MeowEmbeddedMusicServer\xiaozhi-esp32_music\xiaozhi-esp32_music\main\server_config.h
```

找到这一行：
```cpp
#define MUSIC_SERVER_URL "http://192.168.1.100:2233"
```

将 `192.168.1.100` 替换为您的服务器IP地址。

---

## 🌐 **配置示例**

### **示例1：本地局域网（推荐）**

服务器和ESP32在同一个WiFi网络中：

```cpp
#define MUSIC_SERVER_URL "http://192.168.1.100:2233"
```

**优点**：
- ✅ 速度快
- ✅ 延迟低
- ✅ 不需要公网IP

---

### **示例2：公网IP**

如果您有公网IP或使用花生壳等内网穿透：

```cpp
#define MUSIC_SERVER_URL "http://123.45.67.89:2233"
```

**注意**：
- ⚠️ 确保路由器端口转发2233端口
- ⚠️ 注意服务器安全

---

### **示例3：域名**

如果您有域名：

```cpp
#define MUSIC_SERVER_URL "http://your-music-server.com:2233"
```

**注意**：
- ⚠️ 确保域名解析正确
- ⚠️ 如果使用HTTPS，改为`https://`

---

### **示例4：使用原作者在线服务器**

```cpp
#define MUSIC_SERVER_URL "http://http-embedded-music.miao-lab.top:2233"
```

**说明**：
- ✅ 无需自己搭建服务器
- ⚠️ 依赖外部服务可用性
- ⚠️ 无法使用设备绑定等个性化功能

---

## 🔍 **如何测试服务器地址是否正确**

### **方法1：浏览器测试**

在浏览器中访问：
```
http://您的服务器IP:2233
```

应该看到Meow Music的Web界面。

---

### **方法2：curl测试**

```bash
curl http://您的服务器IP:2233/api/search?song=江南
```

应该返回JSON格式的搜索结果。

---

## 📝 **完整配置检查清单**

- [ ] 确认服务器正在运行（`go run .`）
- [ ] 确认服务器端口是2233
- [ ] 确认ESP32和服务器在同一网络（或有公网连接）
- [ ] 修改`server_config.h`中的IP地址
- [ ] 保存文件
- [ ] 重新编译ESP32固件（`idf.py build`）
- [ ] 烧录到ESP32（`idf.py flash`）
- [ ] 测试连接

---

## 🐛 **常见问题**

### **问题1：ESP32无法连接服务器**

**现象**：
```
[Esp32Music] Failed to connect to music API
```

**排查**：
1. 检查服务器是否运行
2. 检查IP地址是否正确
3. 检查ESP32是否连接WiFi
4. Ping服务器IP测试网络连通性

---

### **问题2：地址写错了**

**现象**：
```
[Esp32Music] HTTP GET failed with status code: 404
```

**解决**：
- 检查URL格式是否正确
- 确保有`http://`前缀
- 确保端口号是`:2233`

---

### **问题3：防火墙阻止**

**现象**：
- ESP32无法连接
- 但浏览器可以访问

**解决（Windows）**：
```
控制面板 → Windows防火墙 → 允许应用通过防火墙
→ 找到Go程序 → 允许专用和公用网络
```

---

## 🎯 **推荐配置**

### **开发测试阶段**

使用局域网IP：
```cpp
#define MUSIC_SERVER_URL "http://192.168.1.100:2233"
```

### **生产环境**

使用域名：
```cpp
#define MUSIC_SERVER_URL "http://music.your-domain.com:2233"
```

---

## 💡 **高级技巧**

### **使用环境变量（未来功能）**

可以考虑在ESP32端添加NVS配置，通过Web界面修改服务器地址，无需重新编译。

### **mDNS服务发现（未来功能）**

可以使用mDNS实现服务器自动发现：
```
http://meow-music.local:2233
```

---

## 📞 **技术支持**

如有问题，请加入：
**喵波音律QQ交流群：865754861**

---

**配置完成后，记得重新编译并烧录固件！** 🚀