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 1183 additions and 77 deletions

No files matched your search

+4
View File
@@ -36,3 +36,7 @@ package-lock.json
# edge-agent
edge-agent/dist/
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.
## 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
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.
## 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
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:
"""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)
if not stream:
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()
if not session_id or len(session_id) > 64:
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":
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"):
_media_path(updates["replay_file"])
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)
if not stream or not stream.remote_control_enabled:
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)
session = ControlSession(
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)
if not stream or not stream.remote_control_enabled:
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"}:
raise HTTPException(status_code=422, detail="不支持的远程命令")
if not body.targets:
@@ -616,6 +658,14 @@ async def send_remote_command(stream_id: int, body: RemoteCommand,
@router.get("/{stream_id}/remote-command")
async def poll_remote_command(stream_id: int, session_id: str,
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)
if not viewer:
raise HTTPException(status_code=404, detail="观众会话不存在")
+13
View File
@@ -192,6 +192,19 @@ class StreamService:
stream = await self.get_stream_by_key(stream_key)
if not stream:
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)
best_node = lb.select_best_node(client_ip)
if not best_node:
@@ -18,6 +18,7 @@ class StreamAccessSerializationTest(unittest.TestCase):
"ended_at": None,
"multicast_enabled": False,
"replay_file": None,
"replay_url": None,
"chapters_json": "[]",
"transcode_profile": "default",
"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">
<head>
<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" />
<title>StreamCore</title>
<title> </title>
</head>
<body>
<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="streams" element={<StreamList />} />
<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="settings" element={<SettingsPage />} />
<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 { Button } from '@/components/ui/button'
import { Badge } from '@/components/ui/badge'
import { Alert, AlertDescription, AlertTitle } from '@/components/ui/alert'
import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
import {
Select,
@@ -65,9 +66,13 @@ export default function LiveBoard() {
const programs = await fetchStreams(true)
setStreams(programs)
const nextId = streamId || programs.find((p) => p.status === 'live')?.id
const nextProgram = programs.find((p) => p.id === nextId)
if (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 {
setSessions([])
}
@@ -105,10 +110,13 @@ export default function LiveBoard() {
if (nodeId === 'auto' && quality === 'auto') await sendRemoteCommand(streamId, session.token, 'restore_auto', targets)
toast.success(`已向 ${selected.size} 个观众下发节点与清晰度策略`)
} 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 buffering = activeSessions.filter(
(s) => s.playback_state === 'buffering' || Number(s.buffered_seconds || 0) < 1,
@@ -187,7 +195,16 @@ export default function LiveBoard() {
</CardContent>
</Card>
{streamId && (
{streamId && !isLiveProgram && (
<Alert>
<AlertTitle>观众会话审计仅适用于直播</AlertTitle>
<AlertDescription>
当前选中的节目不是直播状态。回放是直接下发的录制文件,没有线路、清晰度或播放控制可审计,因此不产生观众会话。
</AlertDescription>
</Alert>
)}
{streamId && isLiveProgram && (
<Card>
<CardHeader className="flex-row items-center justify-between space-y-0">
<CardTitle className="text-base">审计式观众会话</CardTitle>
+8 -2
View File
@@ -1,6 +1,6 @@
import { useEffect, useRef, useState } from 'react'
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 { Button } from '@/components/ui/button'
import { Input } from '@/components/ui/input'
@@ -123,10 +123,16 @@ export default function ReplayEditor() {
return (
<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">
<Button variant="ghost" onClick={() => navigate('/admin/streams')}>
<ArrowLeft className="h-4 w-4" />
返回节目列表
</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} />
{!isEditable ? (
+149 -24
View File
@@ -1,6 +1,6 @@
import { useState } from 'react'
import { useNavigate } from 'react-router-dom'
import { Copy, ArrowLeft, CheckCircle2, Plus, Trash2 } from 'lucide-react'
import { useEffect, useState } from 'react'
import { useNavigate, useParams } from 'react-router-dom'
import { Copy, ArrowLeft, CheckCircle2, Plus, Trash2, Clapperboard } from 'lucide-react'
import { toast } from 'sonner'
import axios from 'axios'
import { Button } from '@/components/ui/button'
@@ -16,7 +16,7 @@ import {
SelectTrigger,
SelectValue,
} from '@/components/ui/select'
import { createStream, type RenditionConfig } from '@/api/streams'
import { createStream, getStream, updateStream, type RenditionConfig } from '@/api/streams'
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 },
@@ -25,8 +25,28 @@ const DEFAULT_RENDITIONS: RenditionConfig[] = [
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() {
const navigate = useNavigate()
const { id } = useParams<{ id: string }>()
const streamId = Number(id)
const isEdit = Number.isInteger(streamId) && streamId > 0
const [title, setTitle] = useState('')
const [description, setDescription] = useState('')
const [coverUrl, setCoverUrl] = useState('')
@@ -35,9 +55,47 @@ export default function StreamForm() {
const [homepageVisible, setHomepageVisible] = useState(true)
const [remoteControl, setRemoteControl] = useState(false)
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 [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) => {
e.preventDefault()
if (!title.trim()) {
@@ -45,12 +103,27 @@ export default function StreamForm() {
return
}
setLoading(true)
const schedule = scheduledAt ? new Date(scheduledAt).toISOString() : null
try {
if (isEdit) {
await updateStream(streamId, {
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,
...(renditionsPinned ? { renditions } : {}),
})
toast.success('节目属性已更新')
navigate('/admin/streams')
} else {
const res = await createStream({
title: title.trim(),
description: description || undefined,
cover_url: coverUrl || undefined,
scheduled_at: scheduledAt ? new Date(scheduledAt).toISOString() : undefined,
description: description.trim() || null,
cover_url: coverUrl.trim() || null,
scheduled_at: schedule,
transcode_profile: transcodeProfile,
homepage_visible: homepageVisible,
remote_control_enabled: remoteControl,
@@ -58,18 +131,41 @@ export default function StreamForm() {
})
setResult({ rtmp_url: res.rtmp_url, stream_key: res.stream_key })
toast.success('直播已创建')
}
} catch (error) {
const detail = axios.isAxiosError(error) ? error.response?.data?.detail : undefined
toast.error(typeof detail === 'string' ? detail : '创建失败,请稍后重试')
toast.error(typeof detail === 'string' ? detail : isEdit ? '保存失败,请稍后重试' : '创建失败,请稍后重试')
} finally {
setLoading(false)
}
}
const updateRendition = (index: number, patch: Partial<RenditionConfig>) => {
setRenditionsPinned(true)
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) {
return (
<div className="mx-auto max-w-2xl">
@@ -116,10 +212,45 @@ export default function StreamForm() {
返回列表
</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>
<CardHeader>
<CardTitle className="text-2xl">创建节目</CardTitle>
<p className="text-sm text-muted-foreground">填写节目信息并预约播出,系统将生成推流码与 RTMP 地址</p>
<CardTitle className="text-2xl">{isEdit ? '编辑节目' : '创建节目'}</CardTitle>
<p className="text-sm text-muted-foreground">
{isEdit ? '修改标题、简介、排期与转码参数,保存后立即生效' : '填写节目信息并预约播出,系统将生成推流码与 RTMP 地址'}
</p>
</CardHeader>
<CardContent>
<form onSubmit={handleSubmit} className="space-y-5">
@@ -150,7 +281,10 @@ export default function StreamForm() {
<SelectItem value="bandwidth-saver">带宽节省</SelectItem>
</SelectContent>
</Select>
<p className="text-xs text-muted-foreground">可直接使用预设,也可在下方逐档调整参数</p>
<p className="text-xs text-muted-foreground">
可直接使用预设,也可在下方逐档调整参数
{isEdit && !renditionsPinned && ';当前沿用预设档位,修改任意一档后才会保存为自定义清晰度'}
</p>
</div>
<div className="space-y-3">
@@ -166,7 +300,7 @@ export default function StreamForm() {
onChange={(e) => updateRendition(index, { label: e.target.value })}
/>
</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" />
</Button>
</div>
@@ -225,16 +359,7 @@ export default function StreamForm() {
</div>
</div>
))}
<Button
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 },
])
}
>
<Button type="button" variant="outline" onClick={addRendition}>
<Plus className="h-4 w-4" />
添加清晰度
</Button>
@@ -250,13 +375,13 @@ export default function StreamForm() {
<div className="flex items-center justify-between rounded-md border border-border p-3">
<div>
<Label>审计式观众播放控制</Label>
<p className="text-xs text-muted-foreground">仅在明确启用后允许创建限时控制会话</p>
<p className="text-xs text-muted-foreground">仅直播期间生效,回放观众不参与审计与控制</p>
</div>
<Switch checked={remoteControl} onCheckedChange={setRemoteControl} />
</div>
<Button type="submit" className="h-11 w-full" disabled={loading}>
{loading ? '创建中…' : '创建节目'}
{loading ? (isEdit ? '保存中…' : '创建中…') : isEdit ? '保存更改' : '创建节目'}
</Button>
</form>
</CardContent>
+5 -2
View File
@@ -1,6 +1,6 @@
import { useState, useEffect } from 'react'
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 { Button } from '@/components/ui/button'
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')}>
<Eye className="h-4 w-4" />
</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" />
</Button>
<Button variant="ghost" size="icon" title="回放与章节" onClick={() => navigate(`/admin/streams/${s.id}/replay`)}>
<Clapperboard className="h-4 w-4" />
</Button>
<AlertDialog>
<AlertDialogTrigger asChild>
<Button variant="ghost" size="icon" title="删除">
+24 -4
View File
@@ -42,9 +42,9 @@ export interface Chapter {
export interface StreamCreateReq {
title: string
description?: string
cover_url?: string
scheduled_at?: string
description?: string | null
cover_url?: string | null
scheduled_at?: string | null
replay_file?: string | null
replay_url?: string | null
chapters?: Chapter[]
@@ -146,7 +146,27 @@ export async function getStream(streamId: number): Promise<StreamInfo> {
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)
}
+72 -11
View File
@@ -32,6 +32,15 @@ interface VideoPlayerProps {
const SEEK_STEP_SECONDS = 5
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) {
if (!Number.isFinite(seconds)) return '00:00'
const value = Math.max(0, Math.floor(seconds))
@@ -423,32 +432,63 @@ const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(function Vid
setLoading(false)
onError?.('当前没有可用的播放地址')
} else if (Hls.isSupported()) {
// Buffering is the thing to avoid; chase latency only after that. hls.js
// 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.
// Buffering policy: start on the first TS, then hold a four-segment queue.
//
// Deliberately NOT enabled, all for the same reason — each pulls the target
// latency down to a single 4s segment, so playback races the encoder and
// re-buffers at the end of every segment:
// hls.js's stock defaults assume a healthy link — a 500 kbps starting
// estimate, a bitrate probe before the first real segment, and a buffer
// 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
// liveSyncDurationCount: 1 target = exactly one segment
// maxLiveSyncPlaybackRate speeds playback up to 1.5x to hold that
// 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({
enableWorker: true,
// Keeps recent segments available locally, so a brief stall is served
// from the buffer instead of going back to the network.
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
hls.loadSource(source)
hls.attachMedia(video)
hls.on(Hls.Events.MANIFEST_PARSED, () => {
setLoading(false)
// For live, anchors playback to the end of the sliding window so a new
// viewer starts at the live edge instead of the oldest retained segment.
// For live, anchors playback near the end of the sliding window —
// 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)
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
// rendition list we never received.
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()
})
hls.on(Hls.Events.ERROR, (_event, data) => {
@@ -634,7 +692,10 @@ const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(function Vid
<video
ref={videoRef}
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
// 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:
+18 -1
View File
@@ -62,6 +62,15 @@ export default function WatchPage() {
useEffect(() => {
const streamId = Number(id)
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 video = getVideo()
@@ -345,6 +354,7 @@ export default function WatchPage() {
<span className="font-medium">{info.title}</span>
<Badge variant={info.status === 'live' ? 'default' : 'secondary'}>{statusLabel}</Badge>
{info.status === 'live' && (
<div className="ml-auto flex flex-wrap items-center gap-2 text-xs">
<Badge variant="outline">节点:{currentLine?.node_name || info.selected_node?.name || '不可用'}</Badge>
<Badge variant="outline">
@@ -356,6 +366,7 @@ export default function WatchPage() {
{info.multicast_available ? '组播' : '单播'}
</span>
</div>
)}
</div>
</header>
@@ -389,8 +400,14 @@ export default function WatchPage() {
// Live is never paused (the player refuses to), so reporting a
// paused state there would only ever describe a stall.
['播放状态', getVideo()?.paused ? (info.status === 'live' ? '缓冲中' : '暂停') : '播放中'],
// Line and rendition only exist for a live programme; a replay
// has neither a node nor an audited session to report.
...(info.status === 'live'
? [
['线路', currentLine?.node_name || '不可用'],
['清晰度', activeQuality === 'auto' ? `自动${autoQuality ? `(${autoQuality})` : ''}` : activeQuality],
]
: []),
['分辨率', playbackStats.resolution],
['时间码', `${playbackStats.currentTime.toFixed(1)} 秒`],
['缓冲', `${playbackStats.buffered.toFixed(1)} 秒`],
@@ -401,7 +418,7 @@ export default function WatchPage() {
// whenever the backend reports this one belongs to another
// programme, so a value captured during render would be blank
// on load and stale after a rebind.
['会话标识', viewerSessionRef.current || '初始化中'],
...(info.status === 'live' ? [['会话标识', viewerSessionRef.current || '初始化中']] : []),
].map(([label, value]) => (
<div key={label}>
<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 }
}