小智服务器开源版自建实践：语音提醒功能端到端部署

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}

1. 小智服务器开源版自建实践：从零部署到语音提醒功能集成

在嵌入式与AIoT融合加速的当下，智能语音助手已不再是云端大厂的专属能力。随着小智服务器（XiaoZhi Server）开源版本的发布，开发者得以在私有硬件环境上构建具备完整语音交互能力的本地化智能体平台。这不仅规避了商业服务订阅成本与数据隐私风险，更赋予工程师对底层模型调度、意图识别链路、记忆管理及任务执行全流程的完全控制权。本文将基于小智服务器 v3.x 开源代码，以工程师视角系统梳理从环境准备、服务编译部署、配置文件定制，到最终实现“语音设置智能提醒”这一典型场景的端到端工程实践。所有操作均在 Ubuntu 22.04 LTS 云服务器环境下验证，所涉技术栈严格遵循官方文档与社区最佳实践，不依赖任何第三方封装或非标准补丁。

1.1 环境准备与依赖安装

小智服务器采用模块化架构，其核心组件分别基于 Python（小智主服务）、Java（Manager API）与 Node.js（Manager Web 前端）构建。三者运行时依赖相互独立，需分步安装并确保版本兼容性。关键依赖项如下表所示：

安装完成后，需对 MySQL 与 Redis 进行基础安全加固： – MySQL ：执行 sudo mysql_secure_installation ，禁用匿名用户、禁止远程 root 登录、移除测试数据库； – Redis ：编辑 /etc/redis/redis.conf ，将 bind 127.0.0.1 ::1 保留，注释 # bind 0.0.0.0 ，设置 requirepass your_strong_password ，重启服务 sudo systemctl restart redis-server 。

此阶段的核心目标并非简单安装软件包，而是构建一个符合生产级安全基线的中间件底座。例如，Redis 密码强制启用并非可选项——小智服务器的会话缓存、意图识别结果暂存均依赖 Redis，未设密码将导致任意网络节点可读写全部用户对话上下文，构成严重数据泄露面。同理，MySQL 的绑定地址限制确保 Manager API 数据库仅对本机应用进程开放，避免暴露于公网攻击面。

1.2 源码获取与目录结构解析

小智服务器开源仓库托管于 GitHub，官方地址为 https://github.com/xiaozhi-ai/xiaozhi-server 。使用 Git 克隆完整代码库是启动部署的第一步：

mkdir -p ~/xiaozhi-deploy && cd ~/xiaozhi-deploy
git clone https://github.com/xiaozhi-ai/xiaozhi-server.git

克隆完成后的目录结构清晰体现了其微服务设计思想：

xiaozhi-server/
├── xiaozhi-server/ # 核心语音交互服务（Python）
│ ├── config/ # 配置模板目录
│ ├── models/ # 大模型权重存放点（需手动下载）
│ └── app.py # 主应用入口
├── manager-api/ # 后台管理API服务（Java/Spring Boot）
│ ├── src/ # Java源码
│ ├── pom.xml # Maven构建配置
│ └── application.yml # Spring Boot配置文件
└── manager-web/ # Web管理界面（Vue3 + Vite）
├── src/ # 前端源码
├── vite.config.ts # 构建配置
└── package.json # NPM依赖定义

该结构的关键启示在于：