FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [View Raw Code]   [Original HTTPS Page]

xiaozhi-esp32-server-java/docs/CENTOS_DEVELOPMENT.md at main · augusdin/xiaozhi-esp32-server-java · GitHub

/ xiaozhi-esp32-server-java Public

Breadcrumbs

  1. xiaozhi-esp32-server-java
  2. docs

CENTOS_DEVELOPMENT.md

Latest commit

 

History

History
310 lines (221 loc) · 4.95 KB

Breadcrumbs

  1. xiaozhi-esp32-server-java
  2. docs

CENTOS_DEVELOPMENT.md

File metadata and controls

310 lines (221 loc) · 4.95 KB
Raw

小智ESP32服务器CentOS部署文档

系统要求

  • CentOS 7/8（推荐CentOS 8）
  • 最小化安装 + 开发工具（gcc, make等）
  • 至少2GB内存（推荐4GB）
  • 至少10GB磁盘空间

1. 环境准备

1.1 安装基础工具

sudo yum install -y epel-release
sudo yum install -y wget curl git vim unzip

1.2 配置防火墙

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 21

sudo yum install -y java-21-openjdk java-21-openjdk-devel

验证安装：

java -version

3. 安装MySQL 8.0

# 安装MySQL 8.0存储库
sudo yum localinstall -y https://dev.mysql.com/get/mysql80-community-release-el7-7.noarch.rpm
sudo yum install -y mysql-community-server

启动MySQL服务：

sudo systemctl start mysqld
sudo systemctl enable mysqld

获取临时密码：

sudo grep 'temporary password' /var/log/mysqld.log

安全设置：

sudo mysql_secure_installation

4. 安装Maven

sudo yum install -y maven

验证安装：

mvn -v

5. 安装Node.js 16

curl -sL https://rpm.nodesource.com/setup_16.x | sudo bash -
sudo yum install -y nodejs

验证安装：

node -v
npm -v

6. 安装FFmpeg

sudo yum install -y ffmpeg ffmpeg-devel

验证安装：

ffmpeg -version

7. 数据库配置

创建数据库和用户：

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

导入初始化脚本：

mysql -u root -p xiaozhi < db/init.sql

8. 下载Vosk语音识别模型

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 克隆项目

git clone https://github.com/joey-zhou/xiaozhi-esp32-server-java
cd xiaozhi-esp32-server-java

9.2 后端部署

mvn clean package -DskipTests
java -jar target/xiaozhi.server-*.jar &（版本号可能不同）

9.3 前端部署

cd web
npm install
npm run build

10. 配置系统服务（可选）

10.1 创建后端服务

编辑服务文件：

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-*.jar（版本号可能不同）
SuccessExitStatus=143
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

启动服务：

sudo systemctl daemon-reload
sudo systemctl start xiaozhi
sudo systemctl enable xiaozhi

10.2 配置Nginx（可选）

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：

sudo systemctl start nginx
sudo systemctl enable nginx

11. 访问系统

  • 直接访问：http://your_server_ip:8084
  • 如果配置了Nginx：http://your_domain_or_ip
  • 默认管理员账号：admin/123456

常见问题解决

  1. MySQL初始化失败

    sudo systemctl restart mysqld
mysql_upgrade -u root -p

  2. 端口冲突

    netstat -tulnp | grep 8084
kill -9 <PID>

  3. Node.js版本问题

    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空间：

    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模型加载失败

    chmod -R 755 models

维护命令

  • 查看后端日志：

    journalctl -u xiaozhi -f

  • 更新代码：

    git pull origin master
mvn clean package -DskipTests
sudo systemctl restart xiaozhi

  • 数据库备份：

    mysqldump -u root -p xiaozhi > xiaozhi_backup_$(date +%Y%m%d).sql

注意事项

  1. 生产环境建议：

    • 修改默认密码
    • 配置HTTPS
    • 定期备份数据库

  2. 性能优化：

    增加JVM内存：

    java -Xms512m -Xmx1024m -jar target/xiaozhi.server-*.jar（版本号可能不同）
Back | FazBrowse Home | New Git URL