srs-and-danmaku-linux/DEPLOYMENT.md

# 部署记忆文档 — srs-and-danmaku-linux

> 部署位置：**cf 服务器**（Celestial-Fulcrum，Ubuntu 24.04，本仓库即部署目录 `/home/srs`）
> 部署日期：2026-09-01 ~ 09-03
> 上游：https://git.rrrosmontis.icu/RoyirinRosmontis/srs-and-danmaku-linux（本仓库）

## 1. 总体架构

```
外网 443（Sakura Frp HTTPS 隧道 ×2，TLS 透传到本机）
  ├── srs_oversea: tsk.aeolianchi.me  (frp-age 节点)  ──┐
  └── srs_cn:      tsk.rrrosmontis.icu (frp-hip 节点) ─┴→ 本机 :18443
                                                        │
                                            HAProxy [TLS终结 + 按SNI选证 + 首字节嗅探]
                                            ├── 解密后 0x03 (RTMPS 推流) → 127.0.0.1:1935 (SRS)
                                            └── HTTP (拉流/弹幕)         → 127.0.0.1:8445 (nginx)
                                                                              ├── /live/   → 127.0.0.1:8080 (SRS HTTP-FLV/HLS)
                                                                              └── /danmaku → 127.0.0.1:55556 (弹幕 WebSocket)
```

- **推流**：`rtmps://tsk.aeolianchi.me:443/live/room_<房间号>` 或 `rtmps://tsk.rrrosmontis.icu:443/live/room_<房间号>`（OBS / ffmpeg 均可）
- **拉流**：`https://tsk.rrrosmontis.icu/live/room_<房间号>.flv`（或 `.m3u8`，me 域名同）
- **弹幕**：`wss://tsk.rrrosmontis.icu/danmaku`
- 设计要点：全部业务共用 443 对外端口；推流用 **RTMPS**（裸 RTMP 无 SNI 无法过 HTTPS 隧道）；nginx stream ssl_preread 分不开「同 SNI 的 RTMPS/HTTPS」，故用 **HAProxy 先终结 TLS 再嗅探首字节**（RTMP 握手恒为 0x03，HTTP 以方法字符开头）。

## 2. 本机组件与路径

| 组件 | 路径 | 说明 |
|---|---|---|
| SRS 源码+编译产物 | `/home/srs/trunk/` | SRS 6.0.172（上游 tag v6.0-b0），二进制 `trunk/objs/srs` |
| 弹幕后端 | `/home/srs/danmaku/danmaku_backend.py` | FastAPI + uvicorn，端口 55556，venv 在 `danmaku/venv/`（gitignore） |
| HAProxy 配置 | `conf/haproxy/haproxy.cfg` | 软链 → `/etc/haproxy/haproxy.cfg` |
| nginx 8445 口 | `conf/nginx/srs-https-8445.conf` | 软链 → `/etc/nginx/sites-enabled/srs-https-8445.conf`（明文 HTTP，TLS 已在 HAProxy 终结） |
| 证书 pem 构建脚本 | `conf/certs/build-pems.sh` | 生成 `/etc/haproxy/certs/*.pem`（cert+key 合一；**私钥不入库**，pem 只在 /etc 下） |
| 主配置 | `trunk/conf/srs.conf` | RTMP 1935 / API 1985 / HTTP 8080 / WebRTC 8000(UDP) |

### systemd 服务（均 enabled 开机自启）

| 服务 | 启动 | 日志 |
|---|---|---|
| `srs-server.service` | `trunk/run.sh`（`./objs/srs -c ./conf/srs.conf`，WorkingDirectory=/home/srs/trunk） | `journalctl -u srs-server -f` |
| `srs-danmaku.service` | `danmaku/venv/bin/python danmaku_backend.py` | `journalctl -u srs-danmaku -f` |
| `haproxy.service` | `/etc/haproxy/haproxy.cfg`（软链至 conf/） | `journalctl -u haproxy -f` |

## 3. 证书与续期

- `tsk.aeolianchi.me`：acme.sh（阿里云 DNS API，ecc），装于 `/etc/nginx/cert/tsk.aeolianchi.me/`
- `tsk.rrrosmontis.icu`：复用 acme.sh 泛域名证书 `*.rrrosmontis.icu`（`/home/server/cert/extra/rrrosmontis.icu/`）
- **续期钩子**：两张证书的 `--reloadcmd` 均为 `conf/certs/build-pems.sh && systemctl reload nginx && systemctl reload haproxy`，续期后自动重拼 pem 并重载，无需人工干预

