instituteiptv/4gtv-v1 Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

GTV线上播放管理系统 (Streaming Management System)

本系统提供完整的线上影音播放与频道管理功能，支援 M3U 播放清单自动生成、EPG 节目指南设定、Token 验证、代理伺服器设定等功能，适合用于 IPTV 伺服管理及线上直播播放预览。

🤝 交流群

遇到问题？进群讨论：
👉 [***]

更新日志

bash
docker run -d --name=4gtv-v1 -p 50007:5050 --restart=always instituteiptv/4gtv-v1:latest

bash
docker run -d \
  --name 4gtv-v1 \
  -p 50007:5050 \
  --restart=always \
  instituteiptv/4gtv-v1:latest

📋 系统总览

主页面包含多项功能模组，方便管理帐户、更新播放清单及设定播放环境。

🔧 设定管理功能区

📺 频道播放介面

介面设计直觉，方便用户快速搜寻与播放。

功能说明：

• 🔍 频道搜寻：可输入关键字搜寻频道名称。
• ▶️ 即时播放：点击清单中的频道，即可于左侧播放器中直接播放。
• 📋 节目清单显示：右侧显示目前节目与后续节目资讯，支援 EPG 连动。
• ⚙️ 画质调整：支援手动切换画质、音量控制与全萤幕播放。
• 🔁 频道切换：可在超过 200 个频道中快速切换。

🐳 Docker 部署方式

可透过 Docker 快速启动服务容器：

1.0.0(含)以上版本

bash
docker run -d \
  --name 4gtv-v1 \
  -p 50007:5050 \
  -p 1080:1080 \
  -e ***_PORT=1080 \
  -e PROXY_HOST=0.0.0.0 \
  -v $(pwd)/config:/app/config \
  -e CONFIG_DIR=/app/config \
  --restart unless-stopped \
  instituteiptv/4gtv-v1:latest

或者

docker run -d \
  --name 4gtv-v1 \
  -p 5050:5050 \
  -p 1080:1080 \
  -e ***_PORT=1080 \
  -e PROXY_HOST=0.0.0.0 \
  -v ./config:/app/config \
  -e CONFIG_DIR=/app/config \
  --restart unless-stopped \
  instituteiptv/4gtv-v1:latest

或者单行命令执行

bash
docker run -d --name 4gtv-v1 -p 50007:5050 -p 1080:1080 -e ***_PORT=1080 -e PROXY_HOST=0.0.0.0 -v $(pwd)/config:/app/config -e CONFIG_DIR=/app/config --restart unless-stopped  instituteiptv/4gtv-v1:latest

或者

docker run -d --name 4gtv-v1 -p 5050:5050 -p 1080:1080 -e ***_PORT=1080 -e PROXY_HOST=0.0.0.0 -v ./config:/app/config -e CONFIG_DIR=/app/config --restart unless-stopped  instituteiptv/4gtv-v1:latest

一条命令更新方式

bash
docker pull instituteiptv/4gtv-v1:latest && \
docker stop 4gtv-v1 && \
docker rm 4gtv-v1 && \
docker run -d \
  --name 4gtv-v1 \
  -p 50007:5050 \
  -p 1080:1080
  -e ***_PORT=1080
  -e PROXY_HOST=0.0.0.0
  -v $(pwd)/config:/app/config \
  -e CONFIG_DIR=/app/config \
  --restart unless-stopped \
  instituteiptv/4gtv-v1:latest

# 🐳 环境变量配置说明

## 🔐 管理员与认证配置

| 环境变量 | 必填 | 预设值 | 说明 |
|---------|------|--------|------|
| `ADMIN_USER` | 否 | - | 管理员使用者名称 |
| `ADMIN_PASSWORD` | 否 | - | 管理员密码 |
| `GTV_USER` | 否 | - | GTV线上帐号，用于获取频道列表 |
| `GTV_PASSWORD` | 否 | - | GTV线上密码，用于获取频道列表 |
| `TOKENS` | 否 | - | 访问令牌（多个用逗号分隔），用于保护播放链接 |

## 🌐 网路与伺服器配置

