MeowMusicServer/快速开始.md

🚀 快速开始 - 3分钟部署指南

📦 准备工作

1. 确认 Go 已安装

打开终端，输入：

go version

✅ 看到版本号（如 go version go1.21.x）- 已安装，继续下一步
❌ 提示未找到命令 - 需要先安装Go

安装 Go：

• Windows: https://golang.org/dl/ (下载安装包)
• macOS: brew install go
• Linux: sudo apt install golang-go

---

🎯 三步部署

Windows 用户

第一步：打开项目目录

cd d:\esp32-music-server\Meow\MeowEmbeddedMusicServer

第二步：双击启动

找到 start.bat 文件，双击运行

第三步：访问应用

浏览器打开：http://localhost:2233/app

就这么简单！ 🎉

---

Linux / macOS 用户

第一步：进入项目目录

cd /path/to/MeowEmbeddedMusicServer

第二步：添加执行权限并启动

chmod +x start.sh
./start.sh

第三步：访问应用

浏览器打开：http://localhost:2233/app

完成！ 🎉

---

🎵 首次使用

1. 注册账户

   • 访问 http://localhost:2233/app
   • 点击右侧"注册"标签
   • 填写：用户名、邮箱、密码
   • 点击"注册"按钮

2. 搜索音乐

   • 登录后，在搜索框输入歌曲名
   • 例如："告白气球"
   • 点击"搜索"

3. 播放音乐

   • 搜索结果出现后
   • 点击"▶ 播放"按钮

4. 添加收藏

   • 在搜索结果页
   • 使用下拉菜单选择"我喜欢"
   • 歌曲自动添加到收藏

5. 创建歌单

   • 左侧边栏"我的歌单"旁
   • 点击"+"号
   • 输入歌单名称
   • 确认创建

---

🔧 常见问题

Q: 端口被占用怎么办？

Windows:

netstat -ano | findstr :2233
taskkill /PID <进程ID> /F

Linux/macOS:

lsof -i :2233
kill -9 <PID>

或修改端口：编辑 .env 文件，将 PORT=2233 改为 PORT=3000

---

Q: 依赖下载失败？

中国大陆用户需要配置Go代理：

go env -w GOPROXY=https://goproxy.cn,direct

然后重新运行启动脚本

---

Q: 如何停止服务器？

在启动的终端窗口中按 Ctrl + C

---

Q: 如何让局域网其他设备访问？

1. 找到本机IP（Windows: ipconfig，Linux/Mac: ifconfig）
2. 修改 .env 文件：

   WEBSITE_URL=http://你的IP:2233
   

3. 重启服务器
4. 其他设备访问：http://你的IP:2233/app

---

📚 更多文档

• 详细部署指南: 查看 本地部署指南.md
• API文档: 查看 USER_SYSTEM_README.md
• 功能说明: 查看 新功能说明.md

---

💡 使用技巧

快捷键

• 搜索框按 Enter 键可以快速搜索
• Ctrl + C 停止服务器

推荐浏览器

• Chrome / Edge
• Firefox
• Safari

数据备份

定期备份 files/ 目录，保存用户数据和歌单

---

🎯 目录结构

MeowEmbeddedMusicServer/
├── start.bat              ← Windows启动（双击）
├── start.sh               ← Linux/Mac启动
├── .env                   ← 配置文件（可选）
├── theme/
│   └── music-app.html     ← 新版界面
└── files/                 ← 数据存储（自动创建）
    ├── users.json         ← 用户数据
    └── user_playlists.json ← 歌单数据

---

✅ 快速检查清单

部署前：

• Go 已安装（1.19+）
• 项目已下载到本地
• 端口 2233 未被占用

部署后：

• 启动脚本运行成功
• 浏览器可以打开 http://localhost:2233/app
• 可以注册新账户
• 可以搜索音乐

全部打勾 = 部署成功！🎉

---

🆘 需要帮助？

查看日志

启动后的终端窗口会显示所有日志信息

社区支持

• QQ群：865754861（喵波音律-音乐家园）
• 查看详细文档：本地部署指南.md

重新开始

如果遇到问题，可以：

1. 关闭服务器（Ctrl+C）
2. 删除 files/ 目录
3. 重新运行启动脚本

---

🎉 恭喜！

你现在拥有一个属于自己的音乐服务器了！

开始享受音乐吧！ 🎵✨

    ╔═══════════════════════════════════╗
    ║  新版应用地址                      ║
    ║  http://localhost:2233/app        ║
    ╚═══════════════════════════════════╝

下一步：

1. 🎵 搜索你喜欢的音乐
2. ❤️ 创建你的收藏歌单
3. 📱 让朋友也来试试（局域网访问）