## 4. 开播通知链路（http_hooks）

```
SRS on_publish/on_unpublish
  → https://api.rrrosmontis.icu/v1/live/publish/local/on_publish   (bj nginx 公网入口)
  → bj:1986 /remote_srs/local/on_publish                            (live_monitor.py, napcat 伴生 Flask)
  → 按 record.json 关注列表发 QQ 通知；返回 {"code":0} 放行推流
```

- SRS 6.0 的 http_hooks 原生支持 https 回调（源码 http client 带 TLS）
- **流名必须为 `room_<房间号>`** 才会被识别为房间；hook 失败 SRS 会拒绝推流
- 主站（aliyun）走 `/remote_srs/on_publish`（site=1），本机为副站（`/remote_srs/local/...`，site=2）

## 5. 前端页面（hk 服务器）

- `https://lfr.aeolianchi.me` → hk:/home/srs-frontend（index.html + js/hls、mpegts 播放库）
- 页面内副站地址已改为 `tsk.rrrosmontis.icu`（拉流 base + 弹幕 wss）
- hk nginx：`/etc/nginx/conf.d/lfr.aeolianchi.me.conf`（80 跳转 + 443 静态，证书 webroot HTTP-01 自动续期）

## 6. 从零重建步骤（换机/重装备忘）

1. `git clone` 本仓库到部署目录（如 `/home/srs`）
2. 补编译依赖：`apt install -y automake autoconf libtool pkg-config tclsh cmake`（另需 gcc/g++/make）
3. **补齐 `trunk/3rdparty/`**（仓库 .gitignore 排除了它，裸仓库无法编译）：从官方 `ossrs/srs` tag `v6.0-b0` 稀疏克隆 `trunk/3rdparty` 拷入——版本号必须与本仓库 `trunk/src/core/srs_core_version6.hpp` 的 `VERSION_REVISION` 一致（当前 172）
4. 编译：`cd trunk && ./configure && make -j$(nproc)`（大任务放 tmux）
5. 弹幕后端：`python3 -m venv danmaku/venv && danmaku/venv/bin/pip install fastapi 'uvicorn[standard]'`
6. 软链配置：`conf/haproxy/haproxy.cfg → /etc/haproxy/haproxy.cfg`、`conf/nginx/srs-https-8445.conf → /etc/nginx/sites-enabled/`
7. 证书签发（acme.sh dns_ali）+ `build-pems.sh` + 续期钩子（见第 3 节）
8. systemd：创建 `srs-server.service` / `srs-danmaku.service`（见第 2 节），`daemon-reload && enable --now`
9. Sakura Frp：两条 HTTPS 隧道绑定各自域名，本地目标 `127.0.0.1:18443`

## 7. 已知行为与坑

- **SRS 对不在线流的 .flv 请求会挂住连接等流出现**（不是 404）——拉流方需自行设置超时；测试时推流建立延迟会造成"拉到 0 字节"的假象
- `srs.conf` 中 `rtc_server.candidate = 39.97.55.150`（bj 公网 IP）：WebRTC 播放需 UDP 8000 能路由到该地址，当前未配转发，WebRTC 播放未打通（HTTP-FLV/HLS 不受影响）
- `daemon off` + 控制台日志是配合 systemd 的刻意配置，非调试残留
- 免费版 Sakura 节点偶发新连接抖动，客户端重试即可
- `run.sh` 依赖 systemd 的 `WorkingDirectory=/home/srs/trunk`（内用相对路径），改路径两处同步

## 8. 本仓库相对上游的变更

| 文件 | 变更 |
|---|---|
| `trunk/run.sh` | 修正旧绝对路径（srs-server-6.0-b0 → 当前部署路径），改为相对路径 |
| `trunk/conf/srs.conf` | http_hooks 指向 api.rrrosmontis.icu 公网入口（bj live_monitor） |
| `conf/` | 新增：HAProxy 分流配置、nginx 8445 拉流/弹幕口、pem 构建脚本 |
| `.gitignore` | 追加 `danmaku/venv/`、`*.log` |
| `DEPLOYMENT.md` | 本文档 |

## 9. 快速运维

```bash
systemctl restart srs-server srs-danmaku   # 重启业务
journalctl -u srs-server -f                # 看 SRS 日志（含 hook 回调记录）
/home/srs/conf/certs/build-pems.sh         # 手动重建 HAProxy pem
tmux attach -t <会话>                       # 编译类长任务用 tmux（单字母命名惯例）
```