LibreTV 安装说明

2026-10-26 · 元 / yokon

Windows + Node standalone（v2.21.0）本机安装备忘：从零下载、配置密码、启停与加源。

版本：LibreSpark/LibreTV v2.21.0（独立版 / Node，非 Docker）
上游仓库：https://github.com/LibreSpark/LibreTV（作者 bestZwei；Docker Hub：bestzwei/libretv）
整理日期：2026-10-26（Asia/Shanghai）

简介

LibreTV 是一个可自托管的影视聚合前端。本说明以 Windows + Node.js 独立包（standalone） 为例，默认监听本机端口 8899，浏览器访问：http://127.0.0.1:8899。

运行要求：Node.js 18+（推荐 20 / 22 / 24 LTS）。

从零安装（推荐给新用户）

1. 准备环境

安装 Node.js（勾选「添加到 PATH」）。
在 PowerShell 验证：

node -v
# 应显示 v18 及以上

2. 下载独立包

打开发布页：https://github.com/LibreSpark/LibreTV/releases
下载最新版资源名类似 *-standalone.tar.gz 的包（例如 v2.21.0 对应的 standalone）。
选一个固定目录解压，例如：

你的安装目录\LibreTV

（可用 7-Zip / tar 解压。解压后目录内应能看到 server.js 或 package.json 等程序文件。）

3. 配置密码与端口

在安装目录新建 .env（纯文本，UTF-8），内容示例：

PASSWORD=请改成你自己的强密码
PROXY_SECRET=请改成一长串随机字符串
PORT=8899

可选：再写一个备忘文件 .libretv-password.txt，内容只放登录密码本身（勿把真实密码写进公开文档或发到网上）。

说明：PASSWORD 是网页登录密码；PROXY_SECRET 用于服务端代理相关校验，请自行随机生成并妥善保管。

4. 启动 / 停止脚本（可选但方便）

在安装目录放 start.ps1 / stop.ps1（也可用手动 node server.js）。示意：

start.ps1（读取同目录 .env 后启动）：

$ErrorActionPreference = "Stop"
$Root = Split-Path -Parent $MyInvocation.MyCommand.Path
Set-Location $Root
$envFile = Join-Path $Root ".env"
if (Test-Path $envFile) {
  Get-Content $envFile | ForEach-Object {
    if ($_ -match "^\s*#" -or $_ -match "^\s*$") { return }
    $parts = $_.Split("=", 2)
    if ($parts.Count -eq 2) {
      [System.Environment]::SetEnvironmentVariable($parts[0].Trim(), $parts[1].Trim(), "Process")
    }
  }
}
if (-not $env:PASSWORD) { throw "PASSWORD not set. Put it in .env" }
if (-not $env:PORT) { $env:PORT = "8899" }
Write-Host ("Starting LibreTV on http://127.0.0.1:" + $env:PORT)
if (Test-Path (Join-Path $Root "server.js")) {
  node server.js
} elseif (Test-Path (Join-Path $Root "package.json")) {
  if (-not (Test-Path (Join-Path $Root "node_modules"))) { npm ci }
  if (-not (Test-Path (Join-Path $Root ".next"))) { npm run build }
  npm start
} else {
  throw "No server.js or package.json found in $Root"
}

stop.ps1（结束占用 8899 的进程；若改了 PORT 会从 .env 读取）：

$Port = 8899
$envFile = Join-Path (Split-Path -Parent $MyInvocation.MyCommand.Path) ".env"
if (Test-Path $envFile) {
  $line = Get-Content $envFile | Where-Object { $_ -match "^PORT=" } | Select-Object -First 1
  if ($line) { $Port = ($line -replace "^PORT=", "").Trim() }
}
$conns = Get-NetTCPConnection -LocalPort $Port -State Listen -ErrorAction SilentlyContinue
if (-not $conns) { Write-Host "No process listening on port $Port"; exit 0 }
$pids = $conns | Select-Object -ExpandProperty OwningProcess -Unique
foreach ($procId in $pids) {
  $p = Get-Process -Id $procId -ErrorAction SilentlyContinue
  Write-Host ("Stopping PID $procId ($($p.ProcessName))")
  Stop-Process -Id $procId -Force -ErrorAction SilentlyContinue
}
Write-Host "Done"