| 环境变量 | 必填 | 预设值 | 说明 |
|---------|------|--------|------|
| `SERVER_BASE_URL` | 否 | - | 伺服器基础地址（内部访问地址） |
| `REVERSE_PROXY_BASE_URL` | 否 | - | 反向代理基础地址（外部访问地址） |
| `HOST` | 否 | `0.0.0.0` | 应用监听的主机地址 |
| `PORT` | 否 | `5050` | 应用监听的端口号 |
| `CONFIG_DIR` | 否 | `/app/config` | 配置档案储存目录 |

## 🔌 代理配置（HTTP/HTTPS/SOCKS）

| 环境变量 | 必填 | 预设值 | 说明 |
|---------|------|--------|------|
| `PROXY_MODE` | 否 | `none` | 代理模式：`none`、`http`、`***` |
| `HTTP_PROXY` / `http_proxy` | 否 | - | HTTP 代理伺服器地址 |
| `HTTPS_PROXY` / `https_proxy` | 否 | - | HTTPS 代理伺服器地址 |
| `SOCKS_PROXY` / `socks_proxy` | 否 | - | SOCKS5 代理伺服器地址 |
| `ALL_PROXY` / `all_proxy` | 否 | - | 全域代理伺服器地址 |

## 🚀 *** 代理配置

| 环境变量 | 必填 | 预设值 | 说明 |
|---------|------|--------|------|
| `***_PORT` | 否 | `1080` | *** 本地代理监听端口 |
| `***_VERSION` | 否 | `v26.2.2` | ***-core 版本号 |
| `PROXY_HOST` | 否 | `0.0.0.0` | 代理主机地址 |
| `PROXY_ENABLED` | 否 | `false` | 是否启用代理功能 |
| `TS_PROXY_ENABLED` | 否 | `false` | 是否启用 TS 流代理 |

## 📺 播放列表与串流配置

| 环境变量 | 必填 | 预设值 | 说明 |
|---------|------|--------|------|
| `PLAYLIST_TYPE` | 否 | `proxy` | 播放列表类型：`proxy`、`reverse`、`stream_reverse`、`stream_proxy` |
| `STREAM_SOURCE` | 否 | `1` | 串流来源选择：`0`=线路0，`1`=线路1 |
| `PLAYLIST_INCLUDE_URLS` | 否 | `true` | 播放列表是否包含完整 URL |
| `PROXY_ALL_STREAMS` | 否 | `false` | 是否代理所有串流媒体 |
| `STREAM_TIMEOUT` | 否 | `30` | 串流媒体超时时间（秒） |
| `PLAY_URL_CACHE_EXPIRATION` | 否 | `600` | 播放地址缓存时间（秒） |

## 📅 自动化配置

| 环境变量 | 必填 | 预设值 | 说明 |
|---------|------|--------|------|
| `AUTO_UPDATE_INTERVAL` | 否 | `0` | 自动更新播放列表间隔（小时，0=禁用） |
| `AUTO_GENERATE_PLAYLIST` | 否 | `true` | 容器启动时是否自动生成播放列表 |
| `EPG_SOURCE` | 否 | - | EPG（电子节目表）来源 URL |

## 📂 技术架构

| 模组 | 说明 |
|------|------|
| **后端 API** | 提供播放清单、EPG、Token 验证及帐户管理功能。 |
| **前端框架** | 採用 Vue / React + Bootstrap / Tailwind UI 组件实现。 |
| **播放器核心** | 使用 HLS.js / Video.js 提供流畅的串流播放体验。 |
| **资料格式** | 播放清单支援 `.m3u`、`.m3u8` 格式，EPG 支援 `.xml`。 |

---

## 🧩 使用步骤

1. 登入管理系统。
2. 前往「帐户设定」输入四季线上帐户与密码。
3. 根据需求设定代理伺服器与播放模式。
4. 选择「手动更新」生成最新 M3U 播放清单。
5. 点击「线上预览」即可即时观看频道节目。

---

## 📸 介面预览

### 🎛️ 设定管理画面
!设定管理画面

### 📺 频道播放画面
!频道播放画面

---

## 🧾 系统特色

- 支援自动更新播放清单。
- EPG 节目指南整合。
- Token 验证提升安全性。
- 多协定播放支援 (HTTP / HTTPS / HLS)。
- 即时线上预览与画质控制。
- 适用于家庭伺服器与 IPTV 应用场景。

---