iptvboss docker

IPTVBoss VNC Docker 镜像

如果您无法连接到云提供商，可能是因为：

1. 使用 root 用户运行容器，而不是使用非 root 用户

• 不要使用 ROOT 用户运行容器，它不会工作。

2. 容器卷未正确挂载，卷权限不正确

• 定义您自己的用户并使用您的用户 UID/GID 详细信息为您的卷设置正确的权限。

---

• 此 Docker 映像提供了带有 IPTVBoss 应用程序的 VNC 服务器。
• IPTVBoss 通过 apt 预安装在/usr/lib/iptvboss目录中。您可以自定义其配置和设置。
• 它包括配置 Cronitor 以监视本地 cron 作业的选项。查看下面的说明以启用 Cronitor 监控。
• rclone 还安装在容器中，允许用户将其 IPTVBoss 数据同步到云存储提供商。

先决条件

• Docker 安装在你的机器上。有关安装说明，请参阅 Docker 文档。
• Docker-compose。有关安装说明，请参阅 Docker Compose 文档。
• 用于构建 Docker 映像的 Linux 或 Mac 计算机。我不使用 Windows，对于 Windows，我建议使用 WSL2。
• Cronitor.io 帐户和 API 密钥（可选）。

特征

• 基于 Debian 的 VNC 服务器。
• 预装 IPTVBoss 应用程序。
• 仅当设置XC_SERVER=true变量时，XC Server 才会在启动时启动，否则它将无法启动。
• 以非 root 用户身份运行容器，并设置所需的PUID和PGID 。
• 使用默认密码预配置 VNC 服务器。用户可以通过覆盖环境变量来更改 VNC 设置，请参阅下文了解更多信息。
• 自动配置用于更新 EPG 的 cron 作业。
• 用于监控 cron 作业的 Cronitor.io 集成（可选）
• rclone 支持将 IPTVBoss 数据同步到云存储提供商。
• 对 Raspberry Pi 和其他 ARM 设备的 ARM 支持。使用ghcr.io/groenator/iptvboss-docker:latest :最新镜像。

任务清单

• 创建一个 Docker 映像，其中 IPTVBoss 作为简单的 cli 运行，无需 GUI 和 VNC。
• 配置 IPTVBoss XC 以在启动时启动。
• 将 docker 镜像推送到实际的 docker 注册表。
• 允许用户使用自己的计划配置 cron 作业。目前 cron 配置为每 12 小时运行一次。
• 启动定义您自己的用户的容器。
• 创建一个脚本来自动配置 cronitor 作业，而无需复制该作业（如果帐户中已有该作业）。

Docker Compose（首选方式）

笔记：

• 该卷安装到容器中的/headless/IPTVBoss目录。
• 如果安装的卷没有正确的权限，IPTVBoss 将无法启动。在安装卷之前，请确保本地文件夹的权限设置正确。
• 设置 cron 作业来执行定期 EPG 更新任务。通过使用您自己的计划设置CRON_SCHEDULE环境变量来更改 cron 计划。
• 要使用 XC 服务器，请公开端口 8001 并设置XC_SERVER=true变量。如果不需要，请删除端口和变量。通过浏览器访问 XC 服务器： http://<your-machine-ip>:8001 。

使用 Docker Compose 来管理 Docker 容器。提供了一个示例 docker-compose.yml 文件：

 services :
  iptvboss :
    image : ghcr.io/groenator/iptvboss-docker:latest # The Image has support for both ARM and x86 devices.
    environment :
      PUID : " 1000 " # Set the user ID for the container.
      PGID : " 1000 " # Set the group ID for the container.
      TZ : " US/Eastern " # Set the timezone for the container.
      CRON_SCHEDULE : " 0 0 * * * " # Set the cron schedule for the cron job that will update the EPG data.
      XC_SERVER : " true " # Set to true to start the XC server on boot. By default the XCSERVER is set to false.
    ports :
      - 8001:8001 # Used by XC Server
      - 5901:5901 # Used by the VNC Server to connect to the container using the VNC client.
      - 6901:6901 # Used by the VNC Server to connect to the container using a web browser.
    volumes :
    # Replace <local_volume> with the local directory where you want to store the IPTVBoss data. E.g., /home/user/iptvboss.
    # Based on the PUID and PGID environment variables the folder permissions are set at runtime.
    - <local_volume>:/headless/IPTVBoss

根据需要调整配置并运行：

docker-compose up -d

更改运行VNC容器的用户

用户可以定义自己的PUID和PGID来以非root用户身份运行容器。出于安全原因，这很有用。用户还可以设置主机系统的用户和组ID，以与主机系统的相同用户和组运行容器。