5. 首次启动与登录

powershell -ExecutionPolicy Bypass -File "你的安装目录\LibreTV\start.ps1"

浏览器打开：http://127.0.0.1:8899，用 .env 里的 PASSWORD（或 .libretv-password.txt）登录。

可选：在桌面建快捷方式 桌面\LibreTV.lnk，目标指向上述 start.ps1；再建 桌面\LibreTV.url 打开网页。

目录与文件（通用占位）

用途	路径（请换成你的实际位置）
安装目录	`你的安装目录\LibreTV`
启动脚本	`你的安装目录\LibreTV\start.ps1`
停止脚本	`你的安装目录\LibreTV\stop.ps1`
环境配置	`你的安装目录\LibreTV\.env`（含 `PASSWORD`、`PROXY_SECRET`、`PORT=8899`）
密码备忘	`你的安装目录\LibreTV\.libretv-password.txt`（勿写出真实密码）
桌面启动快捷方式（可选）	`桌面\LibreTV.lnk`
桌面网页快捷方式（可选）	`桌面\LibreTV.url`

日常启动与停止

启动

任选其一：

双击桌面 LibreTV.lnk（若已创建）
或在 PowerShell 中执行：

powershell -ExecutionPolicy Bypass -File "你的安装目录\LibreTV\start.ps1"

停止

powershell -ExecutionPolicy Bypass -File "你的安装目录\LibreTV\stop.ps1"

访问与密码

服务启动后，浏览器打开：http://127.0.0.1:8899
登录密码：打开安装目录下的 .libretv-password.txt，或查看 .env 中的 PASSWORD。
请勿把真实密码写进公开文档、聊天或 Git。
.env 中 PORT=8899 对应上述地址；改端口后需同步改访问地址并重启服务。

添加点播 / 直播源

进入网页后：

打开 设置 → 源管理
按需配置：
- 点播源
- 直播源
- 数据源订阅（推荐用订阅批量导入）

示例订阅地址（可粘贴到「数据源订阅」；公开 gist，可自行替换为其他可靠订阅）：

https://gist.githubusercontent.com/yifanwang-yet/dbb7af044d90b5f51c1f32d0e0a200f6/raw/libretv-sources.json

保存后按页面提示刷新或重新加载源即可。

常见问题

现象	可能原因 / 处理
打不开网页	服务未启动 → 先运行 `start.ps1` 或桌面快捷方式；确认地址为 `http://127.0.0.1:8899`
以前能开、现在不行	安装文件夹被移动/重命名 → 确认 `start.ps1` / 快捷方式仍指向当前 `你的安装目录\LibreTV`
端口占用	8899 被其他程序占用 → 结束占用进程，或改 `.env` 里的 `PORT` 后重启，并用新端口访问
快捷方式失效	重新指向当前安装目录的 `start.ps1`，不要指向已删除的旧副本
登录失败	核对 `.env` 的 `PASSWORD` 与输入是否一致；改密码后需重启服务

升级简述（独立包）

到上游发布页下载新版 standalone 包：
https://github.com/LibreSpark/LibreTV/releases
停止当前服务（stop.ps1）。
备份本机 .env 与 .libretv-password.txt（以及你自定义的源/配置）。
用新版 standalone 内容替换 你的安装目录\LibreTV 内程序文件（保留上述配置文件）。
确认 Node 仍为 18+，再运行 start.ps1 验证 http://127.0.0.1:8899。

若改用 Docker，可参考 Docker Hub 镜像 bestzwei/libretv；本说明默认路径为 Node 独立版，升级时优先更换 standalone 包即可。

简介