文档配置

配置

环境变量

变量 必填 默认 说明
PASSWORD 是 — 访问密码。未设置时站点可用但所有功能接口返回 503，并提示管理员配置
PROXY_SECRET 否 从 PASSWORD 派生 会话与代理签名密钥。单实例可不设；多实例/负载均衡部署必须显式设置，否则各实例会话互不认账
REQUEST_TIMEOUT 否 8000 代理上游请求超时（毫秒）
MAX_RETRIES 否 1 代理请求重试次数
SEARCH_MAX_PAGES 否 5 每个搜索源最多抓取的页数（1-50）。第一页响应携带源站真实总页数 pagecount，实际抓取页数取两者较小值；后续页并行请求，单页失败仅丢弃该页。调大会显著增加上游请求量（约等于 源数 × 页数），搜索延迟与源站压力随之上升
USER_AGENT 否 Chrome UA 代理请求使用的 UA（豆瓣防盗链等场景）
DEFAULT_SOURCES 否 — 预置采集站，JSON 数组，见下文 预置采集站
60S_API_BASE 否 https://60s.viki.moe 影视榜单推荐源（豆瓣周榜/百度热播）使用的 60s API 实例地址。服务端每类榜单缓存 1 小时，官方公共实例限流下通常够用；高频使用可用 docker run -d -p 4399:4399 vikiboss/60s:latest 自部署后指向它
DEBUG 否 false 调试日志

旧版的 CORS_ORIGIN、CACHE_MAX_AGE、BLOCKED_HOSTS、BLOCKED_IP_PREFIXES、FILTERED_HEADERS 在重构版中已内化为安全默认值，不再需要配置。

预置采集站（DEFAULT_SOURCES）

部署者可通过环境变量为所有用户预置数据源，用户无需手动添加即可搜索：

DEFAULT_SOURCES=[{"name":"示例源","url":"https://example.com/api.php/provide/vod","detail":"https://example.com","isAdult":false}]
  • 格式为 JSON 数组，每项支持 name（必填）、url（必填，http/https）、detail（可选详情页地址）、isAdult（可选成人标记）；
  • 解析失败会在服务端日志告警并整体忽略，不影响站点运行，最多生效 50 个（与搜索接口上限一致）；
  • 预置源由服务端经 /api/status 下发，展示在设置抽屉顶部并带「部署者预置」标记，用户可勾选/取消但不可编辑或删除；
  • 预置源首次出现时自动勾选（开箱即搜）；用户取消勾选后刷新页面不会被反复勾回；
  • 预置源不参与用户侧的配置导出（导出文件只含用户自建源），部署者变更环境变量即可全站生效。

运行时设置（用户级）

以下设置保存在每个用户浏览器的 localStorage（键 libretv-settings），通过「设置」抽屉修改：

数据源

  • 自定义 API 列表：名称、API 地址、详情页地址（可选）、成人标记；
  • 勾选参与搜索的源：仅勾选的源会参与聚合搜索与换源；
  • 源订阅：远程源列表地址与上次同步时间，格式与行为见 Data-Sources · 源订阅。同步为手动操作（订阅条目 ⟳），远端列表更新后需手动刷新。

播放与过滤

开关 默认 说明
成人内容过滤 开 服务端按分类关键词过滤（伦理片/福利片等）
广告过滤 开 hls.js loader 剔除 m3u8 中的 #EXT-X-DISCONTINUITY 广告片段
自动连播 开 单集结束自动播放下一集
豆瓣推荐 开 首页展示豆瓣热门影视

封面图加载方式

方式 说明
内置代理（默认） 经 /api/proxy/ 转发（带豆瓣 Referer 伪装），规避豆瓣防盗链与图床直连失败
直连 浏览器直接加载豆瓣/采集站封面，最快；部分网络下豆瓣图会 418
自定义代理 模板字符串，{url} 为编码后的原图地址；不含占位符则直接拼接

主题

  • 头部太阳/月亮/显示器图标，点击在 浅色 → 深色 → 跟随系统 间循环；
  • 存储于 localStorage['libretv-theme']；
  • 页面 HTML 内有同步脚本，刷新无闪烁；
  • 跟随系统模式下监听 prefers-color-scheme 变化实时切换。

配置导入导出

  • 导出：生成 LibreTV-Settings_<时间戳>.json（数据源、播放设置、观看历史、搜索历史）；
  • 导入：兼容旧版 LibreTV 导出的配置文件；旧版观看历史（含全集 URL 列表）会自动迁移为定位信息格式。

存储结构（IndexedDB libretv）

表 主键 字段 说明
history id = sourceKey_vodId title, pic, episodeIndex, totalEpisodes, playbackPosition, duration, timestamp 上限 100 条，超出淘汰最旧
progress key = sourceKey_vodId_index position, duration, updatedAt 每集一条，看完清除
searchHistory text timestamp 上限 10 条