takealug/easyepg

docker.easyepg

镜像概述和主要用途

docker.easyepg是一个用于运行easyepg的Docker容器，内置定时任务功能，可自动执行easyepg脚本以生成电子节目指南（EPG）XML文件。该镜像支持多架构（amd64、arm32v7、arm64v8），适用于需要定期获取和更新EPG数据的媒体中心环境。

核心功能和特性

• 多架构支持：提供amd64、arm32v7、arm64v8架构变体，需通过标签指定对应架构（如:amd64）
• 内置定时任务：通过cron配置定时执行easyepg脚本
• 灵活配置：支持自定义用户ID、组ID、时区、执行频率等参数
• 数据持久化：可通过卷挂载持久化easyepg数据及生成的XML文件
• 自动更新：可配置是否自动更新easyepg脚本

使用场景和适用范围

• 媒体中心系统（如TVheadend）需要定期更新EPG数据
• 需要在不同架构设备（如x86服务器、ARM开发板）上运行EPG生成服务
• 希望通过容器化方式简化easyepg部署和管理的场景

前提条件

• 系统已安装Docker
• 运行容器的用户需加入docker用户组

使用方法和配置说明

Docker运行示例

bash
docker run \
  -d \
  -e USER_ID="99" \
  -e GROUP_ID="100" \
  -e TIMEZONE="Europe/Berlin" \
  -e FREQUENCY="0 2 * * *" \
  -e UPDATE="yes" \
  -e REPO="sunsettrack4" \
  -e BRANCH="master" \
  -v {EASYEPG_STORAGE}:/easyepg \
  -v {XML_STORAGE}:/easyepg/xml \
  --name=easyepg \
  --restart unless-stopped \
  --tmpfs /tmp \
  --tmpfs /var/log \
  takealug/easyepg:tag

注意：需将{EASYEPG_STORAGE}和{XML_STORAGE}替换为实际绝对路径，并根据架构选择正确的标签（如:amd64、:arm32v7、:arm64v8）

参数说明

卷说明

注意：若不指定XML_STORAGE，生成的XML文件将保存在EASYEPG_STORAGE的xml子目录中。XML_STORAGE可直接挂载到其他容器（如TVheadend）的EPG目录，实现数据共享。

定时任务语法

 ┌───────────── 分钟 (0 - 59)
 │ ┌───────────── 小时 (0 - 23)
 │ │ ┌───────────── 日 (1 - 31)
 │ │ │ ┌───────────── 月 (1 - 12)
 │ │ │ │ ┌───────────── 星期 (0 - 6) (0=周日，6=周六；部分系统7也表示周日)
 │ │ │ │ │
 │ │ │ │ │
 * * * * *  /要执行的命令

首次运行/初始设置

容器启动后，需执行初始化命令配置easyepg：

bash
docker exec -ti easyepg /usr/local/bin/easyepg.process

注意：初始设置详细步骤请参考：[***]

完成初始设置后，请重启容器以避免权限问题。

重启后，easyepg将等待下一次定时任务执行并生成XML文件。

Unraid模板

注意：Unraid模板可从以下地址获取：https://raw.githubusercontent.com/DeBaschdi/docker.easyepg/master/Templates/Unraid/my-easyEPG.xml 请将模板保存到\flash\config\plugins\dockerMan\templates-user目录，然后在Unraid Web界面中使用：Docker > 添加容器 > 选择模板 > 选择easyEPG

!https://raw.githubusercontent.com/DeBaschdi/docker.easyepg/master/Templates/Unraid/Screenshot.png