# docker-moontv

**Repository Path**: nm97/moontv

## Basic Information

- **Project Name**: docker-moontv
- **Description**: moontv 影视聚合播放器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2025-09-08
- **Last Updated**: 2025-09-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

![](https://file.meimolihan.eu.org/screenshot/docker-moontv.webp)

## 📋 目录导航

- [🎯 项目简介](#project-intro)
- [✨ 核心特性](#features)
- [🐳 一、Docker 部署 MoonTV](#deploy)
  - [1. 创建部署目录和 `docker-compose.yml` 文件 📁](#deploy-setup)
  - [2. 拉取镜像并启动容器 🚀](#deploy-start)
- [🚀 二、使用 MoonTV](#usage)
  - [1. 访问 Web 界面 💻](#usage-access)
  - [2. 主要功能 🎯](#usage-features)
- [🌐 三、Nginx 反向代理配置](#nginx)
  - [1. 创建 Nginx 配置文件 🔧](#nginx-config)
  - [2. 测试并重载 Nginx 🔄](#nginx-reload)
- [🔧 四、容器维护命令](#maintenance)
  - [1. Docker Compose 命令 🐳](#docker-compose)
  - [2. Docker 容器命令 📦](#docker)
  - [3. Docker 镜像管理 📀](#docker-images)

<a id="project-intro"></a>
## 🎯 项目简介

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

**原项目仓库**: [https://github.com/sdlw7757/MoonTV](https://github.com/sdlw7757/MoonTV)

**默认访问地址**: `http://服务器IP:3133`

<a id="features"></a>
## ✨ 核心特性

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

<a id="deploy"></a>
## 🐳 一、Docker 部署 MoonTV

<a id="deploy-setup"></a>
### 1. 创建部署目录和 `docker-compose.yml` 文件 📁

```bash
mkdir -p /mnt/mydisk/home/moontv && cd $_

cat > docker-compose.yml <<'EOF'
version: '3.8'

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
```

```bash
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
```

<a id="deploy-start"></a>
### 2. 拉取镜像并启动容器 🚀

```bash
docker-compose up -d
```

<a id="usage"></a>
## 🚀 二、使用 MoonTV

<a id="usage-access"></a>
### 1. 访问 Web 界面 💻

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

<a id="usage-features"></a>
### 2. 主要功能 🎯

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

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

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

4. **设置选项** ⚙️
   - 播放器设置（默认清晰度、自动播放等）
   - 界面主题（明亮/暗黑/自动）
   - 数据管理（清除缓存、导出数据）

<a id="nginx"></a>
## 🌐 三、Nginx 反向代理配置

> **访问地址示例：<https://moontv.example.com>**

<a id="nginx-config"></a>
### 1. 创建 Nginx 配置文件 🔧

```bash
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
```

<a id="nginx-reload"></a>
### 2. 测试并重载 Nginx 🔄

```bash
sudo nginx -t && sudo systemctl reload nginx
```

<a id="maintenance"></a>
## 🔧 四、容器维护命令

<a id="docker-compose"></a>
### 1. Docker Compose 命令 🐳

```bash
# 进入项目目录
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
```

<a id="docker"></a>
### 2. Docker 容器命令 📦

```bash
# 查看所有容器名称
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        # 带时间戳的日志
```

<a id="docker-images"></a>
### 3. Docker 镜像管理 📀

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