xTeVe 分步指南

欢迎来到 xTeVe 的奇妙世界！- 一个开源免费的 M3U 代理 服务器，专为 Plex DVR 和 Emby Live TV 服务而设计。 

在本教程中，我们将详细介绍 xTeVe 是什么、开始使用需要什么以及如何在各种操作系统上下载和安装。我们将指导您完成初始配置，并向您展示如何使用界面进行持续配置。 

因此，请系好安全带，准备好参加一次有趣而丰富的旅程！

免责声明： 免责声明：本材料仅供参考。它并不构成对任何活动（包括非法活动）、产品或服务的认可。在使用我们的服务或依赖此处的任何信息时，您全权负责遵守适用的法律，包括知识产权法。对于因以任何方式使用我们的服务或此处包含的信息而造成的损害，我们不承担任何责任，除非法律明确要求。

目录

1. 什么是 xTeVe？ 
2. xTeVe：开始需要什么？ 
3. 下载并安装 xTeVe（Linux、Windows 和 Docker）。
   • 通过 Docker 容器安装（推荐）。 
   • 直接在 Linux 机器上安装 
   • 在 Windows 机器上安装。 
4. xTeVe 初始配置。 
5. xTeVe 的持续配置。 
6. 决赛 字数. 

1.什么是 xTeVe？

xTeVe 是一款 M3U 代理服务器，专为 Plex DVR 和 Emby Live TV 服务而设计。它根据 MIT 许可免费开源。xTeve 使用 M3U（文件或 URL）和 XMLTV（文件或 URL）获取播放列表和向导信息。

说点技术性的：

M3U 文件包含组成多媒体播放列表的多媒体文件的名称、URL、元数据和文件路径列表。 在 IPTV 环境中，M3U 文件可以提供一个频道和流列表，IPTV 播放器或客户端应用程序（如 Plex 或 M3U）可以访问这些频道和流。 安比. 

虽然您可以使用 VLC、media player 或 Kodi 等媒体播放器播放播放列表中包含的媒体，但您需要 xTeVe 这样的 M3U 代理才能通过互联网访问和串流直播电视频道，并建立整个频道指南。它还能让客户端设备在不直接访问提供商服务器的情况下播放 IPTV 频道。使用这种 M3U 代理的好处是，它允许在世界任何地方访问 IPTV 频道。

它是如何工作的？

M3U 代理 读取 M3U 播放列表文件，并与 IPTV 提供商建立连接。 它充当 IPTV 提供商和客户端应用程序（如 Plex 或 Emby）之间的中间人。 

M3U 代理服务器从提供商处获取 IPTV 流媒体，将其重新打包成兼容格式，然后流式传输到客户端设备。

2. xTeVe：开始需要什么？

运行 xTeVe 需要一台服务器（兼容 Windows、Linux 和 macOS）。此外，你还需要一个 IPTV 提供商的有效账户。该账户应能让你访问想看的电视频道。你还需要 IPTV 播放列表文件，可以从 IPTV 提供商（或第三方提供商）处获取。最后，请记住，IPTV 没有内置播放器，因此您需要一个单独的媒体播放器，如 Plex 或 Emby。

a.服务器的要求。

xTeVe 仅支持 64 位处理器。它可以安装在 Windows、OS X、Linux 和 FreeBSD（64 位 Intel/AMD）以及 Linux（64 位 ARM）中。 建议将其安装在 Docker 容器中（由 Linux 64 位托管）。 您的服务器还应运行更新版本的 Plex Media Server 或 Emby。了解有关 设置 Plex 媒体服务器 请参阅我们的完整指南。

Plex 要求。 

• Plex 媒体服务器（1.11.1.4730 或更新版本）
• 支持 DVR 的 Plex 客户端
• Plex 通行证

Emby 要求。

• Emby 服务器 (3.5.3.0 或更新版本)
• 支持电视直播的 Emby 客户端
• Emby 首映式

