Skip to content

CENTOS_DEVELOPMENT.md

Latest commit

 

History

History
151 lines (115 loc) · 3.79 KB

CENTOS_DEVELOPMENT.md

File metadata and controls

151 lines (115 loc) · 3.79 KB

CentOS 部署指南

系统要求

项目 要求
系统 CentOS 7/8
内存 ≥ 2GB（推荐 4GB）
磁盘 ≥ 10GB
端口 8084、8091、8092、3306

1. 安装依赖

sudo yum install -y epel-release wget curl git vim unzip
sudo yum install -y java-21-openjdk java-21-openjdk-devel maven
curl -sL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo yum install -y nodejs

2. 配置防火墙

sudo firewall-cmd --permanent --add-port={8084,8091,8092,3306}/tcp
sudo firewall-cmd --reload

3. 安装 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
sudo systemctl start mysqld && sudo systemctl enable mysqld
sudo grep 'temporary password' /var/log/mysqld.log   # 获取临时密码
sudo mysql_secure_installation

创建数据库：

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;

无需手动导入 SQL，项目集成 Flyway，首次启动自动建表。

4. 下载模型和原生库

使用第三方 STT/TTS 服务可只下载基础依赖。

./scripts/download_models.sh            # 下载全部（模型 + 原生库）
./scripts/download_models.sh status     # 查看状态

也可按需单独下载：

./scripts/download_base.sh              # 基础依赖（VAD 模型 + 原生库）— 必须
./scripts/download_stt.sh               # Vosk STT 模型（使用第三方 STT 可跳过）
./scripts/download_tts.sh               # TTS 模型（使用第三方 TTS 可跳过）

5. 部署

项目采用双进程架构：

服务 端口 说明
xiaozhi-server 8091 管理后台 API、用户/设备管理
xiaozhi-dialogue 8092 设备对话、AI、WebSocket 
git clone https://github.com/joey-zhou/xiaozhi-esp32-server-java
cd xiaozhi-esp32-server-java

# 一键编译并启动
bin/all.sh start

# 查看状态
bin/all.sh status

# 停止 / 重启
bin/all.sh stop
bin/all.sh restart

也可单独管理：bin/server.sh start、bin/dialogue.sh start

前端：

cd web && npm install && npm run build

6. Nginx 反向代理（可选）

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;
    }
    location /ws {
        proxy_pass http://localhost:8092;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

7. 访问

服务 地址
前端 http://your_server_ip:8084
后台 API http://your_server_ip:8091
WebSocket ws://your_server_ip:8092/ws/xiaozhi/v1/

默认管理员：admin / 123456

维护

bin/all.sh status                          # 查看状态
tail -f logs/xiaozhi-server.log            # 查看日志
tail -f logs/xiaozhi-dialogue.log
git pull origin main && bin/all.sh restart # 更新并重启
mysqldump -u root -p xiaozhi > backup.sql  # 数据库备份

常见问题

问题 解决
MySQL 初始化失败 sudo systemctl restart mysqld
端口冲突 netstat -tulnp | grep <端口> 找到并 kill 占用进程
内存不足 添加 swap：sudo dd if=/dev/zero of=/swapfile bs=1M count=2048 && sudo mkswap /swapfile && sudo swapon /swapfile
模型加载失败 chmod -R 755 models