Compare commits

...
2 Commits
Author SHA1 Message Date
admin 832a2156a5 perf(vod): adjust hls.js to fit low bandwidth 2026-10-23 14:18:14 +08:00
admin b4fcbd38ba chore: brand icon and title by default 2026-10-22 20:23:33 +08:00
19 changed files with 1208 additions and 102 deletions

No files matched your search

+4
View File
@@ -36,3 +36,7 @@ package-lock.json
# edge-agent # edge-agent
edge-agent/dist/ edge-agent/dist/
edge-agent/mediamtx/ edge-agent/mediamtx/
#AI
.dsh
.claude
+111 -2
View File
@@ -91,6 +91,51 @@ nvidia-smi
If browser or network tests run from another machine, open the Windows firewall for ports 8080, 1935, and 8888. If browser or network tests run from another machine, open the Windows firewall for ports 8080, 1935, and 8888.
## Windows service: autostart behind nginx
`start.ps1` above is the manual/dev path: one foreground process on :8080 that
serves the frontend itself. On the production box the stack instead runs as a
background service behind nginx, and `scripts\streamcore-service.ps1` owns it.
```powershell
# one-off, elevated: register the boot task
powershell -ExecutionPolicy Bypass -File .\scripts\streamcore-service.ps1 -Action Install
# day to day
powershell -ExecutionPolicy Bypass -File .\scripts\streamcore-service.ps1 -Action Status
powershell -ExecutionPolicy Bypass -File .\scripts\streamcore-service.ps1 -Action Restart
powershell -ExecutionPolicy Bypass -File .\scripts\streamcore-service.ps1 -Action Stop
powershell -ExecutionPolicy Bypass -File .\scripts\streamcore-service.ps1 -Action Doctor
```
- The scheduled task `StreamCore-AutoStart` fires at startup as **SYSTEM**, with a
20-second delay, no execution time limit, and restart-on-failure. It runs in
session 0, so no console window ever appears.
- nginx is `D:\nginx-1.31.6`, started with `-p D:\nginx-1.31.6` so the relative
paths in `conf\nginx.conf` resolve inside that directory. It serves
`frontend\dist` and the HLS segments from disk and proxies `/api/`, `/docs`,
`/openapi.json` and the HLS fallback to `127.0.0.1:8080`.
- The backend is plain `uvicorn main:app --port 8080` against the machine-wide
Python install, not a venv. If it dies the launcher restarts it after 10s, and
nginx is re-checked on every 15s health tick.
- MediaMTX is still owned by the backend, which starts it if nothing answers
:9997 (see `LS_MEDIA_ORIGIN_AUTOSTART` above).
Two things about running as SYSTEM are worth knowing, because both fail *only*
in service mode:
- **ffmpeg.** winget installs it per-user, so SYSTEM never sees it on PATH. The
launcher prepends `%LOCALAPPDATA%\Microsoft\WinGet\Links` explicitly. Run
`-Action Doctor` and check the `executables` block after a reboot to confirm.
- **`nginx -s reload` / `-s stop`.** nginx signals its master through the global
event `Global\ngx_stop_<pid>`, which an administrator shell cannot open
(`OpenEvent ... Access is denied`). Use `-Action Restart` after editing
`nginx.conf`; it replaces the worker tree directly.
Logs land in `runtime\logs`: `backend.err.log` (uvicorn banner) and
`backend.out.log` (request log), `service.log` (what the launcher did),
`nginx-launch.*.log`, plus nginx's own logs in `D:\nginx-1.31.6\logs`.
## Windows edge node launcher ## Windows edge node launcher
Build and start an edge node from a Windows edge machine: Build and start an edge node from a Windows edge machine:
@@ -119,6 +164,70 @@ mediamtx\scripts\check_multicast.bat
Replay records store paths relative to LS_REPLAY_MEDIA_DIR. Absolute paths and parent-directory traversal are rejected. Replay records store paths relative to LS_REPLAY_MEDIA_DIR. Absolute paths and parent-directory traversal are rejected.
## Linux and macOS ## Linux (systemd, production)
Linux and macOS are not the primary deployment path. For local development, run the backend with uvicorn from `backend`, run the frontend with `npm run dev` from `frontend`, and set `LS_HLS_RUNTIME_DIR` to a writable directory. Reference host: Arch Linux, `newvision@10.1.120.53`, code and database under
`/opt/live`. Two units own everything; nothing runs in a shell.
| Unit | Role |
| --- | --- |
| `streamcore-backend.service` | uvicorn on `127.0.0.1:18080`. Also supervises MediaMTX and the ffmpeg transcoders as child processes. |
| `nginx.service` | distro unit. Serves `frontend/dist` and the HLS segments from disk on :80/:443 and proxies `/api`, `/docs`, `/openapi.json` and the HLS fallback to the backend. |
`/opt/live` is expected to be owned by `newvision` — the SQLite file,
`settings.json`, `nodes.json`, `runtime/` and `media/` are all written at runtime.
### One-time setup
```bash
# packages: nginx from pacman; Python deps in a venv (Arch enforces PEP 668,
# so a system-wide pip install is refused); npm only to build the frontend
sudo pacman -Sy --needed nginx npm
python3 -m venv /opt/live/backend/venv
/opt/live/backend/venv/bin/pip install -r /opt/live/backend/requirements.txt
# MediaMTX ships no binary in the repo; drop the release build beside its config
tar -xzf mediamtx_v1.21.2_linux_amd64.tar.gz -C /tmp
install -m 755 /tmp/mediamtx /opt/live/mediamtx/mediamtx
# the frontend is built once; dist/ is gitignored
cd /opt/live/frontend && npm install && npm run build
sudo mkdir -p /etc/nginx/certs/{ecc,rsa} /opt/live/{media,runtime/{hls,replay,logs}}
sudo chown -R newvision:newvision /opt/live
```
### Ports
`8080` is taken by the gitea container on the reference host, so the backend
listens on loopback `:18080` and only nginx is public. MediaMTX keeps its own
ports (`1935` RTMP, `8554` RTSP, `8888` HLS, `8889` WebRTC, `9997` API) and
publishers go to it directly — RTMP is not proxied through nginx.
### Operating it
```bash
systemctl status streamcore-backend
sudo systemctl restart streamcore-backend # restart; MediaMTX comes back with it
sudo journalctl -u streamcore-backend -f # backend + MediaMTX + transcoder logs
sudo systemctl reload nginx # only after editing the config
```
Both units are `enabled`, so a reboot brings the stack up without a login.
### Notes specific to this host
- **No GPU.** `detect_encoder()` probes NVENC/QSV/AMF and falls back to
`libx264`, logging the choice at startup. Expect CPU cost per rendition.
- **nginx file descriptors.** Arch sets only the *hard* `DefaultLimitNOFILE`
(524288) and leaves the soft limit at 1024, which makes nginx clamp
`worker_connections 4096` and warn. `/etc/systemd/system/nginx.service.d/nofile.conf`
pins `LimitNOFILE=65535:65535`. Running `nginx -t` by hand still inherits the
shell's 1024 and prints that warning — it is not the service's limit.
- **A stale `live` stream in the database** makes the lifespan start transcoders
for a publisher that is not there: a few ffmpeg processes spawn, exit, and sit
as zombies. Mark the row `ended` rather than leaving it `live`.
For local development on any platform, run the backend with uvicorn from
`backend`, run the frontend with `npm run dev` from `frontend`, and set
`LS_HLS_RUNTIME_DIR` to a writable directory.
+50
View File
@@ -124,6 +124,28 @@ def _valid_replay_url(url: str | None) -> str | None:
return url return url
def _parse_scheduled_at(value: str | None) -> datetime | None:
"""Turn the ISO string a client sends into the value the column stores.
`scheduled_at` is a DateTime column and SQLite's binder rejects a str outright
("SQLite DateTime type only accepts Python datetime and date objects"), so an
update that carried a schedule failed with a 500 — a large part of why the
schedule looked like a property that could only be set at creation.
Creation stores UTC wall-clock with tzinfo dropped; do the same here.
"""
if value is None:
return None
text = str(value).strip()
if not text:
return None
try:
parsed = datetime.fromisoformat(text.replace("Z", "+00:00"))
except ValueError as exc:
raise HTTPException(status_code=422, detail="预定开播时间格式无效") from exc
return parsed.replace(tzinfo=None) if parsed.tzinfo else parsed
def _utc_iso(moment: datetime) -> str: def _utc_iso(moment: datetime) -> str:
"""Render a stored timestamp as an explicit UTC instant for JSON. """Render a stored timestamp as an explicit UTC instant for JSON.
@@ -263,6 +285,14 @@ async def viewer_heartbeat(stream_id: int, body: ViewerHeartbeat,
stream = await StreamService(db).get_stream(stream_id) stream = await StreamService(db).get_stream(stream_id)
if not stream: if not stream:
raise HTTPException(status_code=404, detail="节目不存在") raise HTTPException(status_code=404, detail="节目不存在")
if stream.status.value != "live":
# Audit sessions describe live playback: node, rendition, buffer and remote
# adjustment only mean something while the programme is on air. A replay is
# a plain file served straight to the browser, so recording a session for it
# only filled the audit board with rows nobody could act on. This answers a
# no-op instead of an error so a tab left open across the end of a broadcast
# does not start failing its heartbeats.
return {"ok": True, "remote_adjusted": False, "audit_active": False}
session_id = body.session_id.strip() session_id = body.session_id.strip()
if not session_id or len(session_id) > 64: if not session_id or len(session_id) > 64:
raise HTTPException(status_code=422, detail="观众会话 ID 无效") raise HTTPException(status_code=422, detail="观众会话 ID 无效")
@@ -428,6 +458,14 @@ async def update_stream(stream_id: int, body: StreamUpdate, db: AsyncSession = D
if replay_fields.intersection(updates) and existing.status.value != "ended": if replay_fields.intersection(updates) and existing.status.value != "ended":
raise HTTPException(status_code=409, detail="仅已结束的节目可以配置回放和章节") raise HTTPException(status_code=409, detail="仅已结束的节目可以配置回放和章节")
if "title" in updates:
title = (updates["title"] or "").strip()
if not title:
raise HTTPException(status_code=422, detail="节目标题不能为空")
updates["title"] = title
if "scheduled_at" in updates:
updates["scheduled_at"] = _parse_scheduled_at(updates["scheduled_at"])
if updates.get("replay_file"): if updates.get("replay_file"):
_media_path(updates["replay_file"]) _media_path(updates["replay_file"])
if "replay_url" in updates and updates["replay_url"] is not None: if "replay_url" in updates and updates["replay_url"] is not None:
@@ -561,6 +599,8 @@ async def create_remote_session(stream_id: int, body: RemoteSessionCreate,
stream = await StreamService(db).get_stream(stream_id) stream = await StreamService(db).get_stream(stream_id)
if not stream or not stream.remote_control_enabled: if not stream or not stream.remote_control_enabled:
raise HTTPException(status_code=409, detail="节目未启用远程控制") raise HTTPException(status_code=409, detail="节目未启用远程控制")
if stream.status.value != "live":
raise HTTPException(status_code=409, detail="节目未在直播,无需控制回放观众")
expires_in = min(max(body.expires_in, 30), 3600) expires_in = min(max(body.expires_in, 30), 3600)
session = ControlSession( session = ControlSession(
token=secrets.token_urlsafe(24), token=secrets.token_urlsafe(24),
@@ -586,6 +626,8 @@ async def send_remote_command(stream_id: int, body: RemoteCommand,
stream = await StreamService(db).get_stream(stream_id) stream = await StreamService(db).get_stream(stream_id)
if not stream or not stream.remote_control_enabled: if not stream or not stream.remote_control_enabled:
raise HTTPException(status_code=409, detail="节目未启用远程控制") raise HTTPException(status_code=409, detail="节目未启用远程控制")
if stream.status.value != "live":
raise HTTPException(status_code=409, detail="节目未在直播,无需控制回放观众")
if body.action not in {"switch_node", "switch_quality", "restore_auto"}: if body.action not in {"switch_node", "switch_quality", "restore_auto"}:
raise HTTPException(status_code=422, detail="不支持的远程命令") raise HTTPException(status_code=422, detail="不支持的远程命令")
if not body.targets: if not body.targets:
@@ -616,6 +658,14 @@ async def send_remote_command(stream_id: int, body: RemoteCommand,
@router.get("/{stream_id}/remote-command") @router.get("/{stream_id}/remote-command")
async def poll_remote_command(stream_id: int, session_id: str, async def poll_remote_command(stream_id: int, session_id: str,
db: AsyncSession = Depends(get_db)): db: AsyncSession = Depends(get_db)):
stream = await StreamService(db).get_stream(stream_id)
if not stream:
raise HTTPException(status_code=404, detail="节目不存在")
if stream.status.value != "live" or not stream.remote_control_enabled:
# Same rule as heartbeats: nobody is audited during a replay, and a
# programme that never opted into control must not have viewers polling for
# commands either. Answer "nothing to do" instead of registering a session.
return None
viewer = await db.get(ViewerSession, session_id) viewer = await db.get(ViewerSession, session_id)
if not viewer: if not viewer:
raise HTTPException(status_code=404, detail="观众会话不存在") raise HTTPException(status_code=404, detail="观众会话不存在")
+13
View File
@@ -192,6 +192,19 @@ class StreamService:
stream = await self.get_stream_by_key(stream_key) stream = await self.get_stream_by_key(stream_key)
if not stream: if not stream:
return {"lines": [], "qualities": [], "multicast_available": False, "selected_node": None} return {"lines": [], "qualities": [], "multicast_available": False, "selected_node": None}
# Live HLS lines only exist while the programme is on air. Before it starts
# nothing has been published to MediaMTX, and once it has ended the
# playlists under /hls/<key> are stale or gone. Handing those URLs back for
# a pending or ended programme is what made the replay watch API carry live
# HLS data: the viewer page then showed a dead line/quality picker instead
# of the recorded file it was actually meant to play.
if stream.status != StreamStatus.live:
return {
"lines": [],
"qualities": [],
"multicast_available": multicast_detector.is_available(),
"selected_node": None,
}
qualities = self.watch_renditions(stream) qualities = self.watch_renditions(stream)
best_node = lb.select_best_node(client_ip) best_node = lb.select_best_node(client_ip)
if not best_node: if not best_node:
@@ -18,6 +18,7 @@ class StreamAccessSerializationTest(unittest.TestCase):
"ended_at": None, "ended_at": None,
"multicast_enabled": False, "multicast_enabled": False,
"replay_file": None, "replay_file": None,
"replay_url": None,
"chapters_json": "[]", "chapters_json": "[]",
"transcode_profile": "default", "transcode_profile": "default",
"homepage_visible": False, "homepage_visible": False,
+137
View File
@@ -0,0 +1,137 @@
import unittest
from datetime import datetime
from unittest.mock import patch
from fastapi import HTTPException
from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
from database import Base
from models.audit import ViewerSession
from models.stream import StreamStatus
from routes.streams import (
ViewerHeartbeat,
_parse_scheduled_at,
poll_remote_command,
viewer_heartbeat,
)
from services import stream_service as stream_service_module
from services.stream_service import StreamService
def _multicast_off():
"""Keep the watch-URL tests off the network; the probe is a real socket call."""
return patch.object(stream_service_module.multicast_detector, "is_available", return_value=False)
class StreamTestBase(unittest.IsolatedAsyncioTestCase):
async def asyncSetUp(self):
self.engine = create_async_engine("sqlite+aiosqlite:///:memory:")
async with self.engine.begin() as connection:
await connection.run_sync(Base.metadata.create_all)
self.session_factory = async_sessionmaker(self.engine, expire_on_commit=False)
async def asyncTearDown(self):
await self.engine.dispose()
async def make_stream(self, **fields):
async with self.session_factory() as session:
stream = await StreamService(session).create_stream(title="Programme")
if fields:
await StreamService(session).update_stream(stream.id, **fields)
return stream.id, stream.stream_key
class WatchUrlScopeTest(StreamTestBase):
"""The watch API must not mix live HLS into a programme that is not on air."""
async def test_ended_programme_exposes_no_live_hls_lines(self):
_, key = await self.make_stream(status=StreamStatus.ended, replay_url="https://cdn.example.com/vod.mp4")
with _multicast_off():
async with self.session_factory() as session:
urls = await StreamService(session).get_watch_urls(key, None)
self.assertEqual(urls["lines"], [])
self.assertEqual(urls["qualities"], [])
self.assertIsNone(urls["selected_node"])
async def test_pending_programme_exposes_no_live_hls_lines_yet(self):
_, key = await self.make_stream(status=StreamStatus.pending)
with _multicast_off():
async with self.session_factory() as session:
urls = await StreamService(session).get_watch_urls(key, None)
self.assertEqual(urls["lines"], [])
self.assertEqual(urls["qualities"], [])
async def test_live_programme_still_exposes_hls_lines_and_renditions(self):
_, key = await self.make_stream(status=StreamStatus.live)
with _multicast_off():
async with self.session_factory() as session:
urls = await StreamService(session).get_watch_urls(key, None)
self.assertEqual(len(urls["lines"]), 1)
line = urls["lines"][0]
self.assertEqual(line["url"], f"/hls/{key}/index.m3u8")
self.assertTrue(line["qualities"])
self.assertTrue(urls["qualities"])
# The stream-copy rendition leads the ladder and is served from its slug.
self.assertEqual(line["qualities"][0]["url"], f"/hls/{key}/source/index.m3u8")
self.assertIsNotNone(urls["selected_node"])
class ViewerAuditScopeTest(StreamTestBase):
"""Viewer heartbeats and remote control exist for live playback only."""
async def test_heartbeat_is_a_noop_for_a_replay_programme(self):
stream_id, _ = await self.make_stream(status=StreamStatus.ended)
async with self.session_factory() as session:
payload = await viewer_heartbeat(
stream_id, ViewerHeartbeat(session_id="viewer-replay"), session
)
self.assertTrue(payload["ok"])
self.assertFalse(payload["remote_adjusted"])
self.assertFalse(payload["audit_active"])
async with self.session_factory() as session:
self.assertIsNone(await session.get(ViewerSession, "viewer-replay"))
async def test_heartbeat_registers_a_session_for_a_live_programme(self):
stream_id, _ = await self.make_stream(status=StreamStatus.live, remote_control_enabled=True)
async with self.session_factory() as session:
payload = await viewer_heartbeat(
stream_id, ViewerHeartbeat(session_id="viewer-live", quality="720p"), session
)
self.assertTrue(payload["ok"])
async with self.session_factory() as session:
viewer = await session.get(ViewerSession, "viewer-live")
self.assertIsNotNone(viewer)
self.assertEqual(viewer.quality, "720p")
async def test_remote_command_poll_stays_closed_for_a_replay_programme(self):
stream_id, _ = await self.make_stream(status=StreamStatus.ended, remote_control_enabled=True)
async with self.session_factory() as session:
self.assertIsNone(await poll_remote_command(stream_id, "viewer-replay", session))
async def test_remote_command_poll_stays_closed_without_an_opt_in(self):
stream_id, _ = await self.make_stream(status=StreamStatus.live, remote_control_enabled=False)
async with self.session_factory() as session:
self.assertIsNone(await poll_remote_command(stream_id, "viewer-live", session))
class ScheduledAtParseTest(unittest.TestCase):
"""The PUT route has to turn the client's ISO string into a datetime itself."""
def test_iso_z_suffix_is_stored_as_naive_utc(self):
self.assertEqual(
_parse_scheduled_at("2026-08-12T21:49:12.000Z"),
datetime(2026, 8, 12, 21, 49, 12),
)
def test_empty_values_clear_the_schedule(self):
self.assertIsNone(_parse_scheduled_at(None))
self.assertIsNone(_parse_scheduled_at(" "))
def test_invalid_value_is_rejected_with_422(self):
with self.assertRaises(HTTPException) as caught:
_parse_scheduled_at("not-a-date")
self.assertEqual(caught.exception.status_code, 422)
if __name__ == "__main__":
unittest.main()
+1 -2
View File
@@ -2,9 +2,8 @@
<html lang="zh-CN"> <html lang="zh-CN">
<head> <head>
<meta charset="UTF-8" /> <meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>StreamCore</title> <title> </title>
</head> </head>
<body> <body>
<div id="root"></div> <div id="root"></div>
Binary file not shown.

After

Width:  |  Height:  |  Size: 9.2 KiB

-1
View File
@@ -1 +0,0 @@
<svg xmlns="http://www.w3.org/2000/svg" width="48" height="46" fill="none" viewBox="0 0 48 46"><path fill="#863bff" d="M25.946 44.938c-.664.845-2.021.375-2.021-.698V33.937a2.26 2.26 0 0 0-2.262-2.262H10.287c-.92 0-1.456-1.04-.92-1.788l7.48-10.471c1.07-1.497 0-3.578-1.842-3.578H1.237c-.92 0-1.456-1.04-.92-1.788L10.013.474c.214-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.471c-1.07 1.498 0 3.579 1.842 3.579h11.377c.943 0 1.473 1.088.89 1.83L25.947 44.94z" style="fill:#863bff;fill:color(display-p3 .5252 .23 1);fill-opacity:1"/><mask id="a" width="48" height="46" x="0" y="0" maskUnits="userSpaceOnUse" style="mask-type:alpha"><path fill="#000" d="M25.842 44.938c-.664.844-2.021.375-2.021-.698V33.937a2.26 2.26 0 0 0-2.262-2.262H10.183c-.92 0-1.456-1.04-.92-1.788l7.48-10.471c1.07-1.498 0-3.579-1.842-3.579H1.133c-.92 0-1.456-1.04-.92-1.787L9.91.473c.214-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.471c-1.07 1.498 0 3.578 1.842 3.578h11.377c.943 0 1.473 1.088.89 1.832L25.843 44.94z" style="fill:#000;fill-opacity:1"/></mask><g mask="url(#a)"><g filter="url(#b)"><ellipse cx="5.508" cy="14.704" fill="#ede6ff" rx="5.508" ry="14.704" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -4.47 31.516)"/></g><g filter="url(#c)"><ellipse cx="10.399" cy="29.851" fill="#ede6ff" rx="10.399" ry="29.851" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -39.328 7.883)"/></g><g filter="url(#d)"><ellipse cx="5.508" cy="30.487" fill="#7e14ff" rx="5.508" ry="30.487" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.814 -25.913 -14.639)scale(1 -1)"/></g><g filter="url(#e)"><ellipse cx="5.508" cy="30.599" fill="#7e14ff" rx="5.508" ry="30.599" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.814 -32.644 -3.334)scale(1 -1)"/></g><g filter="url(#f)"><ellipse cx="5.508" cy="30.599" fill="#7e14ff" rx="5.508" ry="30.599" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -34.34 30.47)"/></g><g filter="url(#g)"><ellipse cx="14.072" cy="22.078" fill="#ede6ff" rx="14.072" ry="22.078" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="rotate(93.35 24.506 48.493)scale(-1 1)"/></g><g filter="url(#h)"><ellipse cx="3.47" cy="21.501" fill="#7e14ff" rx="3.47" ry="21.501" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.009 28.708 47.59)scale(-1 1)"/></g><g filter="url(#i)"><ellipse cx="3.47" cy="21.501" fill="#7e14ff" rx="3.47" ry="21.501" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.009 28.708 47.59)scale(-1 1)"/></g><g filter="url(#j)"><ellipse cx=".387" cy="8.972" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(39.51 .387 8.972)"/></g><g filter="url(#k)"><ellipse cx="47.523" cy="-6.092" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 47.523 -6.092)"/></g><g filter="url(#l)"><ellipse cx="41.412" cy="6.333" fill="#47bfff" rx="5.971" ry="9.665" style="fill:#47bfff;fill:color(display-p3 .2799 .748 1);fill-opacity:1" transform="rotate(37.892 41.412 6.333)"/></g><g filter="url(#m)"><ellipse cx="-1.879" cy="38.332" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 -1.88 38.332)"/></g><g filter="url(#n)"><ellipse cx="-1.879" cy="38.332" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 -1.88 38.332)"/></g><g filter="url(#o)"><ellipse cx="35.651" cy="29.907" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 35.651 29.907)"/></g><g filter="url(#p)"><ellipse cx="38.418" cy="32.4" fill="#47bfff" rx="5.971" ry="15.297" style="fill:#47bfff;fill:color(display-p3 .2799 .748 1);fill-opacity:1" transform="rotate(37.892 38.418 32.4)"/></g></g><defs><filter id="b" width="60.045" height="41.654" x="-19.77" y="16.149" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="c" width="90.34" height="51.437" x="-54.613" y="-7.533" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filtLine truncated

Before

Width:  |  Height:  |  Size: 9.3 KiB

-24
View File
@@ -1,24 +0,0 @@
<svg xmlns="http://www.w3.org/2000/svg">
<symbol id="bluesky-icon" viewBox="0 0 16 17">
<g clip-path="url(#bluesky-clip)"><path fill="#08060d" d="M7.75 7.735c-.693-1.348-2.58-3.86-4.334-5.097-1.68-1.187-2.32-.981-2.74-.79C.188 2.065.1 2.812.1 3.251s.241 3.602.398 4.13c.52 1.744 2.367 2.333 4.07 2.145-2.495.37-4.71 1.278-1.805 4.512 3.196 3.309 4.38-.71 4.987-2.746.608 2.036 1.307 5.91 4.93 2.746 2.72-2.746.747-4.143-1.747-4.512 1.702.189 3.55-.4 4.07-2.145.156-.528.397-3.691.397-4.13s-.088-1.186-.575-1.406c-.42-.19-1.06-.395-2.741.79-1.755 1.24-3.64 3.752-4.334 5.099"/></g>
<defs><clipPath id="bluesky-clip"><path fill="#fff" d="M.1.85h15.3v15.3H.1z"/></clipPath></defs>
</symbol>
<symbol id="discord-icon" viewBox="0 0 20 19">
<path fill="#08060d" d="M16.224 3.768a14.5 14.5 0 0 0-3.67-1.153c-.158.286-.343.67-.47.976a13.5 13.5 0 0 0-4.067 0c-.128-.306-.317-.69-.476-.976A14.4 14.4 0 0 0 3.868 3.77C1.546 7.28.916 10.703 1.231 14.077a14.7 14.7 0 0 0 4.5 2.306q.545-.748.965-1.587a9.5 9.5 0 0 1-1.518-.74q.191-.14.372-.293c2.927 1.369 6.107 1.369 8.999 0q.183.152.372.294-.723.437-1.52.74.418.838.963 1.588a14.6 14.6 0 0 0 4.504-2.308c.37-3.911-.63-7.302-2.644-10.309m-9.13 8.234c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.894 0 1.614.82 1.599 1.82.001 1-.705 1.82-1.6 1.82m5.91 0c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.893 0 1.614.82 1.599 1.82 0 1-.706 1.82-1.6 1.82"/>
</symbol>
<symbol id="documentation-icon" viewBox="0 0 21 20">
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="m15.5 13.333 1.533 1.322c.645.555.967.833.967 1.178s-.322.623-.967 1.179L15.5 18.333m-3.333-5-1.534 1.322c-.644.555-.966.833-.966 1.178s.322.623.966 1.179l1.534 1.321"/>
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M17.167 10.836v-4.32c0-1.41 0-2.117-.224-2.68-.359-.906-1.118-1.621-2.08-1.96-.599-.21-1.349-.21-2.848-.21-2.623 0-3.935 0-4.983.369-1.684.591-3.013 1.842-3.641 3.428C3 6.449 3 7.684 3 10.154v2.122c0 2.558 0 3.838.706 4.726q.306.383.713.671c.76.536 1.79.64 3.581.66"/>
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M3 10a2.78 2.78 0 0 1 2.778-2.778c.555 0 1.209.097 1.748-.047.48-.129.854-.503.982-.982.145-.54.048-1.194.048-1.749a2.78 2.78 0 0 1 2.777-2.777"/>
</symbol>
<symbol id="github-icon" viewBox="0 0 19 19">
<path fill="#08060d" fill-rule="evenodd" d="M9.356 1.85C5.05 1.85 1.57 5.356 1.57 9.694a7.84 7.84 0 0 0 5.324 7.44c.387.079.528-.168.528-.376 0-.182-.013-.805-.013-1.454-2.165.467-2.616-.935-2.616-.935-.349-.91-.864-1.143-.864-1.143-.71-.48.051-.48.051-.48.787.051 1.2.805 1.2.805.695 1.194 1.817.857 2.268.649.064-.507.27-.857.49-1.052-1.728-.182-3.545-.857-3.545-3.87 0-.857.31-1.558.8-2.104-.078-.195-.349-1 .077-2.078 0 0 .657-.208 2.14.805a7.5 7.5 0 0 1 1.946-.26c.657 0 1.328.092 1.946.26 1.483-1.013 2.14-.805 2.14-.805.426 1.078.155 1.883.078 2.078.502.546.799 1.247.799 2.104 0 3.013-1.818 3.675-3.558 3.87.284.247.528.714.528 1.454 0 1.052-.012 1.896-.012 2.156 0 .208.142.455.528.377a7.84 7.84 0 0 0 5.324-7.441c.013-4.338-3.48-7.844-7.773-7.844" clip-rule="evenodd"/>
</symbol>
<symbol id="social-icon" viewBox="0 0 20 20">
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M12.5 6.667a4.167 4.167 0 1 0-8.334 0 4.167 4.167 0 0 0 8.334 0"/>
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M2.5 16.667a5.833 5.833 0 0 1 8.75-5.053m3.837.474.513 1.035c.07.144.257.282.414.309l.93.155c.596.1.736.536.307.965l-.723.73a.64.64 0 0 0-.152.531l.207.903c.164.715-.213.991-.84.618l-.872-.52a.63.63 0 0 0-.577 0l-.872.52c-.624.373-1.003.094-.84-.618l.207-.903a.64.64 0 0 0-.152-.532l-.723-.729c-.426-.43-.289-.864.306-.964l.93-.156a.64.64 0 0 0 .412-.31l.513-1.034c.28-.562.735-.562 1.012 0"/>
</symbol>
<symbol id="x-icon" viewBox="0 0 19 19">
<path fill="#08060d" fill-rule="evenodd" d="M1.893 1.98c.052.072 1.245 1.769 2.653 3.77l2.892 4.114c.183.261.333.48.333.486s-.068.089-.152.183l-.522.593-.765.867-3.597 4.087c-.375.426-.734.834-.798.905a1 1 0 0 0-.118.148c0 .01.236.017.664.017h.663l.729-.83c.4-.457.796-.906.879-.999a692 692 0 0 0 1.794-2.038c.034-.037.301-.34.594-.675l.551-.624.345-.392a7 7 0 0 1 .34-.374c.006 0 .93 1.306 2.052 2.903l2.084 2.965.045.063h2.275c1.87 0 2.273-.003 2.266-.021-.008-.02-1.098-1.572-3.894-5.547-2.013-2.862-2.28-3.246-2.273-3.266.008-.019.282-.332 2.085-2.38l2-2.274 1.567-1.782c.022-.028-.016-.03-.65-.03h-.674l-.3.342a871 871 0 0 1-1.782 2.025c-.067.075-.405.458-.75.852a100 100 0 0 1-.803.91c-.148.172-.299.344-.99 1.127-.304.343-.32.358-.345.327-.015-.019-.904-1.282-1.976-2.808L6.365 1.85H1.8zm1.782.91 8.078 11.294c.772 1.08 1.413 1.973 1.425 1.984.016.017.241.02 1.05.017l1.03-.004-2.694-3.766L7.796 5.75 5.722 2.852l-1.039-.004-1.039-.004z" clip-rule="evenodd"/>
</symbol>
</svg>

Before

Width:  |  Height:  |  Size: 4.9 KiB

+2 -1
View File
@@ -91,7 +91,8 @@ function RouteShell() {
<Route path="board" element={<LiveBoard />} /> <Route path="board" element={<LiveBoard />} />
<Route path="streams" element={<StreamList />} /> <Route path="streams" element={<StreamList />} />
<Route path="streams/new" element={<StreamForm />} /> <Route path="streams/new" element={<StreamForm />} />
<Route path="streams/:id/edit" element={<ReplayEditor />} /> <Route path="streams/:id/edit" element={<StreamForm />} />
<Route path="streams/:id/replay" element={<ReplayEditor />} />
<Route path="nodes" element={<NodeManager />} /> <Route path="nodes" element={<NodeManager />} />
<Route path="settings" element={<SettingsPage />} /> <Route path="settings" element={<SettingsPage />} />
<Route path="swagger" element={<SwaggerPage />} /> <Route path="swagger" element={<SwaggerPage />} />
+20 -3
View File
@@ -3,6 +3,7 @@ import { RefreshCw, Maximize2, Minimize2, Users, Signal, TriangleAlert, Cpu, Mem
import { toast } from 'sonner' import { toast } from 'sonner'
import { Button } from '@/components/ui/button' import { Button } from '@/components/ui/button'
import { Badge } from '@/components/ui/badge' import { Badge } from '@/components/ui/badge'
import { Alert, AlertDescription, AlertTitle } from '@/components/ui/alert'
import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card' import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
import { import {
Select, Select,
@@ -65,9 +66,13 @@ export default function LiveBoard() {
const programs = await fetchStreams(true) const programs = await fetchStreams(true)
setStreams(programs) setStreams(programs)
const nextId = streamId || programs.find((p) => p.status === 'live')?.id const nextId = streamId || programs.find((p) => p.status === 'live')?.id
const nextProgram = programs.find((p) => p.id === nextId)
if (nextId) { if (nextId) {
setStreamId(nextId) setStreamId(nextId)
setSessions(await fetchViewerSessions(nextId)) // Viewer sessions audit live playback. A replay produces none — and rows
// left over from when the programme was live would describe a broadcast
// that is over — so nothing is fetched for a non-live programme.
setSessions(nextProgram?.status === 'live' ? await fetchViewerSessions(nextId) : [])
} else { } else {
setSessions([]) setSessions([])
} }
@@ -105,10 +110,13 @@ export default function LiveBoard() {
if (nodeId === 'auto' && quality === 'auto') await sendRemoteCommand(streamId, session.token, 'restore_auto', targets) if (nodeId === 'auto' && quality === 'auto') await sendRemoteCommand(streamId, session.token, 'restore_auto', targets)
toast.success(`已向 ${selected.size} 个观众下发节点与清晰度策略`) toast.success(`已向 ${selected.size} 个观众下发节点与清晰度策略`)
} catch { } catch {
toast.error('控制命令下发失败,请确认节目已启用审计式播放控制') toast.error('控制命令下发失败,请确认节目正在直播并已启用审计式播放控制')
} }
} }
const selectedProgram = streams.find((p) => p.id === streamId)
const isLiveProgram = selectedProgram?.status === 'live'
const activeSessions = sessions.filter((s) => Date.now() - new Date(s.last_heartbeat).getTime() < 30000) const activeSessions = sessions.filter((s) => Date.now() - new Date(s.last_heartbeat).getTime() < 30000)
const buffering = activeSessions.filter( const buffering = activeSessions.filter(
(s) => s.playback_state === 'buffering' || Number(s.buffered_seconds || 0) < 1, (s) => s.playback_state === 'buffering' || Number(s.buffered_seconds || 0) < 1,
@@ -187,7 +195,16 @@ export default function LiveBoard() {
</CardContent> </CardContent>
</Card> </Card>
{streamId && ( {streamId && !isLiveProgram && (
<Alert>
<AlertTitle>观众会话审计仅适用于直播</AlertTitle>
<AlertDescription>
当前选中的节目不是直播状态。回放是直接下发的录制文件,没有线路、清晰度或播放控制可审计,因此不产生观众会话。
</AlertDescription>
</Alert>
)}
{streamId && isLiveProgram && (
<Card> <Card>
<CardHeader className="flex-row items-center justify-between space-y-0"> <CardHeader className="flex-row items-center justify-between space-y-0">
<CardTitle className="text-base">审计式观众会话</CardTitle> <CardTitle className="text-base">审计式观众会话</CardTitle>
+11 -5
View File
@@ -1,6 +1,6 @@
import { useEffect, useRef, useState } from 'react' import { useEffect, useRef, useState } from 'react'
import { useNavigate, useParams } from 'react-router-dom' import { useNavigate, useParams } from 'react-router-dom'
import { ArrowLeft, ArrowDown, ArrowUp, Trash2, Plus } from 'lucide-react' import { ArrowLeft, ArrowDown, ArrowUp, Trash2, Plus, Pencil } from 'lucide-react'
import { toast } from 'sonner' import { toast } from 'sonner'
import { Button } from '@/components/ui/button' import { Button } from '@/components/ui/button'
import { Input } from '@/components/ui/input' import { Input } from '@/components/ui/input'
@@ -123,10 +123,16 @@ export default function ReplayEditor() {
return ( return (
<div className="mx-auto max-w-4xl"> <div className="mx-auto max-w-4xl">
<Button variant="ghost" className="mb-5" onClick={() => navigate('/admin/streams')}> <div className="mb-5 flex flex-wrap gap-2">
<ArrowLeft className="h-4 w-4" /> <Button variant="ghost" onClick={() => navigate('/admin/streams')}>
返回节目列表 <ArrowLeft className="h-4 w-4" />
</Button> 返回节目列表
</Button>
<Button variant="ghost" onClick={() => navigate(`/admin/streams/${stream.id}/edit`)}>
<Pencil className="h-4 w-4" />
编辑节目属性
</Button>
</div>
<PageHeader title="回放与章节" kicker="Replay" description={stream.title} /> <PageHeader title="回放与章节" kicker="Replay" description={stream.title} />
{!isEditable ? ( {!isEditable ? (
+158 -33
View File
@@ -1,6 +1,6 @@
import { useState } from 'react' import { useEffect, useState } from 'react'
import { useNavigate } from 'react-router-dom' import { useNavigate, useParams } from 'react-router-dom'
import { Copy, ArrowLeft, CheckCircle2, Plus, Trash2 } from 'lucide-react' import { Copy, ArrowLeft, CheckCircle2, Plus, Trash2, Clapperboard } from 'lucide-react'
import { toast } from 'sonner' import { toast } from 'sonner'
import axios from 'axios' import axios from 'axios'
import { Button } from '@/components/ui/button' import { Button } from '@/components/ui/button'
@@ -16,7 +16,7 @@ import {
SelectTrigger, SelectTrigger,
SelectValue, SelectValue,
} from '@/components/ui/select' } from '@/components/ui/select'
import { createStream, type RenditionConfig } from '@/api/streams' import { createStream, getStream, updateStream, type RenditionConfig } from '@/api/streams'
const DEFAULT_RENDITIONS: RenditionConfig[] = [ const DEFAULT_RENDITIONS: RenditionConfig[] = [
{ label: '1080p', enabled: true, width: 1920, height: 1080, fps: 30, codec: 'libx264', bitrate: '5000k', crf: 23, preset: 'veryfast', audio_bitrate: '128k', keyframe_seconds: 2 }, { label: '1080p', enabled: true, width: 1920, height: 1080, fps: 30, codec: 'libx264', bitrate: '5000k', crf: 23, preset: 'veryfast', audio_bitrate: '128k', keyframe_seconds: 2 },
@@ -25,8 +25,28 @@ const DEFAULT_RENDITIONS: RenditionConfig[] = [
const PRESETS = ['ultrafast', 'superfast', 'veryfast', 'faster', 'fast', 'medium', 'slow'] const PRESETS = ['ultrafast', 'superfast', 'veryfast', 'faster', 'fast', 'medium', 'slow']
/**
* Render a stored schedule for a datetime-local input.
*
* Rows hold naive UTC ("2026-08-12 21:49:12"). Without the trailing Z the browser
* would read that as local time and shift the schedule by the UTC offset, which is
* exactly how a freshly created programme came back looking hours off.
*/
function toScheduledInput(value?: string | null): string {
if (!value) return ''
const normalized = /(?:[zZ]|[+-]\d{2}:?\d{2})$/.test(value) ? value : `${value.replace(' ', 'T')}Z`
const date = new Date(normalized)
if (Number.isNaN(date.getTime())) return ''
const pad = (n: number) => String(n).padStart(2, '0')
return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}T${pad(date.getHours())}:${pad(date.getMinutes())}`
}
export default function StreamForm() { export default function StreamForm() {
const navigate = useNavigate() const navigate = useNavigate()
const { id } = useParams<{ id: string }>()
const streamId = Number(id)
const isEdit = Number.isInteger(streamId) && streamId > 0
const [title, setTitle] = useState('') const [title, setTitle] = useState('')
const [description, setDescription] = useState('') const [description, setDescription] = useState('')
const [coverUrl, setCoverUrl] = useState('') const [coverUrl, setCoverUrl] = useState('')
@@ -35,9 +55,47 @@ export default function StreamForm() {
const [homepageVisible, setHomepageVisible] = useState(true) const [homepageVisible, setHomepageVisible] = useState(true)
const [remoteControl, setRemoteControl] = useState(false) const [remoteControl, setRemoteControl] = useState(false)
const [renditions, setRenditions] = useState<RenditionConfig[]>(DEFAULT_RENDITIONS) const [renditions, setRenditions] = useState<RenditionConfig[]>(DEFAULT_RENDITIONS)
// True once the ladder is either stored on the programme or edited here. While it
// is false the form is only *showing* the preset's fallback tiers, and the update
// must not send them: that would silently pin the preset into a custom ladder.
const [renditionsPinned, setRenditionsPinned] = useState(false)
const [streamKey, setStreamKey] = useState('')
const [streamStatus, setStreamStatus] = useState('')
const [loadingData, setLoadingData] = useState(isEdit)
const [loading, setLoading] = useState(false) const [loading, setLoading] = useState(false)
const [result, setResult] = useState<{ rtmp_url: string; stream_key: string } | null>(null) const [result, setResult] = useState<{ rtmp_url: string; stream_key: string } | null>(null)
// Edit mode loads the programme first so every property starts at its stored
// value instead of the form defaults.
useEffect(() => {
if (!isEdit) return
let active = true
getStream(streamId)
.then((program) => {
if (!active) return
setTitle(program.title)
setDescription(program.description ?? '')
setCoverUrl(program.cover_url ?? '')
setScheduledAt(toScheduledInput(program.scheduled_at))
setTranscodeProfile(program.transcode_profile || 'standard')
setHomepageVisible(program.homepage_visible)
setRemoteControl(program.remote_control_enabled)
setStreamKey(program.stream_key ?? '')
setStreamStatus(program.status)
if (program.renditions?.length) {
setRenditions(program.renditions)
setRenditionsPinned(true)
}
})
.catch(() => toast.error('无法载入节目信息'))
.finally(() => {
if (active) setLoadingData(false)
})
return () => {
active = false
}
}, [isEdit, streamId])
const handleSubmit = async (e: React.FormEvent) => { const handleSubmit = async (e: React.FormEvent) => {
e.preventDefault() e.preventDefault()
if (!title.trim()) { if (!title.trim()) {
@@ -45,31 +103,69 @@ export default function StreamForm() {
return return
} }
setLoading(true) setLoading(true)
const schedule = scheduledAt ? new Date(scheduledAt).toISOString() : null
try { try {
const res = await createStream({ if (isEdit) {
title: title.trim(), await updateStream(streamId, {
description: description || undefined, title: title.trim(),
cover_url: coverUrl || undefined, description: description.trim() || null,
scheduled_at: scheduledAt ? new Date(scheduledAt).toISOString() : undefined, cover_url: coverUrl.trim() || null,
transcode_profile: transcodeProfile, scheduled_at: schedule,
homepage_visible: homepageVisible, transcode_profile: transcodeProfile,
remote_control_enabled: remoteControl, homepage_visible: homepageVisible,
renditions, remote_control_enabled: remoteControl,
}) ...(renditionsPinned ? { renditions } : {}),
setResult({ rtmp_url: res.rtmp_url, stream_key: res.stream_key }) })
toast.success('直播已创建') toast.success('节目属性已更新')
navigate('/admin/streams')
} else {
const res = await createStream({
title: title.trim(),
description: description.trim() || null,
cover_url: coverUrl.trim() || null,
scheduled_at: schedule,
transcode_profile: transcodeProfile,
homepage_visible: homepageVisible,
remote_control_enabled: remoteControl,
renditions,
})
setResult({ rtmp_url: res.rtmp_url, stream_key: res.stream_key })
toast.success('直播已创建')
}
} catch (error) { } catch (error) {
const detail = axios.isAxiosError(error) ? error.response?.data?.detail : undefined const detail = axios.isAxiosError(error) ? error.response?.data?.detail : undefined
toast.error(typeof detail === 'string' ? detail : '创建失败,请稍后重试') toast.error(typeof detail === 'string' ? detail : isEdit ? '保存失败,请稍后重试' : '创建失败,请稍后重试')
} finally { } finally {
setLoading(false) setLoading(false)
} }
} }
const updateRendition = (index: number, patch: Partial<RenditionConfig>) => { const updateRendition = (index: number, patch: Partial<RenditionConfig>) => {
setRenditionsPinned(true)
setRenditions((cur) => cur.map((r, i) => (i === index ? { ...r, ...patch } : r))) setRenditions((cur) => cur.map((r, i) => (i === index ? { ...r, ...patch } : r)))
} }
const removeRendition = (index: number) => {
setRenditionsPinned(true)
setRenditions((cur) => cur.filter((_, i) => i !== index))
}
const addRendition = () => {
setRenditionsPinned(true)
setRenditions((cur) => [
...cur,
{ label: '480p', enabled: true, width: 854, height: 480, fps: 30, codec: 'libx264', bitrate: '1000k', crf: 23, preset: 'veryfast', audio_bitrate: '128k', keyframe_seconds: 2 },
])
}
if (loadingData) {
return (
<div className="flex justify-center py-24">
<div className="h-8 w-8 animate-spin rounded-full border-2 border-primary border-t-transparent" />
</div>
)
}
if (result) { if (result) {
return ( return (
<div className="mx-auto max-w-2xl"> <div className="mx-auto max-w-2xl">
@@ -116,10 +212,45 @@ export default function StreamForm() {
返回列表 返回列表
</Button> </Button>
{isEdit && (
<Card className="mb-5">
<CardContent className="flex flex-wrap items-center justify-between gap-3 pt-6">
<div className="min-w-0">
<Label className="text-xs uppercase tracking-wide text-muted-foreground">推流码</Label>
<div className="mt-1 truncate font-mono text-sm">{streamKey || '—'}</div>
</div>
<div className="flex items-center gap-2">
<Button
type="button"
variant="outline"
size="sm"
onClick={() => {
navigator.clipboard.writeText(streamKey)
toast.success('已复制推流码')
}}
disabled={!streamKey}
>
<Copy className="h-4 w-4" />
复制
</Button>
<Button type="button" variant="outline" size="sm" onClick={() => navigate(`/admin/streams/${streamId}/replay`)}>
<Clapperboard className="h-4 w-4" />
回放与章节
</Button>
</div>
{streamStatus && streamStatus !== 'ended' && (
<p className="w-full text-xs text-muted-foreground">回放与章节需在节目结束后配置</p>
)}
</CardContent>
</Card>
)}
<Card> <Card>
<CardHeader> <CardHeader>
<CardTitle className="text-2xl">创建节目</CardTitle> <CardTitle className="text-2xl">{isEdit ? '编辑节目' : '创建节目'}</CardTitle>
<p className="text-sm text-muted-foreground">填写节目信息并预约播出,系统将生成推流码与 RTMP 地址</p> <p className="text-sm text-muted-foreground">
{isEdit ? '修改标题、简介、排期与转码参数,保存后立即生效' : '填写节目信息并预约播出,系统将生成推流码与 RTMP 地址'}
</p>
</CardHeader> </CardHeader>
<CardContent> <CardContent>
<form onSubmit={handleSubmit} className="space-y-5"> <form onSubmit={handleSubmit} className="space-y-5">
@@ -150,7 +281,10 @@ export default function StreamForm() {
<SelectItem value="bandwidth-saver">带宽节省</SelectItem> <SelectItem value="bandwidth-saver">带宽节省</SelectItem>
</SelectContent> </SelectContent>
</Select> </Select>
<p className="text-xs text-muted-foreground">可直接使用预设,也可在下方逐档调整参数</p> <p className="text-xs text-muted-foreground">
可直接使用预设,也可在下方逐档调整参数
{isEdit && !renditionsPinned && ';当前沿用预设档位,修改任意一档后才会保存为自定义清晰度'}
</p>
</div> </div>
<div className="space-y-3"> <div className="space-y-3">
@@ -166,7 +300,7 @@ export default function StreamForm() {
onChange={(e) => updateRendition(index, { label: e.target.value })} onChange={(e) => updateRendition(index, { label: e.target.value })}
/> />
</div> </div>
<Button variant="ghost" size="icon" onClick={() => setRenditions((cur) => cur.filter((_, i) => i !== index))}> <Button type="button" variant="ghost" size="icon" onClick={() => removeRendition(index)}>
<Trash2 className="h-4 w-4 text-destructive" /> <Trash2 className="h-4 w-4 text-destructive" />
</Button> </Button>
</div> </div>
@@ -225,16 +359,7 @@ export default function StreamForm() {
</div> </div>
</div> </div>
))} ))}
<Button <Button type="button" variant="outline" onClick={addRendition}>
type="button"
variant="outline"
onClick={() =>
setRenditions((cur) => [
...cur,
{ label: '480p', enabled: true, width: 854, height: 480, fps: 30, codec: 'libx264', bitrate: '1000k', crf: 23, preset: 'veryfast', audio_bitrate: '128k', keyframe_seconds: 2 },
])
}
>
<Plus className="h-4 w-4" /> <Plus className="h-4 w-4" />
添加清晰度 添加清晰度
</Button> </Button>
@@ -250,13 +375,13 @@ export default function StreamForm() {
<div className="flex items-center justify-between rounded-md border border-border p-3"> <div className="flex items-center justify-between rounded-md border border-border p-3">
<div> <div>
<Label>审计式观众播放控制</Label> <Label>审计式观众播放控制</Label>
<p className="text-xs text-muted-foreground">仅在明确启用后允许创建限时控制会话</p> <p className="text-xs text-muted-foreground">仅直播期间生效,回放观众不参与审计与控制</p>
</div> </div>
<Switch checked={remoteControl} onCheckedChange={setRemoteControl} /> <Switch checked={remoteControl} onCheckedChange={setRemoteControl} />
</div> </div>
<Button type="submit" className="h-11 w-full" disabled={loading}> <Button type="submit" className="h-11 w-full" disabled={loading}>
{loading ? '创建中…' : '创建节目'} {loading ? (isEdit ? '保存中…' : '创建中…') : isEdit ? '保存更改' : '创建节目'}
</Button> </Button>
</form> </form>
</CardContent> </CardContent>
+5 -2
View File
@@ -1,6 +1,6 @@
import { useState, useEffect } from 'react' import { useState, useEffect } from 'react'
import { useNavigate } from 'react-router-dom' import { useNavigate } from 'react-router-dom'
import { Plus, Play, Square, Trash2, Link, Eye, Pencil } from 'lucide-react' import { Plus, Play, Square, Trash2, Link, Eye, Pencil, Clapperboard } from 'lucide-react'
import { toast } from 'sonner' import { toast } from 'sonner'
import { Button } from '@/components/ui/button' import { Button } from '@/components/ui/button'
import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card' import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
@@ -152,9 +152,12 @@ export default function StreamList() {
<Button variant="ghost" size="icon" title="观看" onClick={() => window.open(`/watch/${s.id}`, '_blank')}> <Button variant="ghost" size="icon" title="观看" onClick={() => window.open(`/watch/${s.id}`, '_blank')}>
<Eye className="h-4 w-4" /> <Eye className="h-4 w-4" />
</Button> </Button>
<Button variant="ghost" size="icon" title="编辑" onClick={() => navigate(`/admin/streams/${s.id}/edit`)}> <Button variant="ghost" size="icon" title="编辑节目属性" onClick={() => navigate(`/admin/streams/${s.id}/edit`)}>
<Pencil className="h-4 w-4" /> <Pencil className="h-4 w-4" />
</Button> </Button>
<Button variant="ghost" size="icon" title="回放与章节" onClick={() => navigate(`/admin/streams/${s.id}/replay`)}>
<Clapperboard className="h-4 w-4" />
</Button>
<AlertDialog> <AlertDialog>
<AlertDialogTrigger asChild> <AlertDialogTrigger asChild>
<Button variant="ghost" size="icon" title="删除"> <Button variant="ghost" size="icon" title="删除">
+24 -4
View File
@@ -42,9 +42,9 @@ export interface Chapter {
export interface StreamCreateReq { export interface StreamCreateReq {
title: string title: string
description?: string description?: string | null
cover_url?: string cover_url?: string | null
scheduled_at?: string scheduled_at?: string | null
replay_file?: string | null replay_file?: string | null
replay_url?: string | null replay_url?: string | null
chapters?: Chapter[] chapters?: Chapter[]
@@ -146,7 +146,27 @@ export async function getStream(streamId: number): Promise<StreamInfo> {
return data return data
} }
export async function updateStream(streamId: number, req: Partial<StreamCreateReq>): Promise<void> { /**
* PUT payload for an existing programme. Unlike creation, every field is
* optional and nullable so an administrator can clear a value (e.g. remove the
* schedule) while editing the properties that until now could only be set on the
* create form.
*/
export interface StreamUpdateReq {
title?: string
description?: string | null
cover_url?: string | null
scheduled_at?: string | null
replay_file?: string | null
replay_url?: string | null
chapters?: Chapter[]
transcode_profile?: string
renditions?: RenditionConfig[] | null
homepage_visible?: boolean
remote_control_enabled?: boolean
}
export async function updateStream(streamId: number, req: StreamUpdateReq): Promise<void> {
await api.put(`/streams/${streamId}`, req) await api.put(`/streams/${streamId}`, req)
} }
+72 -11
View File
@@ -32,6 +32,15 @@ interface VideoPlayerProps {
const SEEK_STEP_SECONDS = 5 const SEEK_STEP_SECONDS = 5
const SPEED_OPTIONS = [0.5, 0.75, 1, 1.25, 1.5, 2] as const const SPEED_OPTIONS = [0.5, 0.75, 1, 1.25, 1.5, 2] as const
// hls.js expresses every buffer target in seconds, but the unit this player
// plans in is the TS segment: the encoder writes 4s segments (backend
// `hls_segment_seconds`) and keeps six of them in the live playlist. Four
// segments ahead is the queue the player is asked to hold, and playback starts
// on the first one — it never waits for that queue to fill.
const FALLBACK_SEGMENT_SECONDS = 4
const BUFFER_SEGMENTS = 4
const INITIAL_BUFFER_SECONDS = FALLBACK_SEGMENT_SECONDS * BUFFER_SEGMENTS
function formatTime(seconds: number) { function formatTime(seconds: number) {
if (!Number.isFinite(seconds)) return '00:00' if (!Number.isFinite(seconds)) return '00:00'
const value = Math.max(0, Math.floor(seconds)) const value = Math.max(0, Math.floor(seconds))
@@ -423,32 +432,63 @@ const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(function Vid
setLoading(false) setLoading(false)
onError?.('当前没有可用的播放地址') onError?.('当前没有可用的播放地址')
} else if (Hls.isSupported()) { } else if (Hls.isSupported()) {
// Buffering is the thing to avoid; chase latency only after that. hls.js // Buffering policy: start on the first TS, then hold a four-segment queue.
// measures latency to its own target rather than to the segment edge, so
// anything set here (liveSyncDurationCount, rate) has to be interpreted in
// its terms or the player and the UI disagree about what "behind" means.
// //
// Deliberately NOT enabled, all for the same reason — each pulls the target // hls.js's stock defaults assume a healthy link — a 500 kbps starting
// latency down to a single 4s segment, so playback races the encoder and // estimate, a bitrate probe before the first real segment, and a buffer
// re-buffers at the end of every segment: // that fills to 60MB (30s is only the floor; at 5 Mbps the byte budget
// alone is ~96s of media). On a link that cannot sustain that prefetch,
// the backlog starves playback behind its own downloads. So the queue is
// bounded to four 4s segments — both the floor and the byte budget — and
// the first segment is requested as early as possible. The bandwidth
// estimate starts low, so a weak link gets the first picture out
// immediately and ABR climbs from measurements instead of an assumption.
// Nothing here holds playback back until the queue is full: the player
// starts on segment one and refills four segments ahead of it.
//
// The settings below are the ones to avoid, all for the same reason: each
// pulls hls.js's latency target down to a single segment, so playback
// races the encoder and re-buffers at the end of every segment. hls.js
// measures latency to its own target rather than to the segment edge, so
// any value set there has to be read in its terms:
// lowLatencyMode: true target drops to the last *partial* segment // lowLatencyMode: true target drops to the last *partial* segment
// liveSyncDurationCount: 1 target = exactly one segment // liveSyncDurationCount: 1 target = exactly one segment
// maxLiveSyncPlaybackRate speeds playback up to 1.5x to hold that // maxLiveSyncPlaybackRate speeds playback up to 1.5x to hold that
// backBufferLength: 0 nothing behind the playhead to survive a stall // backBufferLength: 0 nothing behind the playhead to survive a stall
// The default three-segment (~12s) cushion is what keeps playback smooth.
const hls = new Hls({ const hls = new Hls({
enableWorker: true, enableWorker: true,
// Keeps recent segments available locally, so a brief stall is served // Keeps recent segments available locally, so a brief stall is served
// from the buffer instead of going back to the network. // from the buffer instead of going back to the network.
backBufferLength: 30, backBufferLength: 30,
// Start four segments behind the live edge. Only published segments
// can be buffered, so at hls.js's default of three the queue tops out
// at three TS no matter what the buffer target is; four is what makes
// the four-segment queue reachable. Playback still begins on the first
// segment that loads — the rest of the queue fills while it runs.
liveSyncDurationCount: BUFFER_SEGMENTS,
// Ask for the first TS as soon as the playlist is parsed, rather than
// after the media element finishes attaching. Playback itself still
// begins with that single segment.
startFragPrefetch: true,
// Four segments of look-ahead (hls.js treats this as the floor it must
// reach). LEVEL_LOADED re-derives it, along with the byte budget that
// is the actual ceiling, from the playlist and the loaded rendition.
maxBufferLength: INITIAL_BUFFER_SECONDS,
// Start on the lightest rendition and skip the bitrate probe that would
// delay the first segment; ABR takes over once data arrives.
startLevel: 0,
testBandwidth: false,
abrEwmaDefaultEstimate: 300_000,
}) })
hlsRef.current = hls hlsRef.current = hls
hls.loadSource(source) hls.loadSource(source)
hls.attachMedia(video) hls.attachMedia(video)
hls.on(Hls.Events.MANIFEST_PARSED, () => { hls.on(Hls.Events.MANIFEST_PARSED, () => {
setLoading(false) setLoading(false)
// For live, anchors playback to the end of the sliding window so a new // For live, anchors playback near the end of the sliding window —
// viewer starts at the live edge instead of the oldest retained segment. // liveSyncDurationCount segments back, so a new viewer starts close to
// the edge rather than at the oldest retained segment, while leaving the
// four-segment cushion in front of it.
hls.startLoad(live ? -1 : 0) hls.startLoad(live ? -1 : 0)
void attemptAutoplay(video) void attemptAutoplay(video)
}) })
@@ -463,6 +503,24 @@ const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(function Vid
// level names cannot override it. This only covers a fallback playlist whose // level names cannot override it. This only covers a fallback playlist whose
// rendition list we never received. // rendition list we never received.
hls.on(Hls.Events.LEVEL_LOADED, (_event, data) => { hls.on(Hls.Events.LEVEL_LOADED, (_event, data) => {
// The playlist is the authority on segment length: keep the queue at
// four segments even if the encoder was configured with a different
// `hls_segment_seconds` than the default this module starts from.
const segmentSeconds = data.details.targetduration || FALLBACK_SEGMENT_SECONDS
const bufferedAhead = segmentSeconds * BUFFER_SEGMENTS
if (hls.config.maxBufferLength !== bufferedAhead) {
hls.config.maxBufferLength = bufferedAhead
}
// `maxBufferLength` is only a floor in hls.js; the real ceiling is the
// byte budget (`maxBufferSize`), and the 60MB default buys ~96s at
// 5 Mbps — far more than four TS, and more than a slow link can
// sustain. Size that budget to exactly the four segments wanted so the
// ceiling lands on the floor. `maxMaxBufferLength` is deliberately
// left alone: hls.js lowers it itself when flush loops appear.
const bitrate = data.levelInfo.maxBitrate || data.levelInfo.bitrate
if (bitrate > 0) {
hls.config.maxBufferSize = Math.ceil((bitrate * bufferedAhead) / 8)
}
if (data.details.live && !hasQualities) onFallbackLoaded() if (data.details.live && !hasQualities) onFallbackLoaded()
}) })
hls.on(Hls.Events.ERROR, (_event, data) => { hls.on(Hls.Events.ERROR, (_event, data) => {
@@ -634,7 +692,10 @@ const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(function Vid
<video <video
ref={videoRef} ref={videoRef}
playsInline playsInline
preload="metadata" // A replay is a single file with a known size: let the browser start
// pulling it (and therefore start the first picture sooner) instead of
// fetching metadata only. Live is fed by MSE, where preload is moot.
preload={live ? 'metadata' : 'auto'}
// While the player is muted only because autoplay demanded it, a click on // While the player is muted only because autoplay demanded it, a click on
// the picture means "give me the sound", not "pause". Handling it here // the picture means "give me the sound", not "pause". Handling it here
// rather than with a window-level listener keeps the two in a known order: // rather than with a window-level listener keeps the two in a known order:
+31 -14
View File
@@ -62,6 +62,15 @@ export default function WatchPage() {
useEffect(() => { useEffect(() => {
const streamId = Number(id) const streamId = Number(id)
if (!Number.isInteger(streamId) || streamId <= 0 || !info) return if (!Number.isInteger(streamId) || streamId <= 0 || !info) return
// Audit control — viewer heartbeats and remote command polling — belongs to a
// live programme: node, rendition, buffering and remote adjustment only exist
// while it is on air. A replay is a recorded file served straight to the
// browser, so registering a session for it would add rows to the audit board
// that no one can act on. Replays therefore run with no audit traffic at all.
if (info.status !== 'live') {
setRemoteAdjusted(false)
return
}
const heartbeat = async () => { const heartbeat = async () => {
const video = getVideo() const video = getVideo()
@@ -345,17 +354,19 @@ export default function WatchPage() {
<span className="font-medium">{info.title}</span> <span className="font-medium">{info.title}</span>
<Badge variant={info.status === 'live' ? 'default' : 'secondary'}>{statusLabel}</Badge> <Badge variant={info.status === 'live' ? 'default' : 'secondary'}>{statusLabel}</Badge>
<div className="ml-auto flex flex-wrap items-center gap-2 text-xs"> {info.status === 'live' && (
<Badge variant="outline">节点:{currentLine?.node_name || info.selected_node?.name || '不可用'}</Badge> <div className="ml-auto flex flex-wrap items-center gap-2 text-xs">
<Badge variant="outline"> <Badge variant="outline">节点:{currentLine?.node_name || info.selected_node?.name || '不可用'}</Badge>
清晰度:{activeQuality === 'auto' ? `自动${autoQuality ? `(${autoQuality})` : ''}` : activeQuality || '不可用'} <Badge variant="outline">
</Badge> 清晰度:{activeQuality === 'auto' ? `自动${autoQuality ? `(${autoQuality})` : ''}` : activeQuality || '不可用'}
{remoteAdjusted && <Badge className="bg-amber-600">播放由管理员临时调整</Badge>} </Badge>
<span className="flex items-center gap-1.5 text-muted-foreground"> {remoteAdjusted && <Badge className="bg-amber-600">播放由管理员临时调整</Badge>}
<Radio className={`h-3.5 w-3.5 ${info.multicast_available ? 'text-emerald-500' : ''}`} /> <span className="flex items-center gap-1.5 text-muted-foreground">
{info.multicast_available ? '组播' : '单播'} <Radio className={`h-3.5 w-3.5 ${info.multicast_available ? 'text-emerald-500' : ''}`} />
</span> {info.multicast_available ? '组播' : '单播'}
</div> </span>
</div>
)}
</div> </div>
</header> </header>
@@ -389,8 +400,14 @@ export default function WatchPage() {
// Live is never paused (the player refuses to), so reporting a // Live is never paused (the player refuses to), so reporting a
// paused state there would only ever describe a stall. // paused state there would only ever describe a stall.
['播放状态', getVideo()?.paused ? (info.status === 'live' ? '缓冲中' : '暂停') : '播放中'], ['播放状态', getVideo()?.paused ? (info.status === 'live' ? '缓冲中' : '暂停') : '播放中'],
['线路', currentLine?.node_name || '不可用'], // Line and rendition only exist for a live programme; a replay
['清晰度', activeQuality === 'auto' ? `自动${autoQuality ? `(${autoQuality})` : ''}` : activeQuality], // has neither a node nor an audited session to report.
...(info.status === 'live'
? [
['线路', currentLine?.node_name || '不可用'],
['清晰度', activeQuality === 'auto' ? `自动${autoQuality ? `(${autoQuality})` : ''}` : activeQuality],
]
: []),
['分辨率', playbackStats.resolution], ['分辨率', playbackStats.resolution],
['时间码', `${playbackStats.currentTime.toFixed(1)} 秒`], ['时间码', `${playbackStats.currentTime.toFixed(1)} 秒`],
['缓冲', `${playbackStats.buffered.toFixed(1)} 秒`], ['缓冲', `${playbackStats.buffered.toFixed(1)} 秒`],
@@ -401,7 +418,7 @@ export default function WatchPage() {
// whenever the backend reports this one belongs to another // whenever the backend reports this one belongs to another
// programme, so a value captured during render would be blank // programme, so a value captured during render would be blank
// on load and stale after a rebind. // on load and stale after a rebind.
['会话标识', viewerSessionRef.current || '初始化中'], ...(info.status === 'live' ? [['会话标识', viewerSessionRef.current || '初始化中']] : []),
].map(([label, value]) => ( ].map(([label, value]) => (
<div key={label}> <div key={label}>
<span className="text-muted-foreground">{label}</span> <span className="text-muted-foreground">{label}</span>
+568
View File
@@ -0,0 +1,568 @@
#Requires -Version 5.1
<#
.SYNOPSIS
StreamCore service launcher: FastAPI backend (uvicorn) + nginx front end.
.DESCRIPTION
Starts the backend and nginx in the background with no console window and
everything written to log files.
The scheduled task "StreamCore-AutoStart" runs `-Action Start` at boot as
the SYSTEM account, so the whole stack comes up without anyone logging in.
Log files (D:\live\nvlive\live\runtime\logs):
backend.err.log uvicorn output - startup banner and access log
backend.out.log uvicorn stdout (normally empty)
nginx-launch.err.log output of the nginx launch command
nginx-launch.out.log output of the nginx launch command
service.log what this script itself did, with timestamps
nginx keeps its own request/error logs in D:\nginx-1.31.6\logs.
NOTE ON PATH
SYSTEM has a different PATH from the interactive Administrator account, and
ffmpeg/ffprobe are installed per-user by winget. That directory is added to
PATH explicitly below. Without it, transcoding fails with a bare
"ffmpeg not found" - and only when running as a service, never by hand.
NOTE ON NGINX RELOAD
Because nginx runs as SYSTEM, `nginx -s reload` and `nginx -s stop` from an
administrator shell fail with OpenEvent Access is denied. Use
`-Action Restart` after editing nginx.conf instead: it replaces the whole
worker tree.
.EXAMPLE
.\streamcore-service.ps1 # start (what the boot task runs)
.\streamcore-service.ps1 -Action Status
.\streamcore-service.ps1 -Action Doctor # what the service account sees
.\streamcore-service.ps1 -Action Restart
.\streamcore-service.ps1 -Action Install # register the boot task (admin)
.\streamcore-service.ps1 -Action Uninstall # remove it (admin)
#>
[CmdletBinding()]
param(
[ValidateSet('Start', 'Stop', 'Restart', 'Status', 'Doctor', 'Install', 'Uninstall')]
[string]$Action = 'Start'
)
$ErrorActionPreference = 'Stop'
# ------------------------------------------------------------------ constants
$LiveRoot = 'D:\live\nvlive\live'
$BackendDir = Join-Path $LiveRoot 'backend'
$LogDir = Join-Path $LiveRoot 'runtime\logs'
$NginxRoot = 'D:\nginx-1.31.6'
$NginxExe = Join-Path $NginxRoot 'nginx.exe'
$NginxLogs = Join-Path $NginxRoot 'logs'
$PythonDir = 'C:\Users\Administrator\AppData\Local\Programs\Python\Python314'
$UvicornExe = Join-Path $PythonDir 'Scripts\uvicorn.exe'
# winget installs ffmpeg per-user; a service account never sees it on PATH.
$FFmpegDir = 'C:\Users\Administrator\AppData\Local\Microsoft\WinGet\Links'
$BackendPort = 8080
$TaskName = 'StreamCore-AutoStart'
# Cloudflare Tunnel. The config and credentials live in ProgramData rather than a
# user profile because the boot task runs as SYSTEM, which has no profile of its
# own; `cloudflared tunnel login` writes to the calling user's profile only.
$TunnelName = 'nvlive'
$CloudflaredExe = 'C:\Program Files (x86)\cloudflared\cloudflared.exe'
$TunnelConfig = 'C:\ProgramData\cloudflared\config.yml'
$TunnelReadyUrl = 'http://127.0.0.1:20242/ready'
$BackendOutLog = Join-Path $LogDir 'backend.out.log'
$BackendErrLog = Join-Path $LogDir 'backend.err.log'
$TunnelOutLog = Join-Path $LogDir 'tunnel.out.log'
$TunnelErrLog = Join-Path $LogDir 'tunnel.err.log'
$NginxOutLog = Join-Path $LogDir 'nginx-launch.out.log'
$NginxErrLog = Join-Path $LogDir 'nginx-launch.err.log'
$ServiceLog = Join-Path $LogDir 'service.log'
$DoctorLog = Join-Path $LogDir 'doctor.log'
$MaxLogBytes = 32MB
$RestartDelaySeconds = 10
$HealthCheckSeconds = 15
$ScriptPath = $PSCommandPath
# Make ffmpeg/ffprobe (and the Python Scripts dir) visible to a service account.
$env:PATH = (@($FFmpegDir, (Join-Path $PythonDir 'Scripts'), $PythonDir) + $env:PATH) -join ';'
# -------------------------------------------------------------------- helpers
function Write-SvcLog {
param(
[Parameter(Mandatory)][string]$Message,
[ValidateSet('INFO', 'WARN', 'ERROR')][string]$Level = 'INFO'
)
$line = '{0} [{1}] {2}' -f (Get-Date -Format 'yyyy-MM-dd HH:mm:ss'), $Level, $Message
if (Test-Path -LiteralPath $LogDir) {
try { Add-Content -LiteralPath $ServiceLog -Value $line -Encoding UTF8 } catch { }
}
Write-Host $line
}
function Test-PortListening {
param([Parameter(Mandatory)][int]$Port)
$conn = Get-NetTCPConnection -LocalPort $Port -State Listen -ErrorAction SilentlyContinue
return [bool]$conn
}
function Rotate-Log {
param([Parameter(Mandatory)][string]$Path)
if (-not (Test-Path -LiteralPath $Path)) { return }
if ((Get-Item -LiteralPath $Path).Length -lt $MaxLogBytes) { return }
try {
Move-Item -LiteralPath $Path -Destination "$Path.1" -Force
} catch {
# A still-running child holds the file open; keep appending instead.
}
}
# ------------------------------------------------------------------- backend
function Start-Backend {
if (Test-PortListening -Port $BackendPort) {
Write-SvcLog "backend already listening on port $BackendPort; not starting a second one"
return $null
}
if (-not (Test-Path -LiteralPath $UvicornExe)) {
Write-SvcLog "uvicorn.exe not found at $UvicornExe" 'ERROR'
return $null
}
Rotate-Log -Path $BackendOutLog
Rotate-Log -Path $BackendErrLog
Write-SvcLog "starting backend: uvicorn main:app --port $BackendPort (cwd $BackendDir)"
# Uvicorn logs to stderr, so backend.err.log is the interesting one; the two
# streams cannot share a file, which is why stdout gets its own.
$proc = Start-Process -FilePath $UvicornExe `
-ArgumentList 'main:app', '--port', "$BackendPort" `
-WorkingDirectory $BackendDir `
-WindowStyle Hidden `
-RedirectStandardOutput $BackendOutLog `
-RedirectStandardError $BackendErrLog `
-PassThru
Write-SvcLog "backend started, pid $($proc.Id)"
return $proc
}
function Stop-Backend {
$conns = Get-NetTCPConnection -LocalPort $BackendPort -State Listen -ErrorAction SilentlyContinue
if (-not $conns) {
Write-SvcLog "backend is not listening on port $BackendPort"
return
}
foreach ($procId in ($conns.OwningProcess | Sort-Object -Unique)) {
try {
Stop-Process -Id $procId -Force -ErrorAction Stop
Write-SvcLog "stopped backend pid $procId"
} catch {
Write-SvcLog "could not stop backend pid ${procId}: $_" 'WARN'
}
}
}
# --------------------------------------------------------------------- nginx
function Start-Nginx {
param([switch]$Quiet)
# Health is judged by the listening socket, not by "an nginx process exists".
# A master that dies can leave workers behind that still hold 80/443 with
# SO_REUSEADDR, and calling that healthy would keep a broken front end in
# place forever - or let a second master bind alongside it.
if ((Test-PortListening -Port 443) -or (Test-PortListening -Port 80)) {
if (-not $Quiet) { Write-SvcLog 'nginx is already serving on port 80/443' }
return
}
$stale = @(Get-Process -Name 'nginx' -ErrorAction SilentlyContinue)
if ($stale.Count -gt 0) {
Write-SvcLog "clearing stale nginx process(es) $(($stale.Id) -join ', ')" 'WARN'
[void](Stop-NginxProcesses)
}
if (-not (Test-Path -LiteralPath $NginxExe)) {
Write-SvcLog "nginx.exe not found at $NginxExe" 'ERROR'
return
}
Rotate-Log -Path $NginxOutLog
Rotate-Log -Path $NginxErrLog
Write-SvcLog "starting nginx: `"$NginxExe`" -p $NginxRoot"
# -p pins the prefix, so nginx.conf's relative paths (logs/, certs/, mime.types)
# resolve inside the nginx install no matter how the task was launched.
try {
Start-Process -FilePath $NginxExe `
-ArgumentList '-p', $NginxRoot `
-WorkingDirectory $NginxRoot `
-WindowStyle Hidden `
-RedirectStandardOutput $NginxOutLog `
-RedirectStandardError $NginxErrLog `
-PassThru | Out-Null
} catch {
Write-SvcLog "nginx failed to launch: $_" 'ERROR'
return
}
Start-Sleep -Seconds 2
if ((Test-PortListening -Port 443) -or (Test-PortListening -Port 80)) {
$now = @(Get-Process -Name 'nginx' -ErrorAction SilentlyContinue)
Write-SvcLog "nginx serving on 80/443 (pid $(($now.Id) -join ', '))"
} else {
Write-SvcLog "nginx is not serving; check $NginxErrLog and $NginxLogs\error.log" 'ERROR'
}
}
function Stop-NginxProcesses {
# Kill until none are left. A master part-way through shutdown can spawn a
# fresh worker between the snapshot and the kill, so one pass is not enough -
# and a surviving worker keeps holding ports 80/443.
for ($attempt = 1; $attempt -le 4; $attempt++) {
$left = @(Get-Process -Name 'nginx' -ErrorAction SilentlyContinue)
if ($left.Count -eq 0) { return $true }
foreach ($proc in $left) {
try { Stop-Process -Id $proc.Id -Force -ErrorAction Stop } catch { }
}
Start-Sleep -Seconds 1
}
return (@(Get-Process -Name 'nginx' -ErrorAction SilentlyContinue).Count -eq 0)
}
function Stop-Nginx {
if (-not (Get-Process -Name 'nginx' -ErrorAction SilentlyContinue)) {
Write-SvcLog 'nginx is not running'
return
}
# `nginx -s stop` signals the master through the global event
# Global\ngx_stop_<pid>. When nginx runs as SYSTEM (as it does here) an
# administrator shell cannot open that event and nginx exits 1 with
# "Access is denied" - so this is expected to fail, and the worker tree is
# killed directly below. The attempt is kept because it does work when the
# command happens to run as the same account that owns the master.
$signalDelivered = $false
try {
$signal = Start-Process -FilePath $NginxExe -ArgumentList '-p', $NginxRoot, '-s', 'stop' `
-WorkingDirectory $NginxRoot -WindowStyle Hidden -PassThru -Wait
$signalDelivered = ($signal.ExitCode -eq 0)
} catch {
Write-SvcLog "graceful nginx stop failed: $_" 'WARN'
}
if ($signalDelivered) {
# Drain first: a graceful stop has a dozen workers to wind down.
$deadline = (Get-Date).AddSeconds(8)
while ((Get-Date) -lt $deadline) {
if (-not (Get-Process -Name 'nginx' -ErrorAction SilentlyContinue)) {
Write-SvcLog 'nginx stopped'
return
}
Start-Sleep -Milliseconds 500
}
}
if (Stop-NginxProcesses) {
Write-SvcLog 'nginx killed directly (the stop signal is not usable from this account)' 'WARN'
} else {
Write-SvcLog 'some nginx processes could not be stopped' 'ERROR'
}
}
# ------------------------------------------------------------------- tunnel
function Test-TunnelReady {
# /ready is 200 only while the connector actually holds a connection to a
# Cloudflare edge node, so it distinguishes "process alive" from "serving".
try {
$r = Invoke-WebRequest -Uri $TunnelReadyUrl -UseBasicParsing -TimeoutSec 5 -ErrorAction Stop
return ($r.StatusCode -eq 200)
} catch {
return $false
}
}
function Start-Tunnel {
param([switch]$Quiet)
if (Get-Process -Name 'cloudflared' -ErrorAction SilentlyContinue) {
if (-not $Quiet) { Write-SvcLog 'tunnel is already running' }
return
}
if (-not (Test-Path -LiteralPath $CloudflaredExe)) {
Write-SvcLog "cloudflared.exe not found at $CloudflaredExe" 'ERROR'
return
}
Rotate-Log -Path $TunnelOutLog
Rotate-Log -Path $TunnelErrLog
Write-SvcLog "starting tunnel '$TunnelName'"
try {
Start-Process -FilePath $CloudflaredExe `
-ArgumentList '--config', $TunnelConfig, 'tunnel', 'run' `
-WorkingDirectory (Split-Path -Parent $TunnelConfig) `
-WindowStyle Hidden `
-RedirectStandardOutput $TunnelOutLog `
-RedirectStandardError $TunnelErrLog `
-PassThru | Out-Null
} catch {
Write-SvcLog "tunnel failed to launch: $_" 'ERROR'
return
}
Start-Sleep -Seconds 6
if (Test-TunnelReady) {
Write-SvcLog 'tunnel connected to the Cloudflare edge'
} elseif (Get-Process -Name 'cloudflared' -ErrorAction SilentlyContinue) {
Write-SvcLog 'tunnel process is up but not ready yet; see tunnel.err.log' 'WARN'
} else {
Write-SvcLog "tunnel exited immediately; check $TunnelErrLog" 'ERROR'
}
}
function Stop-Tunnel {
$procs = @(Get-Process -Name 'cloudflared' -ErrorAction SilentlyContinue)
if ($procs.Count -eq 0) {
Write-SvcLog 'tunnel is not running'
return
}
foreach ($proc in $procs) {
try { Stop-Process -Id $proc.Id -Force -ErrorAction Stop } catch { }
}
Start-Sleep -Seconds 2
if (Get-Process -Name 'cloudflared' -ErrorAction SilentlyContinue) {
Write-SvcLog 'tunnel did not stop' 'ERROR'
} else {
Write-SvcLog "tunnel stopped (pid $(($procs.Id) -join ', '))"
}
}
function Stop-MediaOrigin {
# The backend autostarts MediaMTX; only kill the repo copy, never an origin
# somebody else is managing.
$procs = @(Get-Process -Name 'mediamtx' -ErrorAction SilentlyContinue |
Where-Object { $_.Path -and $_.Path.StartsWith($LiveRoot, 'OrdinalIgnoreCase') })
foreach ($p in $procs) {
try {
Stop-Process -Id $p.Id -Force -ErrorAction Stop
Write-SvcLog "stopped mediamtx pid $($p.Id)"
} catch { }
}
}
# ---------------------------------------------------------------------- start
function Start-Stack {
New-Item -ItemType Directory -Force -Path $LogDir | Out-Null
Write-SvcLog '--- start requested ---'
Start-Nginx
Start-Tunnel
# Supervise uvicorn: if it dies, bring it straight back instead of waiting
# for the scheduler's one-minute restart interval.
while ($true) {
$proc = Start-Backend
if ($null -eq $proc) {
# Something already owns the port; there is nothing to supervise.
break
}
# Poll rather than WaitForExit so nginx and the tunnel are re-checked on
# the same tick: if either lost a race at boot, this puts it back within
# the poll interval.
while (-not $proc.HasExited) {
Start-Sleep -Seconds $HealthCheckSeconds
Start-Nginx -Quiet
Start-Tunnel -Quiet
}
Write-SvcLog "backend pid $($proc.Id) exited with code $($proc.ExitCode); restarting in ${RestartDelaySeconds}s" 'WARN'
Start-Sleep -Seconds $RestartDelaySeconds
}
Write-SvcLog 'start finished'
}
function Stop-Stack {
Write-SvcLog '--- stop requested ---'
# The boot task supervises the backend and would restart it ten seconds from
# now, so it has to go first. Stop-Stack is also its own cleanup path.
$task = Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue
if ($task -and $task.State -eq 'Running') {
Stop-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue
Write-SvcLog "stopped scheduled task '$TaskName'"
Start-Sleep -Seconds 3
}
Stop-Nginx
Stop-Tunnel
Stop-Backend
Stop-MediaOrigin
Write-SvcLog 'stop finished'
}
# -------------------------------------------------------------------- status
function Show-Status {
Write-Host ''
Write-Host "StreamCore service status ($(Get-Date -Format 'yyyy-MM-dd HH:mm:ss'))"
Write-Host ('-' * 62)
foreach ($item in @(
@{ Name = 'nginx (80/443)'; Port = 443 },
@{ Name = 'backend (8080)'; Port = $BackendPort },
@{ Name = 'mediamtx api (9997)'; Port = 9997 },
@{ Name = 'mediamtx rtmp (1935)'; Port = 1935 }
)) {
$up = Test-PortListening -Port $item.Port
$mark = if ($up) { 'UP ' } else { 'DOWN' }
Write-Host (" [{0}] {1}" -f $mark, $item.Name)
}
# The tunnel is an outbound connector, so there is no listening port to test;
# readiness comes from its own /ready endpoint.
$mark = if (Test-TunnelReady) { 'UP ' } else { 'DOWN' }
Write-Host (" [{0}] cloudflare tunnel '{1}'" -f $mark, $TunnelName)
foreach ($name in 'nginx', 'mediamtx', 'cloudflared') {
$p = @(Get-Process -Name $name -ErrorAction SilentlyContinue)
Write-Host (" {0,-12} process: {1}" -f $name, $(if ($p.Count) { ($p.Id -join ', ') } else { 'not running' }))
}
$task = Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue
if ($task) {
$info = Get-ScheduledTaskInfo -TaskName $TaskName -ErrorAction SilentlyContinue
Write-Host (" boot task: {0} (last run {1}, result {2})" -f $task.State, $info.LastRunTime, $info.LastTaskResult)
} else {
Write-Host ' boot task: not installed'
}
Write-Host ''
Write-Host ' logs:'
foreach ($log in @($BackendErrLog, $BackendOutLog, $TunnelErrLog, $ServiceLog, $NginxErrLog)) {
$size = if (Test-Path -LiteralPath $log) { '{0,10:N0} B' -f (Get-Item -LiteralPath $log).Length } else { ' absent' }
Write-Host (" {0,12} {1}" -f $size, $log)
}
Write-Host (" {0,12} {1}" -f 'nginx logs', $NginxLogs)
Write-Host ''
}
# ------------------------------------------------------------------- install
function Install-Autostart {
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
$elevated = (New-Object Security.Principal.WindowsPrincipal $identity).IsInRole(
[Security.Principal.WindowsBuiltInRole]::Administrator)
if (-not $elevated) {
throw 'Registering a boot task needs an elevated PowerShell window.'
}
$powershellExe = Join-Path $env:SystemRoot 'System32\WindowsPowerShell\v1.0\powershell.exe'
$argument = '-NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File "{0}" -Action Start' -f $ScriptPath
$taskAction = New-ScheduledTaskAction -Execute $powershellExe -Argument $argument -WorkingDirectory $LiveRoot
$trigger = New-ScheduledTaskTrigger -AtStartup
# Give the network stack a moment; binding 0.0.0.0 does not need an address,
# so this is insurance rather than a requirement.
try { $trigger.Delay = 'PT20S' } catch { }
# SYSTEM + Highest: starts at boot with no login, and can bind ports 80/443.
$principal = New-ScheduledTaskPrincipal -UserId 'SYSTEM' -LogonType ServiceAccount -RunLevel Highest
$settings = New-ScheduledTaskSettingsSet `
-AllowStartIfOnBatteries `
-DontStopIfGoingOnBatteries `
-DontStopOnIdleEnd `
-StartWhenAvailable `
-MultipleInstances IgnoreNew `
-ExecutionTimeLimit ([TimeSpan]::Zero) `
-RestartCount 3 `
-RestartInterval (New-TimeSpan -Minutes 1)
Register-ScheduledTask -TaskName $TaskName `
-Action $taskAction `
-Trigger $trigger `
-Principal $principal `
-Settings $settings `
-Description 'Starts the StreamCore backend (uvicorn, port 8080) and the nginx front end at boot.' `
-Force | Out-Null
Write-SvcLog "installed scheduled task '$TaskName' (trigger: at startup, user: SYSTEM)"
Show-Status
}
function Uninstall-Autostart {
$task = Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue
if (-not $task) {
Write-SvcLog "scheduled task '$TaskName' is not installed"
return
}
Unregister-ScheduledTask -TaskName $TaskName -Confirm:$false
Write-SvcLog "removed scheduled task '$TaskName'"
}
function Restart-Stack {
Stop-Stack
# Prefer the boot task, so restarting by hand leaves the stack under the same
# supervisor that will own it after the next reboot.
if (Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue) {
Start-ScheduledTask -TaskName $TaskName
Write-SvcLog "restart requested through scheduled task '$TaskName'"
} else {
Start-Stack
}
}
# -------------------------------------------------------------------- doctor
function Show-Doctor {
# Reports what this script's environment actually resolves to, from inside
# whichever account runs it. Run it as SYSTEM after a reboot to prove the
# service account can see ffmpeg; nothing else in the stack checks that.
$lines = @()
$lines += 'StreamCore doctor'
$lines += ' run as : {0}' -f [Security.Principal.WindowsIdentity]::GetCurrent().Name
$lines += ' run at : {0}' -f (Get-Date -Format 'yyyy-MM-dd HH:mm:ss')
$lines += ''
$lines += ' executables:'
foreach ($tool in 'ffmpeg', 'ffprobe', 'uvicorn', 'python', 'nginx', 'mediamtx', 'cloudflared') {
$cmd = Get-Command $tool -ErrorAction SilentlyContinue
$resolved = if ($cmd) { $cmd.Source } else { '<NOT FOUND>' }
$lines += ' {0,-10} {1}' -f $tool, $resolved
}
$lines += ''
$lines += ' listening ports:'
foreach ($entry in @(
@{ Name = 'nginx http'; Port = 80 },
@{ Name = 'nginx https'; Port = 443 },
@{ Name = 'backend'; Port = $BackendPort },
@{ Name = 'mediamtx hls'; Port = 8888 },
@{ Name = 'mediamtx api'; Port = 9997 }
)) {
$lines += ' {0,-14} {1,-5} {2}' -f $entry.Name, $entry.Port, $(if (Test-PortListening -Port $entry.Port) { 'UP' } else { 'DOWN' })
}
$lines += ''
$lines += ' cloudflare tunnel {0}: {1}' -f $TunnelName, $(if (Test-TunnelReady) { 'connected' } else { 'NOT connected' })
$lines += ''
$lines += ' PATH:'
foreach ($dir in ($env:PATH -split ';' | Where-Object { $_ })) { $lines += " $dir" }
$lines += ''
$lines += ' log files:'
foreach ($log in @($BackendErrLog, $BackendOutLog, $TunnelErrLog, $NginxErrLog, $ServiceLog)) {
$exists = Test-Path -LiteralPath $log
$lines += ' {0,-34} {1}' -f $log, $(if ($exists) { '{0:N0} bytes' -f (Get-Item -LiteralPath $log).Length } else { 'absent' })
}
New-Item -ItemType Directory -Force -Path $LogDir | Out-Null
$lines | Set-Content -LiteralPath $DoctorLog -Encoding UTF8
$lines | ForEach-Object { Write-Host $_ }
}
# ---------------------------------------------------------------------- main
switch ($Action) {
'Start' { Start-Stack }
'Stop' { Stop-Stack }
'Restart' { Restart-Stack }
'Status' { Show-Status }
'Doctor' { Show-Doctor }
'Install' { Install-Autostart }
'Uninstall' { Uninstall-Autostart }
}