用本机 Nginx 测试 pipi-assets 配置

按顺序做下面几步即可。

1. 检查是否已安装 Nginx

在终端执行：

nginx -v

有版本号（如 nginx version: nginx/1.27.5）→ 已安装，跳到第 2 步。
报错 command not found → 需要先安装。Mac 推荐用 Homebrew：
```
brew install nginx
```

2. 确认资源目录存在

本配置会使用项目下的 pipi-assets 目录。若还没有，先执行一次：

cd platform-pipi/packages/voice-production
pnpm run deploy-assets:local

这样会生成 pipi-assets/（内含 char/、voice/ 等）。

3. 让主 Nginx 加载本项目的配置

你的 Nginx 主配置在 Homebrew 安装时一般是：

Apple Silicon：/opt/homebrew/etc/nginx/nginx.conf
Intel：/usr/local/etc/nginx/nginx.conf

任选一种方式，让主配置把「本项目里的 pipi-assets 配置」包含进去。

方式 A：在主配置里加一行 include（推荐）

用编辑器打开主配置，例如：
```
open -e /opt/homebrew/etc/nginx/nginx.conf
```
（Intel 机器把路径改成 /usr/local/etc/nginx/nginx.conf）
在 http { ... } 块里找合适位置（例如在 include servers/*; 那一行上面），加一行：
```
include /Users/joey-xd/sites/pipi-learn/platform-pipi/packages/voice-production/scripts/nginx-pipi-assets-local.conf;
```
注意把路径改成你本机实际的项目路径。
保存退出。

方式 B：放到 Nginx 的 servers 目录

若没有 servers 目录，先建一个：
```
sudo mkdir -p /opt/homebrew/etc/nginx/servers
```
（Intel 用 /usr/local/etc/nginx/servers）

做一份软链，指向项目里的本地配置：

sudo ln -sf /Users/joey-xd/sites/pipi-learn/platform-pipi/packages/voice-production/scripts/nginx-pipi-assets-local.conf /opt/homebrew/etc/nginx/servers/pipi-assets.conf

主配置里已有 include servers/*; 时会自动加载。

4. 检查配置并重载 Nginx

# 检查语法是否正确
nginx -t

# 若无报错，重载 Nginx（不中断已有连接）
nginx -s reload

若你是用 brew services start nginx 启用的，可以改为：

brew services restart nginx

5. 在浏览器或终端里测试

本地站点监听 8081 端口，用 localhost 即可访问（无需改 hosts）。

健康检查：
http://localhost:8081/health
应看到页面内容：ok
角色 JSON：
http://localhost:8081/char/char_introduce.json
应返回 JSON 内容
语音文件（示例）：
http://localhost:8081/voice/一_4e00.mp3
应能播放或下载

终端快速验证：

curl -s http://localhost:8081/health
curl -s -o /dev/null -w "%{http_code}" http://localhost:8081/char/char_introduce.json

说明

端口：使用 8081 是为了不和 80 端口上已有的其他站点（如 simulation.data-platform.local 等）冲突。
配置文件：nginx-pipi-assets.conf 是给服务器部署用的（80 端口 + 二级域名）；nginx-pipi-assets-local.conf 是给本机测试用的（8081 + localhost），路径已指向项目下的 pipi-assets。

3.2 KiB Raw Blame History Unescape Escape