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