docker run -it -p 6911:6901 -p 8001:8001
-v < your-local-volume > :/headless/IPTVBoss
-e PUID=1000 -e PGID=1000
-e CRON_SCHEDULE= " * * * * * "
-e TZ=US/Eastern -e XC_SERVER=true
ghcr.io/groenator/iptvboss-docker:latest

或者，您还可以使用 docker-compose 文件中的 PUID 和 PGID 环境变量设置用户和组 ID，如上所示。

然后，运行以下命令：

docker-compose up -d

测试版现已推出！

请注意，这是测试版，可能包含错误。

IPTVBoss Docker 镜像的 Beta 版本可供测试。

强烈建议在使用测试版之前备份您的 IPTVBoss 数据。

要使用 beta 版本，请将 docker-compose 中的图像字段替换为带有<version>标记的iptvboss-docker-beta包：

services:
  iptvboss:
    image: ghcr.io/groenator/iptvboss-docker-beta: < version >  # Use the beta image with tag
    # ... (rest of your docker-compose configuration)

使用 docker cli 部署 beta 版本的示例：

docker run -it -p 5901:5901 -p 6901:6901 -p 8001:8001 
    --name iptvboss 
    -e PUID=1000 -e PGID=1000 
    # ... (other environment variables) 
    -v < your-local-volume > :/headless/IPTVBoss 
    ghcr.io/groenator/iptvboss-docker-beta: < version >  # Use the beta image with tag 

访问VNC服务器

通过打开以下 URL，使用您首选的 VNC 客户端或任何浏览器连接到 VNC 服务器。

要使用 VNC 客户端连接到 VNC 服务器，请使用以下地址：

vnc://your-machine-ip:5901

要使用 Web 浏览器连接到 VNC 服务器，请使用以下地址。

http://<host-ip>:6901/?password=vncpassword 。

如果将其部署在本地之外，请将 IP 替换为localhost 。

默认密码是vncpassword 。将 localhost 替换为您的实际服务器 IP 地址。

覆盖VNC环境变量

可以在 docker run 阶段覆盖以下 VNC 环境变量，以自定义容器内的桌面环境：

VNC_COL_DEPTH, default: 24
VNC_RESOLUTION, default: 1280x1024
VNC_PW, default: my-pw
VNC_PASSWORDLESS, default: < not set > 

Cronitor 集成（可选）

先决条件：

• 一个 Cronitor 帐户。在 Cronitor.io 上注册。
• Cronitor API 密钥。

要启用 Cronitor 监控，请将CRONITOR_API_KEY环境变量设置为您的 Cronitor API 密钥。将CRONITOR_SCHEDULE_NAME环境变量设置为 Cronitor 作业的自定义名称。

使用 docker-compose 运行它：

 services :
  iptvboss :
    image : ghcr.io/groenator/iptvboss-docker:latest # The Image has support for both ARM and x86 devices.
    environment :
      PUID : " 1000 " # Set the user ID for the container.
      PGID : " 1000 " # Set the group ID for the container.
      CRON_SCHEDULE : " 0 0 * * * " # Set the cron schedule for the cron job that will update the EPG data.
      CRONITOR_API_KEY : " <your_cronitor_api_key> "
      CRONITOR_SCHEDULE_NAME : " My Custom Schedule " # Set a name for your Cronitor.io Job
      XC_SERVER : " true " # Set to true to start the XC server on boot. By default the XCSERVER is set to false.
      TZ : " US/Eastern " # Set the timezone for the container.
    ports :
    - 8001:8001 # Used by XC Server
    - 5901:5901 # Used by the VNC Server to connect to the container using the VNC client.
    - 6901:6901 # Used by the VNC Server to connect to the container using a web browser.
    volumes :
    # Replace <local_volume> with the local directory where you want to store the IPTVBoss data. E.g., /home/user/iptvboss.
    # Based on the PUID and PGID environment variables the folder permissions are set at runtime.
    - <local_volume>:/headless/IPTVBoss

运行以下命令启动容器：

docker-compose up -d

或者使用以下命令：

 # Remove the double quotes around CRONITOR_API_KEY value and replace <your_cronitor_api_key> with your actual Cronitor API key.
docker run -it -p 5901:5901 -p 6901:6901 -p 8001:8001
--name iptvboss
-e PUID=1000 -e PGID=1000
-e CRONITOR_API_KEY= " <your_cronitor_api_key> "
-e CRONITOR_SCHEDULE_NAME=MyJob
-e CRON_SCHEDULE= " * * * * * "
-e XC_SERVER=true
-v < your-local-volume > :/headless/IPTVBoss
ghcr.io/groenator/iptvboss-docker:latest