Docker 部署 IPTV-Sources 直播源收集服务 📺

📋 目录导航

🎯 项目简介

IPTV-Sources 是一款自动化的直播源收集和管理服务，能够从多个来源聚合、验证和整理直播源。它提供简单易用的 Web 界面，支持自动更新和定时任务，帮助用户获取高质量、稳定的直播源。🌐

✨ 核心特性

特性类别 功能描述 优势
🔄 自动收集 从多个来源自动获取直播源 无需手动收集，节省时间
✅ 源验证 自动检测和验证直播源有效性 确保直播源质量，减少无效链接
📊 分类管理 按类型和地区对直播源进行分类 方便查找和管理
⏰ 定时更新 支持定时自动更新直播源 保持直播源新鲜度
🐳 容器化部署 Docker 一键部署，简单易用 快速部署，易于维护
🌐 Web 界面 提供友好的 Web 管理界面 直观易用，无需命令行操作

🐳 一、Docker 部署 IPTV-Sources

1. 创建部署目录和 docker-compose.yml 文件 📁

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
mkdir -p /mnt/mydisk/home/iptv-sources && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  iptv-sources:
    image: herberthe0229/iptv-sources:latest
    container_name: iptv-sources
    ports:
      - "4000:8080"  # 🌐 主机端口:容器端口
    volumes:
      - ./data:/app/data  # 💾 数据持久化目录
    environment:
      - TZ=Asia/Shanghai  # ⏰ 时区设置
    restart: unless-stopped  # 🔄 自动重启
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080"]
      interval: 30s
      timeout: 10s
      retries: 3
EOF

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

1
docker-compose up -d

🚀 二、使用 IPTV-Sources

1. 访问 Web 界面 💻

  • 本地访问: http://localhost:4000
  • 域名访问: https://iptv-sources.example.com（配置反向代理后）

2. 主要功能 🎯

功能 操作方式 说明
📡 直播源管理 Web 界面操作 查看、筛选和管理直播源
✅ 源验证 自动检测 标记无效源，确保质量
🔄 自动更新 定时任务/手动触发 保持直播源新鲜度
⚙️ 配置管理 界面设置 自定义更新频率和筛选规则

3. 导出直播源 💾

  1. M3U 格式导出

    • 适用于大多数播放器
    • 包含频道信息和分组

  2. TXT 格式导出

    • 简单列表格式
    • 适用于特定应用

  3. API 访问

    • 通过 REST API 获取直播源
    • 支持筛选和分页

🌐 三、Nginx 反向代理配置

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

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
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/iptv-sources.conf <<'EOF'
server {
    listen 443 ssl;
    listen [::]:443 ssl;

    server_name iptv-sources.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:4000;
        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_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
# 进入项目目录
cd /mnt/mydisk/home/iptv-sources

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

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

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

# 完整升级流程
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
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器
docker stop iptv-sources      # 停止容器
docker start iptv-sources     # 启动容器  
docker restart iptv-sources   # 重启容器

# 删除容器
docker rm iptv-sources        # 删除已停止容器
docker rm -f iptv-sources     # 强制删除运行中容器

# 进入容器Shell
docker exec -it iptv-sources sh      # 使用sh进入容器

# 查看容器详情和资源使用
docker inspect iptv-sources     # 查看详细配置
docker stats iptv-sources       # 实时资源监控

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

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

3. Docker 镜像管理 📀

1
2
3
4
docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

🌟 启航直播源管理，探索无限视界

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

📺 随时随地 获取高质量直播源，自动从多个来源聚合、验证和整理，确保稳定可靠的观看体验
🔄 完全自主 掌控直播源质量，自动过滤无效链接，定时更新保持源的新鲜度和可用性
🔐 隐私安全 所有数据处理在本地完成，无需依赖第三方服务，保障个人观看偏好和隐私
⚡ 高效便捷 简单易用的 Web 界面，无需复杂操作即可管理大量直播源，提升使用效率

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

从现在开始，整理收藏，发现精彩——构建你专属的高清直播源库吧！🚀

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

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