310 lines
4.9 KiB
Markdown
310 lines
4.9 KiB
Markdown
# 小智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
|
||
```
|