xTag

Overview

Full name
docker.io/guovern/tv-driver
Registry
docker.io
Namespace
guovern
Repository
tv-driver
Cached tags
1
Last synced
07/06/2026, 11:35 AM

Introduction

guovern tv-driver 电视端驱动/代理服务镜像，对接 IPTV 或直播源协议，适合 homelab 机顶盒网关私有化部署。

Details

guovern/tv-driver 运行电视端协议适配与频道列表代理，将远端直播源转为本地播放器可识别的格式。典型用于家庭 NAS 统一维护 IPTV 订阅，与 xteve 类似但更聚焦特定驱动栈。定位为常驻网络代理服务，需稳定 outbound 与配置文件 volume；可 K8s 部署但单副本即可，注意直播流带宽与 UDP 端口映射。

快速启动

docker run -d --name tv-driver \
  -p 34400:34400 \
  -v $(pwd)/config:/config \
  docker.io/guovern/tv-driver:latest

推荐实践

docker run -d --name tv-driver \
  --restart unless-stopped \
  -p 34400:34400 \
  -v /opt/tv-driver/config:/config \
  -e TZ=Asia/Shanghai \
  docker.io/guovern/tv-driver:1.0.0

核心参数说明

  • -p 34400:34400 — 驱动服务 HTTP/API 端口
  • -v .../config:... — 频道与账号配置持久化
  • --restart unless-stopped — 直播代理持续在线
  • -e TZ=Asia/Shanghai — EPG 与日志时区
  • 固定 tag — 协议与驱动版本 pin

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: tv-driver
spec:
  replicas: 1
  selector:
    matchLabels:
      app: tv-driver
  template:
    metadata:
      labels:
        app: tv-driver
    spec:
      containers:
        - name: tv-driver
          image: docker.io/guovern/tv-driver:1.0.0
          ports:
            - containerPort: 34400
          volumeMounts:
            - name: config
              mountPath: /config
      volumes:
        - name: config
          persistentVolumeClaim:
            claimName: tv-driver-config
---
apiVersion: v1
kind: Service
metadata:
  name: tv-driver
spec:
  selector:
    app: tv-driver
  ports:
    - port: 34400
      targetPort: 34400

单副本即可；UDP/组播场景可能需 hostNetwork，按运营商网络策略调整。

Latest tags (20)

View all 1 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/guovern/tv-driver
:latest
linux/amd64linux/arm64
2024/11/15 17:44489.6 MBsha256:f05fb90bcbb8…