4.1 KiB
4.1 KiB
ESP32服务器地址配置指南
📍 配置文件位置
xiaozhi-esp32_music/main/server_config.h
🔧 如何修改服务器地址
步骤1：查看您的服务器IP地址
Windows系统
打开命令提示符（CMD），输入：
ipconfig
查找"IPv4 地址"，例如：192.168.1.100
Linux/Mac系统
打开终端，输入：
ifconfig
# 或
ip addr
查找局域网IP地址。
步骤2：编辑配置文件
打开文件：
d:\esp32-music-server\Meow\MeowEmbeddedMusicServer\xiaozhi-esp32_music\xiaozhi-esp32_music\main\server_config.h
找到这一行：
#define MUSIC_SERVER_URL "http://192.168.1.100:2233"
将 192.168.1.100 替换为您的服务器IP地址。
🌐 配置示例
示例1：本地局域网（推荐）
服务器和ESP32在同一个WiFi网络中：
#define MUSIC_SERVER_URL "http://192.168.1.100:2233"
优点：
- ✅ 速度快
- ✅ 延迟低
- ✅ 不需要公网IP
示例2：公网IP
如果您有公网IP或使用花生壳等内网穿透：
#define MUSIC_SERVER_URL "http://123.45.67.89:2233"
注意：
- ⚠️ 确保路由器端口转发2233端口
- ⚠️ 注意服务器安全
示例3：域名
如果您有域名：
#define MUSIC_SERVER_URL "http://your-music-server.com:2233"
注意：
- ⚠️ 确保域名解析正确
- ⚠️ 如果使用HTTPS，改为
https://
示例4：使用原作者在线服务器
#define MUSIC_SERVER_URL "http://http-embedded-music.miao-lab.top:2233"
说明：
- ✅ 无需自己搭建服务器
- ⚠️ 依赖外部服务可用性
- ⚠️ 无法使用设备绑定等个性化功能
🔍 如何测试服务器地址是否正确
方法1：浏览器测试
在浏览器中访问：
http://您的服务器IP:2233
应该看到Meow Music的Web界面。
方法2：curl测试
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
排查：
- 检查服务器是否运行
- 检查IP地址是否正确
- 检查ESP32是否连接WiFi
- Ping服务器IP测试网络连通性
问题2：地址写错了
现象：
[Esp32Music] HTTP GET failed with status code: 404
解决：
- 检查URL格式是否正确
- 确保有
http://前缀 - 确保端口号是
:2233
问题3：防火墙阻止
现象：
- ESP32无法连接
- 但浏览器可以访问
解决（Windows）：
控制面板 → Windows防火墙 → 允许应用通过防火墙
→ 找到Go程序 → 允许专用和公用网络
🎯 推荐配置
开发测试阶段
使用局域网IP：
#define MUSIC_SERVER_URL "http://192.168.1.100:2233"
生产环境
使用域名：
#define MUSIC_SERVER_URL "http://music.your-domain.com:2233"
💡 高级技巧
使用环境变量（未来功能）
可以考虑在ESP32端添加NVS配置，通过Web界面修改服务器地址，无需重新编译。
mDNS服务发现（未来功能）
可以使用mDNS实现服务器自动发现：
http://meow-music.local:2233
📞 技术支持
如有问题，请加入： 喵波音律QQ交流群：865754861
配置完成后，记得重新编译并烧录固件！ 🚀