-
Notifications
You must be signed in to change notification settings - Fork 27.5k
FAQ
Q: 打开站点一直提示"需要配置密码"？
服务器未设置 PASSWORD 环境变量。Docker 部署检查 .env；手动部署确认启动命令中带 PASSWORD=...。设置后需重启服务。
Q: 登录后刷新又要求输入密码？
- 生产环境（HTTPS）下 Cookie 为
Secure，用 HTTP 访问生产构建会导致 Cookie 无法保存——请配置 HTTPS 或以开发模式运行； - 多实例部署未设置
PROXY_SECRET：各实例派生密钥不同，会话互不认账。
Q: 忘记密码怎么办？
修改 PASSWORD 环境变量并重启。旧会话立即全部失效（密钥随之改变）。
Q: 搜索提示"请先添加点播源" / "尚未勾选点播源"？ 本项目不内置采集站。到「设置 → 源管理 → 点播源」添加 Apple CMS 采集站地址并勾选；想一次导入多个源可用「设置 → 源管理 → 数据源订阅」。
Q: 搜索时为什么一部分结果先出来？ 首页搜索是流式的：每个源结算后结果立即渲染（标题行显示「已就绪 X/Y 个源」），健康源不必等慢源或坏源超时。最终以服务端聚合去重排序后的完整结果为准。
Q: 某个源一直搜索失败？
结果区顶部会列出失败源名称（⏱ 超时 / ✗ 失败）。连续失败 2 次的源会被自动暂停参与搜索，且惩罚逐级加重：30 分钟 → 24 小时 → 长期停用（长期停用需手动恢复）。每成功一次降一级，所以偶尔抽风的源会自己恢复，只有始终失败的源才会升到长期停用。直接浏览器访问 {api}?ac=videolist&wd=test 判断是源挂了还是网络不通；确定不用的源可以取消勾选或删除。
Q: 设置里源旁边显示的两个延迟徽章有什么区别？
绿色「✓ Xms」（悬停提示「上次搜索 Xms」）来自健康度记录，是该源在上次真实聚合搜索中的总耗时（含分页抓取），随每次搜索自动刷新；⚡ 按钮旁的徽章来自手动探活（固定关键词 test 的单次请求往返），仅在点击后显示。两者测量对象、时刻、口径都不同，数值不一致属正常。
Q: 搜索结果为什么按名称排序？ 跨源聚合后按影片名（zh-CN locale）排序、同名片按源名排序，便于对比同一影片在不同源的画质/集数。
Q: 从播放页返回搜索页会重新搜索吗？ 通常不会。客户端缓存搜索结果 5 分钟、服务端缓存同一关键词+源组合的结果 60 秒：返回时直接呈现缓存，不重复请求上游。需要强制刷新时重新提交一次搜索即可。
Q: 详情为什么有缓存？会不会导致新剧集看不到？ 详情接口有 60 秒服务端缓存（同一影片 + 同一源），用于换源测速等场景避免重复打上游。剧集更新以源站为准，60 秒后即取到最新。
Q: 最近搜索（搜索历史）怎么不见了？
已从「常驻在搜索框下方」改为聚焦下拉：点一下搜索框即展开最近 10 条，输入时按关键字实时过滤，支持 ↑ ↓ 选择、逐条删除与一键清空（清空后可撤销）。这样首屏更干净，也消除了首次搜索后那一行出现导致的布局跳动。详见 Configuration · 搜索历史。
Q: 直播页提示"请先在设置中添加直播源"？
本项目不内置任何频道。到「设置 → 源管理 → 直播源」添加 M3U 订阅地址（如 https://iptv-org.github.io/iptv/countries/cn.m3u），或部署者通过 DEFAULT_LIVE_SOURCES 预置。
Q: 同一订阅里一部分频道能播、一部分不能？ 公共 IPTV 源的正常现象。原因按频率排序：源已失效、H.265 编码（Chromium 无法软解，用 Edge/Safari）、Geo-block、非全天信号、防盗链。先在侧栏对当前分组「⚡ 测活」，红色频道直接跳过；详细排查见 Live-IPTV · 播放不了？。
Q: 测活绿色但仍播不出来？ 测活验证到分片级（网络可达），但编码解码只能在播放阶段暴露——黑屏且测活绿色多半是 H.265，播放器会提示换用 Edge/Safari。另外部分源限制服务器 IP 访问，直连与代理都无法绕过。
Q: 直播有进度条吗？能倍速吗？ 没有。直播态隐藏进度条/倍速/截图/自动连播等点播专属控件；直播播放器与点播播放器是独立实现，互不影响。
Q: 节目单（EPG）不显示？
需要同时满足：订阅配置了 EPG 地址（XMLTV 格式）且频道带 tvg-id。不同源的 tvg-id 命名规则不一致会导致匹配率低，属列表质量问题。
Q: 内网自建的 IPTV 源无法播放 / 无法拉取？
默认被 SSRF 防护拦截。自部署者可显式设置 LIVE_ALLOW_PRIVATE=1，该开关对「M3U 列表拉取」与「直播流代理」两个阶段同时生效。
Q: 想用 PotPlayer/VLC 看怎么办？ 设置 → 源管理 → 直播源 → 条目上的 ⇩ 按钮可把订阅导出为标准 M3U 文件，直接导入外部播放器。
Q: 视频一直"正在加载"？ 按顺序尝试：① 点「切换资源」换其他源；② 设置中切换封面/直连相关配置确认网络；③ 该源分片可能仅允许特定地区/Referer，代理回退通常能自动解决，若仍失败请换源。
Q: 出现"直连失败，改用代理重试"后播放正常，但快进卡顿？ 代理播放的带宽受限于服务器。属预期行为，建议优先寻找可直连的源。
Q: 自动跳到下一集后从头播放了？ 确认「自动连播」开关已打开（播放页操作栏或设置中）。
Q: 换源后集数对不上？ 换源按集数索引对齐，目标源集数少于当前集数时会回到第 1 集。
Q: 首页推荐区不显示 / 加载失败？
先确认「设置 → 偏好设置 → 首页与内容 → 首页推荐」开关已打开。加载失败按来源区分：豆瓣多为上游限流（可配置 FALLBACK_CORS_PROXY 降级）；影视榜单多为官方 60s 公共实例限流或被墙（可自部署后用 60S_API_BASE 指向），详见 Recommendations。
Q: 推荐内容点开后搜不到片源？ 推荐只提供片名与封面，实际播放依赖你在「设置 → 源管理 → 点播源」里配置的采集站覆盖范围。换标题关键词重搜或补充更多采集源。
Q: 换浏览器/设备后历史和进度还在吗？ 不在。历史与进度保存在本机 IndexedDB，不上传服务器。可用「设置 → 数据 → 配置导入导出 → 导出配置」手动迁移。
Q: 观看历史里某条记录播放时提示"点播源不存在"？ 该记录的来源点播源已被删除。重新在设置中添加同名 API 地址（key 一致即可恢复），或删除该历史。
Q: IndexedDB 数据会占多少空间？ 仅存定位信息（不含全集 URL），100 条历史通常 < 100KB。
Q: 为什么订阅导入的源不能单独编辑或删除？ 订阅是「以远端列表为准」的数据源：单独编辑会在下次同步时被覆盖，单独移除会在重新同步时复活，所以这两个按钮是禁用态（并附有说明）。要调整请改远端列表后同步、或用订阅开关整体停用、或直接删除整个订阅。
Q: 订阅的开关和源列表的勾选框，有什么区别？ 两者的视觉结果一样（该源是否参与搜索），但语义不同：勾选框是「从 N 个源里挑哪几个参与」，配合源列表的「全选 / 全部启用」使用；开关是「这一条订阅整体启停」——它不改动任何单个源的勾选状态，关掉再打开完全无损。想临时不用整个订阅又不想丢配置用开关，只想排除其中个别源用勾选框。
Q: 「发布为链接」安全吗？
发布走服务端代理上传到公开粘贴板（paste.rs，失败自动降级 0x0.st），内容是公开可读的——任何拿到链接的人都能看到你的源列表；免费粘贴板也可能随时清理，且每次发布生成新链接（不支持覆盖更新）。接口只透传白名单字段（名称 / 地址 / EPG）并需要登录会话。敏感或需长期稳定的列表，建议「导出数据源」后自行托管（Gist / 对象存储 / 私有仓库 raw）。
Q: 密码是明文传输吗？ 登录请求把密码放在 POST body 中，生产环境务必启用 HTTPS 防止传输层被窃听。
Q: 代理会被滥用吗？ 代理需要登录会话；未登录仅放行图片类目标且同样受 SSRF 校验约束。公网部署建议在反代层再加 IP 级限流。
Q: 为什么不给站点加注册/多用户？ LibreTV 定位为轻量自托管工具，单密码门禁 + 本机数据即可满足场景；多用户会引入服务端存储与隐私复杂度。