smartgic/ovos-phal

Open Voice OS Docker/Podman 镜像

镜像概述和主要用途

该镜像提供Open Voice OS在Docker/Podman环境中的容器化运行方案，基于smartgic/ovos-core镜像构建。主要用途是简化Open Voice OS的部署流程，支持跨平台快速搭建开源语音操作系统环境，适用于开发、测试及生产环境的语音助手服务部署。

核心功能和特性

• PHAL架构：采用Plugin-based Hardware Abstraction Layer (PHAL)，替代mycroft-core中硬编码的enclosure概念，提供更灵活的硬件抽象与扩展能力
• 容器化优势：支持Docker/Podman容器化部署，实现环境隔离、快速启停和跨平台一致性运行
• 轻量高效：优化镜像体积，降低资源占用，适合边缘设备及服务器环境部署
• 可扩展性：支持自定义插件集成，适配不同硬件设备和语音服务需求

使用场景和适用范围

• 开源语音助手开发与测试环境搭建
• 家庭自动化系统中的语音交互节点部署
• 边缘计算设备（如树莓派）上的语音服务容器化运行
• 需要快速部署和迁移的语音应用场景

详细使用方法和配置说明

前提条件

• 安装Docker Engine（20.10+）或Podman（3.0+）
• 网络连接（用于拉取镜像及依赖组件）

基础使用步骤

1. 拉取镜像

bash
docker pull smartgic/ovos-core:latest

2. 启动容器（基础配置）

bash
docker run -d \
  --name ovos-core \
  --restart unless-stopped \
  smartgic/ovos-core:latest

高级配置选项

端口映射（如需外部访问服务）

bash
docker run -d \
  --name ovos-core \
  -p 8181:8181 \  # API端口
  -p 12101:12101 \ # 消息总线端口
  smartgic/ovos-core:latest

数据持久化（挂载配置和数据目录）

bash
docker run -d \
  --name ovos-core \
  -v /本地路径/ovos/config:/home/ovos/.config/OpenVoiceOS \
  -v /本地路径/ovos/data:/home/ovos/.local/share/OpenVoiceOS \
  smartgic/ovos-core:latest

环境变量配置（自定义运行参数）

示例（自定义语言和插件）：

bash
docker run -d \
  --name ovos-core \
  -e OVOS_LANG=zh-cn \
  -e PHAL_PLUGINS='["ovos-phal-plugin-system", "ovos-phal-plugin-display"]' \
  smartgic/ovos-core:latest

容器管理命令

• 查看容器日志：docker logs -f ovos-core
• 停止容器：docker stop ovos-core
• 重启容器：docker restart ovos-core
• 删除容器：docker rm -f ovos-core

更多资源

完整配置文档及更新日志请参考Docker Hub官方页面：
https://hub.docker.com/r/smartgic/ovos-core