Docker 部署 MoonTV 影视聚合播放器 🎬

📋 目录导航

🎯 项目简介

MoonTV 是一款开箱即用的跨平台影视聚合播放器，基于现代 Web 技术栈构建，提供丰富的影视内容和优质的用户体验。它支持多资源搜索、在线播放、收藏同步和播放记录等功能，让您可以随时随地畅享海量免费影视内容。🌟

✨ 核心特性

特性类别 功能描述 优势
🎥 多源聚合 整合多个影视资源，一站式搜索和播放 无需切换多个应用，统一管理所有资源
🌐 跨平台支持 支持 Web、移动端等多种设备 随时随地享受影视内容，无缝切换设备
💾 数据同步 支持收藏列表和播放记录同步 多设备间保持观看进度和收藏一致性
🎨 现代界面 基于 Next.js 14 + Tailwind CSS 的现代化界面 美观易用，操作流畅，提升用户体验
🔍 智能搜索 多资源并行搜索，快速找到想看的内容 高效检索，节省寻找资源的时间
📱 响应式设计 完美适配各种屏幕尺寸 在手机、平板、电脑上都能获得良好体验
🛡️ 广告拦截 内置广告拦截功能，提升观看体验 减少干扰，专注观影内容
🌙 夜间模式 支持暗色主题，保护眼睛减少疲劳 长时间观看更舒适，保护视力
🔄 实时更新 资源库定期更新，持续提供最新内容 始终能够获取最新的影视资源

🐳 一、Docker 部署 MoonTV

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/moontv && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  moontv:
    image: ghcr.io/senshinya/moontv:latest
    container_name: moontv
    restart: unless-stopped
    ports:
      - "3133:3000"  # 🌐 主机端口:容器端口
    volumes:
      - ./config.json:/app/config.json:ro  # ⚙️ 配置文件(只读)
      - ./data:/app/data  # 💾 数据持久化目录
    environment:
      - TZ=Asia/Shanghai  # ⏰ 时区设置
      - NEXT_PUBLIC_STORAGE_TYPE=localstorage  # 💾 存储类型
      - NEXT_PUBLIC_ENABLE_BLOCKAD=true  # 🛡️ 启用广告拦截
      - NEXT_PUBLIC_SEARCH_MAX_PAGE=5  # 🔍 搜索最大页数
      - NEXT_PUBLIC_AGGREGATE_SEARCH_RESULT=true  # 📊 聚合搜索结果
EOF
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
cat > config.json <<'EOF'
{
  "siteName": "MoonTV",
  "description": "开源影视聚合播放器",
  "keywords": "电影,电视剧,动漫,综艺,免费观看",
  "defaultSearchSource": "all",
  "sources": [
    {
      "name": "源1",
      "url": "https://example.com/api/v1",
      "enabled": true
    },
    {
      "name": "源2", 
      "url": "https://example.com/api/v2",
      "enabled": true
    }
  ],
  "player": {
    "defaultQuality": "高清",
    "autoPlayNext": true,
    "rememberPosition": true
  },
  "ui": {
    "theme": "auto",
    "language": "zh-CN"
  }
}
EOF

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

1
docker-compose up -d

🚀 二、使用 MoonTV

1. 访问 Web 界面 💻

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

2. 主要功能 🎯

  1. 影视搜索 🔍

    • 多源并行搜索，快速获取结果
    • 智能结果聚合，去除重复内容
    • 分类筛选功能，按类型、年份、地区筛选

  2. 在线播放 ▶️

    • 支持多种视频格式和流媒体协议
    • 多清晰度选择（标清、高清、超清）
    • 完整的播放控制（暂停、快进、音量、字幕等）

  3. 个人中心 👤

    • 收藏管理，创建个人片单
    • 播放历史，记录观看轨迹
    • 观看进度同步，多设备无缝切换

  4. 设置选项 ⚙️

    • 播放器设置（默认清晰度、自动播放等）
    • 界面主题（明亮/暗黑/自动）
    • 数据管理（清除缓存、导出数据）

🌐 三、Nginx 反向代理配置

访问地址示例：https://moontv.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
56
57
58
59
60
61
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/moontv.conf <<'EOF'
server {
    listen 443 ssl;
    listen [::]:443 ssl;

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

    # SSL 证书配置
    ssl_certificate /etc/nginx/ssl/cert.pem;
    ssl_certificate_key /etc/nginx/ssl/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:3133;
        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;
        
        # WebSocket 支持
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        
        # 超时设置
        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/moontv

# 停止并删除容器
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
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器
docker stop moontv      # 停止容器
docker start moontv     # 启动容器  
docker restart moontv   # 重启容器

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

# 进入容器Shell
docker exec -it moontv sh      # 使用sh进入容器
docker exec -it moontv bash    # 使用bash进入容器

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

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

3. Docker 镜像管理 📀

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

🌟 启航影视，畅享无限

通过本文档，你已经成功使用 Docker 部署了 MoonTV 影视聚合播放器，并借助 Nginx 反向代理实现了安全便捷的远程访问。现在，你可以：

🎬 海量资源 畅享多源聚合的影视内容，涵盖电影、电视剧、动漫等多种类型
🌐 跨屏体验 多设备无缝切换，随时随地享受优质的观影体验
📊 智能管理 个人收藏和观看记录同步，打造专属的影视库

影视之路，是一场与精彩内容相伴的休闲时光。愿 MoonTV 成为你贴心的观影伙伴，陪伴你在每一个放松和娱乐的美好时刻。

从现在开始，随心观看，畅享影视——构建你专属的私人影院吧！🎉

📌 持续迭代：建议关注 MoonTV 官方更新，及时获取新功能与优化。
🐛 反馈与互助：使用中如有疑问或建议，可前往 GitHub Issues 提出。

祝你观影愉快，享受每一刻！🎬