alturismo/guide2go

guide2go Docker镜像

镜像概述

guide2go Docker镜像是一个集成了cron定时任务的容器化解决方案，基于guide2go工具（Schedules Direct的XMLTV EPG抓取器）构建。该镜像提供持久化配置，支持与TVHeadend、Plex及Emby等媒体服务集成，实现自动化EPG数据更新。

核心功能与特性

• EPG数据抓取：基于guide2go工具，从Schedules Direct获取XMLTV格式电子节目指南数据
• 定时任务支持：集成cron服务，容器重启时自动更新定时任务配置
• 配置持久化：所有配置文件存储在持久化卷中，删除卷可重置配置
• 多服务集成：支持TVHeadend数据同步、Plex/Emby直接EPG更新触发
• 功能可配置：所有集成功能可单独开启或关闭

使用场景与适用范围

适用于需要定期获取和更新电子节目指南（EPG）数据的媒体服务器环境，特别适合：

• 使用TVHeadend作为IPTV服务器的用户
• 运行Plex或Emby媒体中心并需要实时EPG数据的用户
• 需要自动化EPG更新流程的家庭媒体中心场景

使用方法与配置说明

挂载路径说明

注意：宿主机路径需根据实际系统环境调整

Docker运行命令

bash
docker run -d \
  --name=guide2go \
  --net=bridge \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  -e TZ="Europe/Berlin" \
  -v /mnt/user/appdata/guide2go/_config:/config:rw \
  -v /mnt/user/appdata/guide2go/:/guide2go:rw \
  alturismo/guide2go

配置步骤

1. 初始化配置：容器启动后，检查挂载的/config和/guide2go目录，配置文件将持久化存储

2. 设置Schedules Direct订阅：

   bash
   docker exec -it guide2go guide2go -configure /guide2go/your_epg_name.yaml
   

   或直接将现有.json配置文件复制到/guide2go目录

3. 测试cron任务功能：

   bash
   docker exec -it guide2go ./config/cronjob.sh
   

环境变量说明

• TZ：设置容器时区（如"Europe/Berlin"、"Asia/Shanghai"），影响cron任务时间计算

相关资源

• guide2go项目：https://github.com/mar-mei/guide2go
• Schedules Direct官网：[***]