dnsforge/xteve

xTeVe Docker版

镜像概述

xTeVe是一款M3U代理服务器，支持Plex、Emby及任何兼容.TS和.M3U8（HLS）流格式的客户端与服务提供商。它通过模拟SiliconDust HDHomeRun OTA调谐器，使原本不支持IPTV的软件能够访问IPTV频道。本Docker镜像包含以下组件与功能：Guide2go、zap2XML、Crond定时任务系统及Perl支持。

核心功能与特性

• 模拟HDHomeRun调谐器，使IPTV频道可被Plex、Emby等媒体服务器识别
• 支持M3U和HLS（.TS/.M3U8）流媒体格式
• 集成Guide2go：用于获取Schedules Direct节目指南数据
• 集成zap2XML：支持Zap2it节目指南数据获取
• 内置Crond：支持定时任务自动化（如节目指南更新）
• Perl环境：支持相关脚本运行
• 灵活的网络模式：支持host模式（推荐）和bridge模式
• 可自定义时区、端口、调试级别等配置参数

使用场景

• 需要将IPTV频道接入Plex、Emby等媒体服务器的用户
• 需管理和优化IPTV频道列表的场景
• 需要自动化获取和更新节目指南数据的需求
• 希望通过Docker容器化部署xTeVe的环境

详细使用方法

Docker运行配置与容器映射

默认配置（推荐）

推荐使用host网络模式，命令如下：

bash
docker run -it -d --name=xteve --network=host --restart=always -v $PATH/xteve:/home/xteve/conf docker.xuanyuan.run/dnsforge/xteve:latest

隔离模式（Bridge模式）

仅在完全了解其用途时使用bridge模式，容器将分配独立的docker网络IP（通常在172.17.x网段）：

bash
docker run -it -d --name=xteve -p 34400:34400 --restart=always -v $PATH/xteve:/home/xteve/conf docker.xuanyuan.run/dnsforge/xteve:latest

包含Guide2go的配置

如需使用Guide2go，需添加Guide2go卷映射，以便从主机直接访问配置文件：

bash
docker run -it -d --name=xteve --network=host --restart=always -v $PATH/xteve:/home/xteve/conf -v $PATH/guide2go:/home/xteve/guide2go/conf docker.xuanyuan.run/dnsforge/xteve:latest

默认设置：

• 时区：America/New_York (EST)
• Web UI访问地址：[***]

自定义配置

可通过docker run命令或Docker GUI的"环境"选项卡自定义容器配置。以下是常用自定义示例：

自定义时区

bash
docker run -it -d --name=xteve --network=host --restart=always -e TZ=Europe/London -v $PATH/xteve:/home/xteve/conf docker.xuanyuan.run/dnsforge/xteve:latest

自定义端口及时区

bash
docker run -it -d --name=xteve --network=host --restart=always -e TZ=Europe/London -e XTEVE_PORT=8080 -v $PATH/xteve:/home/xteve/conf docker.xuanyuan.run/dnsforge/xteve:latest

默认容器路径

容器预配置以下环境变量及路径：

参数说明

Linux Shell访问

要连接容器执行本地命令，使用以下命令启动bash shell：

bash
docker exec -it <容器名称> /bin/bash

默认以root用户登录，输入"su - xteve"可切换至xTeVe用户。

部署示例

Linux系统

基础部署：

bash
mkdir -p $PATH/xteve
docker run -it -d --name=xteve --network=host --restart=always -v $PATH/xteve:/home/xteve/conf docker.xuanyuan.run/dnsforge/xteve:latest

包含Guide2go的部署：

bash
mkdir -p $PATH/xteve
mkdir -p $PATH/guide2go
docker run -it -d --name=xteve --network=host --restart=always -v $PATH/xteve:/home/xteve/conf -v $PATH/guide2go:/home/xteve/guide2go/conf docker.xuanyuan.run/dnsforge/xteve:latest

Synology系统

基础部署：

bash
mkdir /volume1/docker/xteve
docker run -it -d --name=xteve --network=host --restart=always -v /volume1/docker/xteve:/home/xteve/conf docker.xuanyuan.run/dnsforge/xteve:latest

包含Guide2go的部署：

bash
mkdir /volume1/docker/xteve
mkdir /volume1/docker/guide2go
docker run -it -d --name=xteve --network=host --restart=always -v /volume1/docker/xteve:/home/xteve/conf -v /volume1/docker/guide2go:/home/xteve/guide2go/conf docker.xuanyuan.run/dnsforge/xteve:latest

Guide2go配置

使用Guide2go需购买Schedules Direct订阅（$25/年）。通过以下命令配置节目指南：

bash
guide2conf --username <用户名> --password <密码> --max-days <最大天数[1-14]> --name <频道列表名称>

配置步骤：

1. 选择菜单中的"2. Add lineup"
   • 选择国家
   • 输入邮政编码
   • 选择服务提供商
2. 选择菜单中的"4. Manage channels"
   • 为所选频道列表选择"ALL"

注意：不建议在单个配置文件中添加多个频道列表。如需多个列表，请参考"额外Guide2go频道列表"部分。

3. 选择"0"退出，按提示完成初始频道列表下载并自动添加定时任务。

Guide2go定时任务

可通过guide2conf工具自动创建每日定时任务，或手动编辑crontab：

bash
crontab -e -u xteve

手动配置示例（每天凌晨1:15运行）：

bash
# 每天凌晨1:15运行Schedules Direct更新
15 1 * * * /home/xteve/bin/guide2conf --config /home/xteve/guide2go/conf/<频道列表名称>.yaml

生成的XMLTV文件路径：$XTEVE_CONF/data/guide2go.xml，需在xTeVe UI的"XMLTV"部分添加该文件。

额外Guide2go频道列表

一个Schedules Direct订阅最多支持4个独立频道列表。建议为每个列表创建单独的YAML配置文件，并错开定时任务时间以避免API限制。

配置步骤：

1. 运行配置命令：

bash
guide2conf --username <用户名> --password <密码> --max-days <最大天数[1-14]> --name <新频道列表名称>

2. 选择菜单中的"2. Add lineup"
   • 选择国家、邮政编码和服务提供商
3. 选择菜单中的"4. Manage channels"
   • 为原列表选择"NONE"
   • 为新列表选择"ALL"
4. 选择"0"退出，YAML文件将保存至$GUIDE2GO_CONF/<新频道列表名称>.yaml

定时任务配置：

bash
crontab -e -u xteve

添加新任务（示例）：

bash
# 每天凌晨1:30运行第二个频道列表更新
30 1 * * * /home/xteve/bin/guide2conf --config /home/xteve/guide2go/conf/<新频道列表名称>.yaml

zap2XML定时任务

使用zap2XML需注册免费Zap2it账户。可通过guide2conf工具或手动配置定时任务：

配置命令

bash
guide2conf --username <邮箱> --password <密码> --max-days <最大天数[1-14]> --name <频道列表名称>

手动定时任务配置

bash
crontab -e -u xteve

添加任务（示例）：

bash
# 每天凌晨1:15运行zap2it更新
15 1 * * * /home/xteve/bin/zap2xml.pl -u username@domain.com -p ******** -U -c $XTEVE_CACHE/zap2xml/<频道列表名称> -o $XTEVE_CONF/data/<频道列表名称>.xml

生成的XMLTV文件需在xTeVe UI的"XMLTV"部分添加。

注意：tvguide.com服务已停止支持，不再可用。