instituteiptv/4gtv-v1
instituteiptv
17 次收藏下载次数: 0状态：社区镜像维护者：instituteiptv仓库类型：镜像最近更新：17 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
VTG4-线上播放管理系统 (Streaming Management System)
https://img.shields.io/docker/pulls/instituteiptv/ofiii-move](https://hub.docker.com/r/instituteiptv/4gtv-v1) https://img.shields.io/docker/image-size/instituteiptv/4gtv-v1/latest](https://hub.docker.com/r/instituteiptv/4gtv-v1) https://img.shields.io/badge/license-MIT-blue.svg](LICENSE) https://img.shields.io/badge/platform-amd64%20%7C%20arm64%20%7C%20armv7-brightgreen](https://hub.docker.com/r/instituteiptv/4gtv-v1) https://img.shields.io/badge/***-%E4%BA%A4%E6%B5%81%E7%BE%A4-blue?logo=]([]
本系统提供完整的线上影音播放与频道管理功能，支援 M3U 播放清单自动生成、EPG 节目指南设定、Token 验证、代理伺服器设定等功能，适合用于 IPTV 伺服管理及线上直播播放预览。
🤝 交流群
遇到问题？进群讨论：
👉 [***]
更新日志
2.2.6
- 优化线路切换逻辑。
- 调整多码率处理逻辑。
- 修復一般切片频道强制最高码率失败问题。
- 优化整体代码。
- 优化缓存占高。
2.2.2
- 优化API与线路切换逻辑。
2.2.1
- 移除TV端与APP端header_key单独获取。
- Fix bug
2.2.0
- 新增自动切换线路与模式开关。
- 优化TV端与APP端播放地址获取方式。
- 独立TV端与APP端header_key获取。
2.1.9
- 新增线路、API自动回退切换机制。
- 调整播放地址获取逻辑握手方式。
- 移除cloudscraper依赖。
- header_key改为动态获取。
2.1.8
- 新增TV端与APP端API切换开关。
2.1.7
- 转换部分频道採用TV端API提高码率。
2.1.6
- 优化网页端播放器EPG调取逻辑。
- 加入EPG自动更新。
2.1.5
- 加入自动提取最高解析度，开启后，服务端会自动从多码率清单（master m3u8）中抓取最高画质子流， 将最终可直接播放的媒体清单返回给客户端。可解决 PotPlayer / VLC 无法正确跟随跳转的问题。
- 加入隐藏频道处理逻辑。
2.1.4
- 修改免费帐号部分频道处里逻辑
2.1.1
- fix media-livexxx Channels
2.0.9
- 修正完整流媒体代理未开启时，使用参数&type=stream_proxy或&type=stream_reverse能强制完整流媒体代理问题。
2.0.5
- 修復重启时未自动生成播放清单。
- media-livexxx 提升码率至 1080p。
2.0.4
加入支持以下环境变量:
GTV_USER: GTV线上账户用户名
GTV_PASSWORD: GTV线上账户密码
TOKENS: 以逗号分隔的 token 清单
AUTO_UPDATE_INTERVAL: 自动更新间隔（小时）
PLAYLIST_INCLUDE_URLS: 是否在播放清单中包含地址（true/false）
EPG_SOURCE: EPG 数据来源
STREAM_SOURCE: 线路来源（0 or 1）
PLAY_URL_CACHE_EXPIRATION: 播放地址缓存时间（秒）
AUTO_GENERATE_PLAYLIST: 是否在启动时自动生成播放清单（预设为 true）
2.0.3
- 修復bug。
- 加入SOCKS4、SOCKS5代理支持。
2.0.2
- 修復自动更新。
2.0.1
- 修復***无法变更版本问题。
- 增加播放地址缓存自由设定。
- 调整切片大小。
- 调整同步与异步处理逻辑。
2.0.0
- 升级python:3.12-alpine。
- 升级架构为Fastapi，能够有效的解决同步併发造成的内存占用。
- 修正一般设置标籤页不固定问题。
- 修正一般代理失效问题。
1.0.0
- 加入支援vmess、vless、***代理。
- 修正启用完整流媒体代理时，查看播放清单未自动更新成type=stream问题。
0.1.0
- 修復小bug。
- 美化播放器频道分组。
0.0.9
- 取消併发改採异步处理，有效降低内存占用过大。
- 预设模式为无直连模式清单，如需要可于自动更新设置内开启。
- 建议使用者删除重装。
- 敏感资料採用 AES 加密。
0.0.8
优化 CROSS 功能 提升多端协作体验及安全性。
合併部分路由介面，简化设定流程 路由设定更加集中，操作更便捷。
新增播放清单自动建立功能 每次 Docker 重启或镜像自动更新时，会于启动时自动建立播放清单（需确保原资料设置无误）。
0.0.7
-
修復线上播放器相同频道名称滚动问题
解决多个频道名称相同时，滚动显示异常，提升使用体验。 -
添加 CROSS 支援
新增 CROSS 功能，增强多端协作与安全性。 -
修復更换播放类型时服务器地址与反向代理地址自动清空问题
现在切换播放类型时，不再自动清空服务器及反向代理地址，使用配置更稳定。 -
加入随机装置 ID（缓存 10~15 分钟）降低登入异常与被反制风险
每次装置登入时产生随机装置 ID，并在 10~15 分钟内缓存，有效降低登入异常及平台风险。 -
已加入 config 持久化
配置档案（config）已支持持久化存储，避免数据丢失。
0.0.6 以下使用命令
bashdocker run -d --name=4gtv-v1 -p 50007:5050 --restart=always instituteiptv/4gtv-v1:latest
或者多行命令
bashdocker run -d \ --name 4gtv-v1 \ -p 50007:5050 \ --restart=always \ 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、xray |
HTTP_PROXY / http_proxy | 否 | - | HTTP 代理伺服器地址 |
HTTPS_PROXY / https_proxy | 否 | - | HTTPS 代理伺服器地址 |
SOCKS_PROXY / socks_proxy | 否 | - | SOCKS5 代理伺服器地址 |
ALL_PROXY / all_proxy | 否 | - | 全域代理伺服器地址 |
🚀 *** 代理配置
| 环境变量 | 必填 | 预设值 | 说明 |
|---|---|---|---|
XRAY_PORT | 否 | 1080 | *** 本地代理监听端口 |
XRAY_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 | 播放地址缓存时间（秒） |
USE_TV_API | 否 | false | 开启/关闭 TV API |
AUTO_SWITCH | 否 | false | 自动切换线路与API |
📅 自动化配置
| 环境变量 | 必填 | 预设值 | 说明 |
|---|---|---|---|
AUTO_UPDATE_INTERVAL | 否 | 0 | 自动更新播放列表间隔（小时，0=禁用） |
AUTO_GENERATE_PLAYLIST | 否 | true | 容器启动时是否自动生成播放列表 |
EPG_SOURCE | 否 | - | EPG（电子节目表）来源 URL |
EPG_UPDATE_INTERVAL | 否 | 0 | EPG（电子节目表）自动更新间隔（小时，0=禁用） |
📊 配置示例
基本配置示例：
bash# 管理员配置 ADMIN_USER=admin ADMIN_PASSWORD=secure_password # GTV线上帐号 GTV_USER=your_4gtv_account GTV_PASSWORD=your_4gtv_password # 伺服器配置 SERVER_BASE_URL=http://localhost:5050 REVERSE_PROXY_BASE_URL=[***] # 生成访问令牌 TOKENS=your_secret_token_here # 基本启动范例 docker run -d \ --name 4gtv-v1 \ -p 5050:5050 \ -e ADMIN_USER=admin \ -e ADMIN_PASSWORD=admin123 \ -e GTV_USER=your_account \ -e GTV_PASSWORD=your_password \ --restart unless-stopped \ instituteiptv/4gtv-v1 # 带代理启动范例 docker run -d \ --name 4gtv-v1 \ -p 5050:5050 \ -p 1080:1080 \ -e PROXY_HOST=0.0.0.0 \ -e PROXY_MODE=*** \ -e ***_PORT=1080 \ -e GTV_USER=your_account \ -e GTV_PASSWORD=your_password \ --restart unless-stopped \ instituteiptv/4gtv-v1 # 长久化选项 -v $(pwd)/config:/app/config -e CONFIG_DIR=/app/config 或 -v ./config:/app/config -e CONFIG_DIR=/app/config
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 4gtv-v1 镜像标签
docker pull docker.xuanyuan.run/instituteiptv/4gtv-v1:<标签>
DockerHub 原生拉取命令
docker pull instituteiptv/4gtv-v1:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"