b.配置要求。

如前所述，xTeVe 使用 M3U（文件或 URL）和 XMLTV（文件或 URL）向 IPTV 播放器或客户端发送频道和流列表。 Plex 等应用程序 或 Emby。它能读取 M3U 播放列表，并在 IPTV 提供商和应用程序之间开启通信。 

因此，要设置 xTeVe，您需要访问 M3U 和 XMLTV 数据，IPTV 提供商通常会提供这些数据，但您也可以从第三方来源找到这些数据。 

查找 M3U 播放列表

查找 M3U 播放列表的最简单方法是通过 Google 或 Bing 等搜索引擎平台进行在线搜索。你可以在网站或论坛上获取 M3U 文件或 URL，但最重要的是不要使用可能包含恶意软件或盗版媒体的网站。此外，如果您目前订阅了 Spotify 或 Apple Music 等流媒体服务，您可以生成一个播放列表并将其导出为 M3U 文件。

获取 XMLTV 文件

在 xTeVe 中输入 M3U 播放列表 URL 时，服务器会读取播放列表文件并提取频道信息。但是，M3U 播放列表文件通常只包含频道名称和频道流 URL。它没有额外的电视列表信息，如频道标识、节目指南信息或频道元数据。这就是 XMLTV 文件发挥作用的地方。通过导入 XMLTV 文件，您可以为 M3U 播放列表中的频道添加节目指南信息和其他元数据。 

要管理 IPTV 播放列表和 EPG（电子节目指南）数据（XEPG 和 PMS），可以使用 Xtream 编辑器这是一个基于网络的平台，允许您组织和定制频道列表。 

在 Xtream 编辑器中，您需要创建一个模板 > 然后创建一个播放列表 > 然后下载 M3U 文件和 EPG 数据（XMLTV）。 使用该软件，您可以创建播放列表（及其 XMLTV 数据），然后复制它们。

注意： 完全管理 IPTV 播放列表和 EPG 数据的步骤不在本教程范围之内。

3.下载和安装 xTeVe（Linux、Windows 和 Docker）

在本节中，我们将指导您完成下载和安装 xTeVe 的过程。我们将介绍在三种不同平台上的安装过程：Linux、Windows 和 Docker（通过 Linux 和 Windows）。

免责声明： 以下是下载和安装 xTeVe 的指南，仅供参考。我们 Rapidseebox 我们不会将其作为解决方案的一部分提供，也不会为该软件提供任何客户支持。

a.通过 Docker 容器安装 xTeVe（推荐）。 

