Docker 部署 IPTV-API 直播源服务 📺

📋 目录导航

🎯 项目简介
🛠️ 核心特性
🐳 一、Docker 部署 IPTV-API
🚀 二、IPTV-API 使用教程
🌐 三、Nginx 反向代理配置
- 1. 创建 Nginx 配置文件 🔧
- 2. 测试并重载 Nginx 🔄
🔧 四、容器维护命令
🌟 启航直播视界，探索无限精彩

🎯 项目简介

🐱 GitHub 项目地址： https://github.com/Guovin/iptv-api
🐋 Docker 镜像地址： https://hub.docker.com/r/guovern/iptv-api

IPTV-API 是一款强大的直播源处理服务，提供直播源的聚合、验证、过滤和转换功能。它支持多种直播源格式，能够自动检测和修复无效链接，为用户提供稳定可靠的直播源服务。🌐

🛠️ 核心特性

特性类别	功能描述	优势
📡 多源聚合	支持从多个来源聚合直播源	丰富的频道来源，避免单一源失效
⚡ 实时验证	自动检测和验证直播源有效性	确保直播源可用性，提升观看体验
🔄 格式转换	支持 M3U、TXT 等多种输出格式	兼容各种播放器和应用
🎯 智能过滤	根据规则过滤不需要的频道	定制个性化频道列表
📊 性能监控	提供详细的测速和性能日志	实时了解服务状态和性能
🐳 容器化部署	Docker 一键部署，简单易用	快速部署，易于维护

🐳 一、Docker 部署 IPTV-API

1. 创建部署目录和配置文件 📁

1
2


mkdir -p /mnt/mydisk/home/iptv-api && \
cd /mnt/mydisk/home/iptv-api

2. 选择版本部署 🔄

版本选择指南

版本类型	特点	适用场景	推荐配置
完整版本	性能要求较高，更新速度较慢，稳定性、成功率高	酒店源、组播源、关键字搜索	修改 `open_driver = False` 可切换到 Lite 模式
精简版本	轻量级，性能要求低，更新速度快，稳定性不确定	订阅源使用	适合资源有限的运行环境

选项 A: 完整版本部署

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


cat > docker-compose.yml <<'EOF'
services:
  iptv-api:
    image: guovern/iptv-api:latest
    container_name: iptv-api
    ports:
      - "8755:8000"  # 🌐 服务端口映射
    volumes:
      - ./config:/iptv-api/config  # ⚙️ 配置文件目录
      - ./output:/iptv-api/output  # 💾 输出文件目录
    environment:
      - TZ=Asia/Shanghai  # ⏰ 时区设置
    restart: unless-stopped  # 🔄 自动重启
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000/m3u"]
      interval: 30s
      timeout: 10s
      retries: 3
EOF

选项 B: 精简版本部署

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


cat > docker-compose.yml <<'EOF'
services:
  iptv-api:
    image: guovern/iptv-api:lite
    container_name: iptv-api
    ports:
      - "8755:8000"  # 🌐 服务端口映射
    volumes:
      - ./config:/iptv-api/config  # ⚙️ 配置文件目录
      - ./output:/iptv-api/output  # 💾 输出文件目录
    environment:
      - TZ=Asia/Shanghai  # ⏰ 时区设置
    restart: unless-stopped  # 🔄 自动重启
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000/m3u"]
      interval: 30s
      timeout: 10s
      retries: 3
EOF

3. 拉取镜像并启动容器 🚀

1

docker-compose up -d

🚀 二、IPTV-API 使用教程

1. 接口说明 🌐

部署完成后，可以通过以下接口访问服务:

接口类型	访问地址	功能描述
🌐 基础地址	`http://服务器IP:8755`	服务根目录
📺 M3U 接口	`http://服务器IP:8755/m3u`	获取 M3U 格式直播源
📄 TXT 接口	`http://服务器IP:8755/txt`	获取 TXT 格式直播源（避免重复频道）
🔍 内容接口	`http://服务器IP:8755/content`	查看处理后的内容
📊 测速日志	`http://服务器IP:8755/log`	查看性能监控日志

2. 客户端配置 📱

影视仓配置:

使用 TXT 接口避免重复频道
配置地址: http://服务器IP:8755/txt

其他播放器配置:

播放器类型	推荐接口	配置说明
VLC	M3U 接口	支持标准 M3U 格式
Kodi	M3U 接口	兼容各种 IPTV 插件
Tivimate	M3U 接口	专业 IPTV 播放器
Perfect Player	M3U 接口	轻量级播放器

