PH Edge Platform

cd /home/PH/PH_OpenResty
sudo bash scripts/deps.sh

sudo bash scripts/fetch-modules.sh           # 默认（含 RTMP）
# 可选：
# sudo bash scripts/fetch-modules.sh --with-vod      # 加 Kaltura VOD HLS/DASH 打包
# sudo bash scripts/fetch-modules.sh --without-rtmp  # 不带 RTMP

sudo bash scripts/build-openssl.sh    # 安装到 /usr/local/openssl-3.5/

sudo bash scripts/build.sh                   # 全功能（推荐）
# 可选：
# sudo bash scripts/build.sh --no-http3       # 关闭 HTTP/3
# sudo bash scripts/build.sh --no-rtmp        # 关闭 RTMP
# sudo bash scripts/build.sh --clean          # 强制重新 configure

sudo bash scripts/install.sh

# 启动顺序：先 miniredis 再 controller 最后 openresty
sudo systemctl enable --now miniredis
sudo systemctl enable --now ph-controller
sudo systemctl enable --now openresty

# 状态检查
sudo systemctl status openresty miniredis ph-controller

# 数据面健康检查
curl -k https://localhost/healthz
# 预期：HTTP/2 200，body 含 {"status":"ok",...}

# 连接数统计
ss -s

# 实时日志
sudo journalctl -u openresty -f

PH_OpenResty/
├── openresty-1.29.2.3/      # OpenResty 源码
├── scripts/
│   ├── build.sh             # OpenResty 编译脚本
│   ├── install.sh           # Phase 0 一键部署
│   └── iptables-notrack.sh  # NOTRACK 规则
├── sysctl/
│   └── 99-ph-edge.conf      # 内核调优
├── systemd/
│   ├── openresty.service    # 主数据面
│   ├── miniredis.service    # Mini Redis KV
│   └── ph-controller.service # 控制面 API
├── conf/
│   ├── nginx.conf.skeleton  # 主 nginx.conf 骨架
│   └── controller.conf      # 控制面配置（单一 admin 入口）
├── lualib/ph/
│   └── admin/router.lua     # Admin API 路由表（所有 /admin/v1/* 在此维护）
├── tests/integration/
│   └── admin-router_test.sh # Admin Router 集成测试
├── docs/
│   ├── modules/admin-router.md  # Admin 路由架构说明
│   ├── openresty-analysis/      # OpenResty 源码分析
│   └── discovery/               # 调研与决策文档（10+ 份）
└── README.md

> **Admin API 路由说明**：所有 `/admin/v1/*` 路由表集中维护在
> `lualib/ph/admin/router.lua`，`conf/controller.conf` 只保留单一 location 入口。
> 扩展新 API endpoint 只需修改路由表，无需改动 nginx 配置。
> 详见 [docs/modules/admin-router.md](docs/modules/admin-router.md)。

/usr/local/openresty/        # OpenResty 编译产物
  ├── nginx/sbin/nginx
  ├── luajit/
  └── lualib/

/etc/ph/                     # 平台配置
  ├── nginx.conf             # 主配置
  ├── lualib/ph/             # 业务 Lua（Phase 1-3 写入）
  └── certs/placeholder.{crt,key}

/var/lib/ph/                 # 运行时数据
  ├── miniredis/
  │   ├── aof.log            # KV 持久化
  │   └── conf/miniredis.conf
  └── controller/

/var/log/ph/
  └── access.log             # 结构化 JSON 日志

# 启用 RTMP（默认已启用，端口 1935）
sudo cp conf/streaming.conf.example /etc/ph/streaming.conf
# 在 /etc/ph/nginx.conf 顶层 include /etc/ph/streaming.conf;

# 推流（OBS / ffmpeg）
ffmpeg -re -i input.mp4 -c copy -f flv rtmp://your-domain:1935/live/<stream_key>

# 拉流
# HLS:  https://your-domain/hls/<stream_key>.m3u8
# DASH: https://your-domain/dash/<stream_key>.mpd

# 默认已启用 mp4 + flv
location ~ \.mp4$ { mp4; }
location ~ \.flv$ { flv; }

server {
    listen 443 ssl http2 reuseport;
    listen 443 quic reuseport;          # UDP QUIC
    add_header alt-svc 'h3=":443"; ma=86400';
    ...
}