如果要通过 Docker 容器运行 xTeVe，以下是推荐的 xTeVe Docker 镜像（根据官方来源）。这些 Docker 映像专为 Linux 64 位操作系统设计。它们与其他组件一起打包，例如 Guide2go (的 XMLTV 抓取器）、 owi2plex (Enigma 接收器的 XMLTV 文件抓取器），以及 Zap2XML (开源的基于 Perl 的 zap2it XMLTV 抓取器）。

推荐的 Docker 映像是 

• 由 Altruismo 创建
  • https://hub.docker.com/r/alturismo/xteve (docker pull alturismo/xteve)
  • https://hub.docker.com/r/alturismo/xteve_guide2go (docker pull alturismo/xteve_guide2go)
  • https://hub.docker.com/r/alturismo/xteve_g2g_owi (docker pull alturismo/xteve_g2g_owi)

• 由 LeeD. 
  • https://hub.docker.com/r/dnsforge/xteve (docker pull dnsforge/xteve)

如何安装 xTeVe Docker 容器 (Linux)。 

• 首先，确保运行的是更新版本的 Docker，然后发出 "pull "命令。我们将使用 cron 在 Docker 上运行 xTeVe。  

• 要运行映像中的 Docker 容器，请执行以下命令。 该命令将启动运行 xTeVe 应用程序的 Docker 容器（在分离模式下-d，即在后台运行）。 

注意： 这是 (https://hub.docker.com/r/alturismo/xteve.您需要更改时区和挂载卷。例如，我们在下面的配置行中更改了时区和挂载卷。 

• 要检查容器的状态，请使用以下命令： 

• 使用以下命令运行 xTeVe 容器的 cronjob 脚本。 ./config/cronjob.sh 参数指定容器内 cronjob 脚本的路径。 该脚本用于更新 EPG 数据和其他计划任务。

• 运行 xTeVe Docker 容器并检查其状态后，现在就可以打开网页浏览器访问 xTeVe 图形用户界面，网址是 http://localhost:34400/web。 如果更改端口或从远程机器访问 xTeVe 服务器，情况可能会有所不同。 

替代安装（Windows 上的 Docker）。 

对于 Windows，您可以使用 Docker 容器管理器，如 Docker Desktop. 

• 我们从 Docker Hub 下载了 xTeVe Guide2Go 映像并创建了容器。xTeVe + Guide2Go 容器现在正在运行。 

• 如果安装了容器，就可以使用 http://localhost:34400/web/ URL 地址访问图形用户界面控制台。或者，如果从远程机器访问 xTeVe，可能需要更改本地主机。  

b.直接在 Linux 机器上安装 xTeVe。

• 下载最新的 xTeVe Linux amd64 软件包。要查看 URL 或检查最新软件包，请访问 https://github.com/xteve-project/xTeVe. 

• 打开 Linux（Ubuntu）终端，使用 "wget "命令下载最新的 xTeVe 软件包。 
• 例如

• 现在，解压缩新的 xTeVe 软件包。 您可以创建一个新目录来保存所有提取的文件夹。 
• 我们将在主目录"~/"中创建一个名为 "bin "的目录，并将新文件 "xteve_linux_amd64.zip "的所有内容解压缩到该 "bin "目录中。

• 现在，我们可以使用 xTeVe 二进制程序运行 xTeVe 应用程序了。 转到解压 xteve_linux_amd64.zip 压缩包的目录，设置正确的权限，然后运行二进制文件。

• 运行二进制文件将运行 xTeVe 应用程序。 路径"/home/ubuntu/bin/xteve"（或 ./xteve）是我们当前运行的 xTeVe 可执行文件的路径。 
• xTeVe 现在已准备就绪，可以开始为您配置的 IPTV 频道提供服务。要停止 xTeVe 应用程序的运行，请在 xTeVe 运行时按下 Ctrl + C。

配置 xTeVe

现在，你可以启动 xTeVe 并生成配置文件。你必须使用-configure选项重新运行xTeVe二进制文件。如果你已经将 xTeVe_linux_amd64.zip 压缩包解压缩到 /home/ubuntu/bin/ 目录下（如前所述），现在可以按照以下步骤操作：

• 从输出（./xteve）中可以看到各种 xTeVe 参数。 该输出是非常有用的信息，可以帮助您配置 xTeVe。 以下是相关参数的摘要。

• 调谐器（Plex / Emby）： 这一行显示 Plex 或 Emby 可用的调谐器设备数量。在我们的情况下，只有一 (1)。
• EPG 来源： 这一行表示 xTeVe 的 EPG（电子节目指南）源是 PMS（Plex 媒体服务器）。
• Plex 通道限制： 指定 xTeVe 可提供给 Plex 媒体服务器的最大通道数，默认设置为 480。
• 未经过滤的陈。限制 这一行指定 xTeVe 可以提供的最大未滤波通道数，默认设置也是 480。
• 全流： 这表明 xTeVe 中没有流 (0) 正在播放。
• 活动流： 根据这一行，xTeVe 中目前没有活动 (0) 数据流。
• 过滤器 这一行表示 xTeVe 中未设置滤波器（0）。
• DVR IP： 这一行指定了 xTeVe 所连接的 DVR（数字视频录像机）的 IP 地址和端口号。在我们的例子中，是 172.31.83.239:8080。
• 网络界面： 此行指定 xTeVe 网络界面的 URL，可通过指定的 IP 地址、端口号和其他三个 IP 地址访问。

现在，让我们配置 xTeVe： 

• xTeVe 将允许您修改参数；例如，在下一节中，我们将修改 xTeVe 端口。
• 上述命令（/home/ubuntu/bin/xteve -config）将以配置模式启动 xTeVe。它将在 xTeVe 二进制文件的同一目录下生成名为 xTeVe.json 的配置文件。 

• 默认情况下，xTeVe 通过 34400 端口运行，但我们可以使用"-port "标记指定不同的端口。
• 例如，使用以下命令可在 8080 端口启动 xTeVe。 

• 默认情况下，打开 Web 浏览器并导航至 http://localhost:34400/web/（或其他端口，如上例中的 localhost:8080/web），即可访问 xTeVe Web 界面。如果在远程服务器上运行 xTeVe，请将 localhost 替换为服务器的 IP 地址或主机名。
• 要停止 xTeVe，请在运行 xTeVe 的终端窗口中按下 Ctrl + C。

注意： 如果已将 xTeVe 配置为守护进程或服务运行，则可使用系统的相应命令启动或停止 xTeVe。

c.在 Windows 机器上下载并安装 xTeVe。

在 Windows 上下载和运行 xTeVe 非常简单，只需访问官方下载链接、下载压缩文件、解压缩并以管理员权限运行 .exe 文件即可。 

• 请前往 https://github.com/xteve-project/xTeVe 
• 为您的 Windows 机器选择合适的软件包。 
• xteve.exe 是一个二进制文件，必须双击才能启动。  

• 下载 Windows (xteve_windows_amd64.zip)文件，双击该文件并允许访问 Windows 防火墙。创建一个新文件夹，名为 "xTeVe "或其他你喜欢的文件夹，并将压缩文件的内容解压缩到该文件夹中。 
• 别忘了以管理员身份运行 .exe！

• xTeVe 服务将启动并在后台运行。运行后，您可以通过提供的网络界面（localhost:34400/web 或 IP_XteVe_server:Port/web）访问它。

将 xTeVe 安装为 Windows 服务。  

您还可以将 xTeVe 安装为 Windows 服务，使其在电脑启动时自动启动。它将在后台运行，不会干扰你在电脑上使用的其他应用程序。作为 Windows 服务运行还能保证 xTeVe 的可靠性和可管理性。 

• 首先下载一个服务管理器，如 NSSM，然后将内容解压缩到计算机上的一个文件夹中。
• 以管理员身份打开 "命令提示符"，并导航到解压缩 NSSM 的文件夹。
• 键入以下命令启动 NSSM 服务安装程序："nssm install Xteve" （NSSM 安装 Xteve
• 设置以下选项：
  • 路径：输入 xTeVe 可执行文件的完整路径，例如 C:\PathToXteve\xteve.exe
  • 启动目录：输入 xTeVe 安装文件夹的路径，例如 C:\PathToXteve
  • 参数：输入要传递给 xTeVe 的其他参数，如 -config=C:\PathToXteve\Config 或 -port="XXXX"（其中 XXXX 是所需的端口号）。
• 点击 "安装服务 "按钮，将 xTeVe 安装为 Windows 服务。
• 键入以下命令 "nssm start xteve "启动 xTeVe 服务

4. xTeVe 初始配置。

现在 xTeVe 已经在服务器上运行，并且可以成功打开，您必须对其进行配置。 开始使用 xTeVe 时，系统会要求您设置一些重要设置。 

注意： 如果每次打开 xTeVe 的 Web 界面 IP 地址都在不断变化，则需要从路由器为其分配一个静态 IP 地址。这可能是因为每次启动 xTeVe 服务时，DHCP 服务器（很可能是家用路由器）都会不断 "动态 "分配新的 IP 地址。 

使用 "IP_address:port/web "或 "localhost:port/web "打开 xTeVe 的图形用户界面。 欢迎使用安装向导。 

a.调谐器数量。 

• 设置调谐器数量。 xTeVe 的安装向导会要求您设置调谐器的数量。调谐器是指可与 IPTV 提供商建立的并行连接数。如果 IPTV 提供商为同一账户提供多个并发用户，则需要在此处进行定义。与提供商建立并行连接的数量取决于提供商的政策和限制。
• 要知道调谐器的数量，您需要了解 IPTV 提供商为您提供了多少个流媒体。 目前，我们只有一个调谐器可用，这意味着 xTeVe 只能同时串流一个频道。

b.为 xTeVe 选择 EPG 来源。 

电子节目指南（EPG）源是包含电视频道及其节目表信息的数据源。这些 EPG 源采用机器可读格式。它们通常被电视列表服务、媒体中心软件和 IPTV 服务器用来向用户显示电视指南信息。

使用 xTeVe，您可以选择两种 EPG 格式：

• PMS： Plex / Emby 对 EPG 数据进行配置的地方
• XEPG： xTeVe 中的 EPG 数据以 XMLTV 文件的形式提供，需要指定该文件作为源文件。您的 IPTV 提供商应提供 XMLTV 链接，但您也可以使用第三方提供商，如 epg.best, 编辑器或 天文台/环境局社区.

• 查找 M3U 播放列表文件或 URL。 如上一节所述，您可以通过快速在线搜索找到一个 M3U 播放列表（但请记住，您还需要携带 XMLTV 文件）。 
• 播放列表的一个好来源是 GitHub - iptv-org/iptv:全球公开 IPTV 频道集。

• 如果在上一节中选择 XEPG 作为 EPG 来源，则必须指定一个 XMLTV 文件，可以是本地文件，也可以是网络服务器上的文件。
• xTeVe 网络用户界面（PMS 作为 EPG 源）的打开方式如下：

5. xTeVe 持续配置。

xTeVe 的图形用户界面简单而实用。在顶部，您可以找到有关设置的重要信息。如 CLI 安装部分所示，在图形用户界面中，您还可以看到 xTeVe 版本、操作系统、DVR IP、UUID、Arch、M3U URL、可用流、EPG 源、XEPG URL、XEPG 频道、错误和警告等信息。 

xTeVe 的左侧菜单显示了播放列表、过滤器、XMLTV、映射、设置和日志等重要功能。 

a.管理播放列表

以下是 xTeVe 网络用户界面（XEPG 作为 EPG 源）。

• 在 "播放列表 "窗口中，您可以看到当前的 M3U 播放列表及其信息。此外，您还可以在这里创建 "新 "播放列表。 

• 单击 "新建"> 添加新的 M3U 播放列表信息，包括名称、说明、M3U 文件和调谐器/流。 

b.检查日志

从一开始就检查日志有助于找到导致配置的任何错误和警告。 

• 进入左侧菜单中的 "日志 "菜单，阅读日志中的红线或黄线。例如，我们收到了一条警告。 
• 警告 >... [xTeVe] [WARNING] xTeVe 已加载超过 480 个数据流。使用过滤器减少数据流数量。 

• 因此，现在我们要创建一个过滤器，因为 Plex 的频道不能超过 480 个。 

c.创建过滤器。

Xteve 中的过滤器可让您管理和组织频道。利用过滤器，您可以根据自己的喜好定制 IPTV 播放列表，删除不需要的频道，或提高性能（通过减少 xTeVe 需要处理的数据量）。 

下面介绍如何在 Xteve 中创建过滤器：

• 点击左侧菜单上的 "过滤器 "选项卡。
• 点击 "新建 "按钮创建新的过滤器。
• 选择过滤器类型（如 M3U 组标题）。

• 为过滤器命名，并选择用于过滤频道的标准。您可以按名称、类别、国家、语言等过滤频道。
• 选择标准后，点击 "保存 "按钮创建新的筛选器。
• 现在，您的新过滤器将出现在 "过滤器 "选项卡中。 
• 您可以点击它来查看符合筛选条件的频道。

注意： 请注意，如果您在 xTeVe 中创建了过滤器，随后又添加了通道，则已建立的过滤器将影响进入 xTeVe 的新数据。因此，如果您预先设置了过滤器，则可能无法看到可用的数据流或通道。 

d. xTeVe 映射

在 xTeVe 图形用户界面中、 映射是指将 IPTV 信号源中的特定频道分配给设备或播放器上的特定频道号的过程。

• 添加播放列表和 EPG 频道后，必须将播放列表频道（M3U 数据）映射到 EPG 频道（XMLTV 数据）。 
• 您会注意到，有些频道有自己的徽标，但是 仍需绘制。 

• 双击频道。为频道命名，找到徽标 URL（如果有的话），并选择 EPG 类别。 最重要的是，选择正确的 XMLTV 文件和 XMLTV 频道。 

• xTeVe 使用彩色标签。红色的频道尚未映射，而绿色的频道已准备就绪。开始映射时，请查找正确的 EPG ID 并将其与频道名称匹配。 如果有 EPG ID，就有媒体内容。 
• 将足够的播放列表频道映射到 EPG 频道后，点击保存。您还会发现 XEPG 频道开始出现。 

e.使用 Plex 媒体服务器配置 xTeVe。  

您的 xTeVe 服务器应该运行更新版的 Plex 媒体服务器（PMS）。此外，您的 Plex 客户端应支持 DVR，您的账户还应拥有 Plex 通行证。了解更多 设置 Plex 媒体服务器 请参阅我们的 2023 年完整指南。 

• 首先进入 xTeVe 并复制 DVR IP

• 转到 Plex Media Server > Live TV。您将看到 Plex 提供的频道列表。 

• 为了说明如何使用 xTeve 将频道添加到 PMS，我们将配置 Plex 的实时电视和 DVR 设置。 
• 转到 "设置" > "直播电视和 DVR" > 点击 "设置 Plex DVR"。 

• Plex 媒体服务器将开始寻找基于 HDHomeRun 的调谐器。点击 "看不到您的 HDHomeRun 设备？手动输入其网络地址"。

• 输入 HDHomeRun 设备地址（xTeVe 服务器 IP），然后点击 "连接"。
• Plex 媒体服务器会找到并识别它。它还会找到可用的频道。 

调谐器设置。

• 如果您所在的位置无法使用 Plex 的内置 DVR 向导数据，或者内置数据不包括您需要的频道，您可以使用外部 XMLTV 服务为 Plex DVR 提供向导数据。使用外部 XMLTV 服务，您可以扩展 Plex DVR 中可用的频道数量。
• 要使用 XMLTV 指南，必须提供语言和 XMLTV 指南链接，并给指南起一个标题。 

• 点击 "继续 "开始频道扫描。 

• Plex 媒体服务器将开始下载 EPG 数据。您可以通过侧边栏菜单中的 "实时电视 "访问指南和频道。 

• 点击 "查看指南"。在该屏幕上，您将看到可用的频道。 

• 返回 LiveTV，您会发现 xTeVe 中添加了频道播放列表中的频道。 

注意： 如果无法播放内容，请检查 Plex 上的天线或电缆设置。此外，您可能还需要尝试更改国家和邮政编码（如果您使用的是第三方提供的 XMLTV 文件）。 

6. 最后的话

到此为止，各位！希望本教程对您有所帮助。有了 xTeVe，您现在可以前所未有地组织和精简您的流媒体频道。请记住，这只是 xTeVe 功能的冰山一角。

尝试使用界面，创造性地使用频道映射，让它真正属于你自己。祝您串流愉快