feat ：init

docs/CENTOS_DEVELOPMENT.md

@@ -0,0 +1,309 @@
+# 小智ESP32服务器CentOS部署文档
+
+## 系统要求
+
+- CentOS 7/8（推荐CentOS 8）
+- 最小化安装 + 开发工具（gcc, make等）
+- 至少2GB内存（推荐4GB）
+- 至少10GB磁盘空间
+
+## 1. 环境准备
+
+### 1.1 安装基础工具
+
+```bash
+sudo yum install -y epel-release
+sudo yum install -y wget curl git vim unzip
+```
+
+### 1.2 配置防火墙
+
+```bash
+sudo firewall-cmd --permanent --add-port=8084/tcp
+sudo firewall-cmd --permanent --add-port=8091/tcp
+sudo firewall-cmd --permanent --add-port=3306/tcp
+sudo firewall-cmd --reload
+```
+
+## 2. 安装Java JDK 8
+
+```bash
+sudo yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel
+```
+
+验证安装：
+
+```bash
+java -version
+```
+
+## 3. 安装MySQL 5.7
+
+```bash
+sudo yum localinstall -y https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm
+sudo yum install -y mysql-community-server
+```
+
+启动MySQL服务：
+
+```bash
+sudo systemctl start mysqld
+sudo systemctl enable mysqld
+```
+
+获取临时密码：
+
+```bash
+sudo grep 'temporary password' /var/log/mysqld.log
+```
+
+安全设置：
+
+```bash
+sudo mysql_secure_installation
+```
+
+## 4. 安装Maven
+
+```bash
+sudo yum install -y maven
+```
+
+验证安装：
+
+```bash
+mvn -v
+```
+
+## 5. 安装Node.js 16
+
+```bash
+curl -sL https://rpm.nodesource.com/setup_16.x | sudo bash -
+sudo yum install -y nodejs
+```
+
+验证安装：
+
+```bash
+node -v
+npm -v
+```
+
+## 6. 安装FFmpeg
+
+```bash
+sudo yum install -y ffmpeg ffmpeg-devel
+```
+
+验证安装：
+
+```bash
+ffmpeg -version
+```
+
+## 7. 数据库配置
+
+创建数据库和用户：
+
+```sql
+mysql -u root -p
+CREATE DATABASE xiaozhi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+CREATE USER 'xiaozhi'@'localhost' IDENTIFIED BY '123456';
+GRANT ALL PRIVILEGES ON xiaozhi.* TO 'xiaozhi'@'localhost';
+FLUSH PRIVILEGES;
+exit
+```
+
+导入初始化脚本：
+
+```bash
+mysql -u root -p xiaozhi < db/init.sql
+```
+
+## 8. 下载Vosk语音识别模型
+
+```bash
+wget https://alphacephei.com/vosk/models/vosk-model-cn-0.22.zip
+unzip vosk-model-cn-0.22.zip
+mkdir -p models
+mv vosk-model-cn-0.22 models/vosk-model
+```
+
+## 9. 项目部署
+
+### 9.1 克隆项目
+
+```bash
+git clone https://github.com/joey-zhou/xiaozhi-esp32-server-java
+cd xiaozhi-esp32-server-java
+```
+
+### 9.2 后端部署
+
+```bash
+mvn clean package -DskipTests
+java -jar target/xiaozhi.server-1.0.jar &
+```
+
+### 9.3 前端部署
+
+```bash
+cd web
+npm install
+npm run build
+```
+
+## 10. 配置系统服务（可选）
+
+### 10.1 创建后端服务
+
+编辑服务文件：
+
+```bash
+sudo vim /etc/systemd/system/xiaozhi.service
+```
+
+添加内容：
+
+```
+[Unit]
+Description=Xiaozhi ESP32 Server
+After=syslog.target network.target
+
+[Service]
+User=root
+WorkingDirectory=/path/to/xiaozhi-esp32-server-java
+ExecStart=/usr/bin/java -jar target/xiaozhi.server-1.0.jar
+SuccessExitStatus=143
+Restart=always
+RestartSec=10
+
+[Install]
+WantedBy=multi-user.target
+```
+
+启动服务：
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl start xiaozhi
+sudo systemctl enable xiaozhi
+```
+
+### 10.2 配置Nginx（可选）
+
+```bash
+sudo yum install -y nginx
+sudo vim /etc/nginx/conf.d/xiaozhi.conf
+```
+
+添加配置：
+
+```
+server {
+    listen 80;
+    server_name your_domain_or_ip;
+
+    location / {
+        root /path/to/xiaozhi-esp32-server-java/web/dist;
+        try_files $uri $uri/ /index.html;
+    }
+
+    location /api {
+        proxy_pass http://localhost:8091;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+启动Nginx：
+
+```bash
+sudo systemctl start nginx
+sudo systemctl enable nginx
+```
+
+## 11. 访问系统
+
+- 直接访问：`http://your_server_ip:8084`
+- 如果配置了Nginx：`http://your_domain_or_ip`
+- 默认管理员账号：admin/123456
+
+## 常见问题解决
+
+1. **MySQL初始化失败**
+
+   ```bash
+   sudo systemctl restart mysqld
+   mysql_upgrade -u root -p
+   ```
+
+2. **端口冲突**
+
+   ```bash
+   netstat -tulnp | grep 8084
+   kill -9 <PID>
+   ```
+
+3. **Node.js版本问题**
+
+   ```bash
+   sudo yum remove -y nodejs npm
+   curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -
+   sudo yum install -y nodejs
+   ```
+
+4. **内存不足**
+
+   增加swap空间：
+
+   ```bash
+   sudo dd if=/dev/zero of=/swapfile bs=1M count=2048
+   sudo mkswap /swapfile
+   sudo swapon /swapfile
+   echo '/swapfile swap swap defaults 0 0' | sudo tee -a /etc/fstab
+   ```
+
+5. **Vosk模型加载失败**
+
+   ```bash
+   chmod -R 755 models
+   ```
+
+## 维护命令
+
+- 查看后端日志：
+
+  ```bash
+  journalctl -u xiaozhi -f
+  ```
+
+- 更新代码：
+
+  ```bash
+  git pull origin master
+  mvn clean package -DskipTests
+  sudo systemctl restart xiaozhi
+  ```
+
+- 数据库备份：
+
+  ```bash
+  mysqldump -u root -p xiaozhi > xiaozhi_backup_$(date +%Y%m%d).sql
+  ```
+
+## 注意事项
+
+1. **生产环境建议：**
+   - 修改默认密码
+   - 配置HTTPS
+   - 定期备份数据库
+
+2. **性能优化：**
+
+   增加JVM内存：
+
+   ```bash
+   java -Xms512m -Xmx1024m -jar target/xiaozhi.server-1.0.jar
+   ```