3. 配置参数调整 ⚙️

详细配置参数参考: https://github.com/Guovin/iptv-api/blob/master/docs/config.md

配置项	默认值	说明	建议
open_driver	True	开启完整功能模式	设为 False 可切换精简模式
update_interval	3600	源更新间隔(秒)	根据需求调整更新频率
filter_rules	[]	过滤规则列表	自定义频道过滤条件
priority_sources	[]	优先级源列表	设置重要源的优先级

🌐 三、Nginx 反向代理配置

访问地址示例： https://iptv-api.example.com:666

1. 创建 Nginx 配置文件 🔧

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57


mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/iptv-api.conf <<'EOF'
server {
    listen 666 ssl;
    listen [::]:666 ssl;

    server_name iptv-api.example.com;  # 🌐 请替换为您的实际域名

    # SSL 证书配置
    ssl_certificate /etc/nginx/keyfile/cert.pem;
    ssl_certificate_key /etc/nginx/keyfile/key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384;

    # 安全头部
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Content-Type-Options nosniff always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-XSS-Protection "1; mode=block";

    # 性能优化
    sendfile on;
    tcp_nopush on;
    
    # 文件大小限制
    client_max_body_size 100M;

    location / {
        proxy_pass http://localhost:8755;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Range $http_range;
        proxy_set_header If-Range $http_if_range;
        
        # 超时设置
        proxy_connect_timeout 300s;
        proxy_send_timeout 300s;
        proxy_read_timeout 300s;
        
        # 缓冲设置
        proxy_buffering on;
        proxy_buffer_size 4k;
        proxy_buffers 8 16k;
        proxy_busy_buffers_size 24k;
        proxy_max_temp_file_size 0;
    }

    # 错误页面处理
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}
EOF

2. 测试并重载 Nginx 🔄

1

sudo nginx -t && sudo systemctl reload nginx

🔧 四、容器维护命令

1. Docker Compose 命令 🐳

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


# 进入项目目录（请替换为您的实际目录）
cd /path/to/your/project

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 仅启动指定服务（请替换 <service_name> 为实际服务名）
docker-compose up -d <service_name>

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 查看指定服务日志（请替换 <service_name> 为实际服务名）
docker-compose logs <service_name>

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37


# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器（请替换 <container_name> 为实际容器名）
docker stop <container_name>      # 停止容器
docker start <container_name>     # 启动容器  
docker restart <container_name>   # 重启容器

# 删除容器
docker rm <container_name>        # 删除已停止容器
docker rm -f <container_name>     # 强制删除运行中容器

# 进入容器Shell
docker exec -it <container_name> sh      # 使用sh进入容器
docker exec -it <container_name> bash    # 使用bash进入容器

# 以root身份进入容器  
docker exec -u 0 -it <container_name> sh

# 在容器中执行命令
docker exec <container_name> ls -la

# 查看容器详情和资源使用
docker inspect <container_name>     # 查看详细配置
docker stats <container_name>       # 实时资源监控

## 容器日志管理
docker logs <container_name>           # 查看日志
docker logs -f <container_name>        # 实时跟踪日志
docker logs --tail 100 <container_name>  # 查看最后100行
docker logs -t <container_name>        # 带时间戳的日志

# 健康检查
docker inspect --format='{{.State.Health.Status}}' iptv-api

3. Docker 镜像管理 📀

1
2
3
4


docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像（请替换为实际镜像名和标签）
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

🌟 启航直播视界，探索无限精彩

通过本文档，你已经成功使用 Docker 部署了 IPTV-API 直播源服务，并借助 Nginx 反向代理实现了安全便捷的远程访问。现在，你可以：

📺 随时随地 享受稳定流畅的直播体验，打破地域和设备限制，畅享全球电视频道
🌐 完全自主 掌控直播源质量，自动过滤无效链接，确保观看体验始终如一
🔐 隐私安全 所有数据本地处理，无需依赖第三方服务，保障个人观看偏好隐私
⚡ 高效稳定 多源聚合与智能验证，提供可靠的高清直播源服务

影音无界，直播随行。愿 IPTV-API 成为你家庭娱乐的得力助手，打破频道限制，开启视听新体验。

从现在开始，连接世界，掌控视界——构建你专属的高清直播平台吧！🚀

📌 持续关注：建议留意 IPTV-API 项目更新，获取最新功能与优化。
🐛 反馈与支持：使用中遇到问题或有建议，可前往 GitHub Issues 提出。

祝你观看愉快，精彩不断！🎉