wehub-resource-sync
97 lines
2.1 KiB
Plaintext
97 lines
2.1 KiB
Plaintext
---
|
|
title: "使用 Docker 部署 - Xiaozhi Client"
|
|
description: "使用 Docker 或 Docker Compose 快速部署 xiaozhi-client 服务。"
|
|
---
|
|
|
|
# 使用 Docker 部署
|
|
|
|
<Callout type="info">
|
|
**前期准备**:
|
|
在开始之前，你至少需要有一个小智硬件设备，并已添加至小智官方服务端。并且已准备好
|
|
Docker 环境
|
|
</Callout>
|
|
|
|
|
|
## 安装方式
|
|
|
|
### 方式一：使用启动脚本（推荐）
|
|
|
|
<Callout type="info">
|
|
如果你的网络环境无法访问 github ，可以使用 gitee 进行安装
|
|
</Callout>
|
|
|
|
|
|
<Tabs items={['github', 'gitee']}>
|
|
<Tab>
|
|
```bash
|
|
# 下载脚本
|
|
curl -fsSL https://raw.githubusercontent.com/shenjingnan/xiaozhi-client/main/docker/scripts/start.sh | bash
|
|
```
|
|
</Tab>
|
|
<Tab>
|
|
```bash
|
|
curl -fsSL https://gitee.com/shenjingnan/xiaozhi-client/raw/main/docker/scripts/start.sh | bash
|
|
```
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
### 方式二：使用 Docker Compose
|
|
|
|
<Steps>
|
|
## 获取 docker-compose.yml
|
|
<Tabs items={['github', 'gitee']}>
|
|
<Tab>
|
|
```bash
|
|
curl -O https://raw.githubusercontent.com/shenjingnan/xiaozhi-client/main/docker/docker-compose.yml
|
|
```
|
|
</Tab>
|
|
<Tab>
|
|
```bash
|
|
curl -O https://gitee.com/shenjingnan/xiaozhi-client/raw/main/docker/docker-compose.yml
|
|
```
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
## 启动服务
|
|
```bash
|
|
docker-compose up -d
|
|
```
|
|
</Steps>
|
|
|
|
### 方式三：手动启动
|
|
|
|
<Steps>
|
|
## 创建挂载点目录
|
|
```bash
|
|
mkdir -p ~/xiaozhi-client
|
|
```
|
|
|
|
## 拉取镜像并启动服务
|
|
```bash
|
|
docker run -d \
|
|
--name xiaozhi-client \
|
|
-p 9999:9999 \
|
|
-v ~/xiaozhi-client:/workspaces \
|
|
--restart unless-stopped \
|
|
shenjingnan/xiaozhi-client
|
|
```
|
|
</Steps>
|
|
|
|
## 管理接入点
|
|
|
|
<Callout type="info">
|
|
在启动容器服务之后，我们需要配置小智接入点，才可以正常使用
|
|
</Callout>
|
|
|
|
<Steps>
|
|
## 打开管理界面
|
|
如果你的容器和你的本机在一起，可以直接使用浏览器打开网址：http://localhost:9999
|
|
如果你是在单独的设备部署容器，请确保你的电脑和单独的容器设备在同一个局域网，然后打开对应IP地址：http://\{容器IP\}:9999
|
|
|
|
## 配置小智接入点
|
|
TODO
|
|
|
|
## 重启服务
|
|
TODO
|
|
</Steps>
|