# 宝塔部署（源码版，包含 nav_copilot 改动）

你需要部署的就是本目录的上级目录：`xiaozhi-server`（里面有 `app.py`、`requirements.txt`、`plugins_func/` 等）。

## 1. 上传代码

把整个 `xiaozhi-server` 目录上传到服务器，例如：

- `/www/wwwroot/xiaozhi-server/`

## 2. 创建配置文件（必须）

本项目启动时会强制要求存在：`data/.config.yaml`。

在服务器上：

- 进入 `/www/wwwroot/xiaozhi-server/`
- 创建目录 `data/`
- 复制 `data/.config.yaml.example` 为 `data/.config.yaml`，并填写你自己的 `api_key`、域名等。

注意：不要把真实 `data/.config.yaml` 上传到公开仓库。

## 3. 安装依赖并启动（推荐：Supervisor）

```bash
cd /www/wwwroot/xiaozhi-server
python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -r requirements.txt
PYTHONDONTWRITEBYTECODE=1 python app.py
```

要常驻运行，建议用宝塔的 Supervisor 插件，配置示例见同目录 `supervisor_xiaozhi-server.conf`。

## 4. Nginx 反代（WSS/HTTPS）

在宝塔站点里开启 SSL，然后把同目录 `nginx_locations.conf` 的内容加入站点 Nginx 配置（或“反向代理”里配置等效规则）。

你最终给 ESP32 的地址应该是：

- `wss://你的域名/xiaozhi/v1/`