46 lines
2.2 KiB
Markdown
46 lines
2.2 KiB
Markdown
# Live Platform 四层架构
|
||
|
||
## 分层
|
||
|
||
| 层 | 职责 | 代码/路径 |
|
||
|----|------|-----------|
|
||
| Core OS | 用户、SSH、mDNS、Wi‑Fi、WebTTY、Docker、systemd、日志 | `scripts/linux/install_hub.sh` 及系统包 |
|
||
| Infra Service | ShellCrash、Caddy、Netdata、SRS、Neko、ws-scrcpy、FRP、WireGuard 占位 | `services/*`、`scripts/linux/service_ctl.sh` |
|
||
| Business | 无人直播 douyinyoutube（FFmpeg/HDMI/推流），可脱离控制台运行 | 仓库根业务脚本、`install-live.sh` |
|
||
| Web Console | 仅通过 API 与配置中心「控制」，不实现业务算法 | `web.py`、`web-console`、`/hub/*` API |
|
||
|
||
## 配置中心
|
||
|
||
- 安装目标：`/opt/live/config/`
|
||
- 默认模板：`live-platform/config/defaults/`
|
||
- 文件：`system.json`、`network.json`、`services/*.json`、`business/*.json`
|
||
- 生成兼容层：`live-platform/tools/render_stack_env.py` → `/opt/live/generated/system-stack.env`（供现有 shell 读取，逐步淘汰分散 `.env`）
|
||
|
||
## 一键脚本（幂等）
|
||
|
||
| 脚本 | 作用 |
|
||
|------|------|
|
||
| `./install-core.sh` | 同步 JSON → `/opt/live/config`，生成 env，调用 `install_hub.sh`（无业务） |
|
||
| `./install-live.sh` | 仅业务模块，调用 `install_business.sh` |
|
||
| `./doctor.sh` | 网络、端口、adb、ffmpeg、docker、API 健康检查 |
|
||
|
||
## API
|
||
|
||
- `GET /hub/dashboard`：快照 + 服务 + 安卓 + 直播进程状态
|
||
- `GET /hub/config`：配置中心只读聚合
|
||
- `POST /hub/business/douyinyoutube`：业务元数据（如抖音 URL 声明）
|
||
- 既有：`/service_action`、`/android/*`、`/process_monitor`、`/save_url_config` 等
|
||
|
||
## 前端
|
||
|
||
- `/`：`LiveControlApp` 产品壳（总览、服务、直播、安卓、网络、设置）
|
||
- `/console`：高级遗留控制台（全功能）
|
||
- 开发：`middleware` 将 `/hub` 代理到本机 FastAPI
|
||
|
||
## live.local（无端口验收）
|
||
|
||
- **`install_hub.sh` 末尾**执行 **`install_live_edge_proxy`**：安装/启用 **`live-edge.service`（Caddy）**，将 **`http://live.local`（:80）** 反代到 **`127.0.0.1:${PORT}`**（默认 8001）。
|
||
- **Homepage** 默认改绑 **`HOMEPAGE_PORT=3080`**，避免与 Caddy 抢 80。
|
||
- 仅更新反代：`sudo bash scripts/linux/reinstall_live_edge.sh`
|
||
- `ENABLE_LIVE_EDGE_PROXY=0` 可关闭（`system-stack.env`）。
|