手把手教程：在NAS上部署E视界（DongguaTV），打造专属私人影院

April 4, 2026

本文将介绍如何将您的网络附加存储设备（NAS）转变为一个功能强大的个人流媒体中心。通过部署 E 视界（可视为冬瓜 TV 的增强与重构版本），您可以获得媲美主流平台的观影体验。E 视界是一款基于现代 Node.js 与 Vue 3 技术栈构建的流媒体聚合播放器，其设计理念强调智能化与沉浸感。

该软件的核心优势在于其双引擎架构与高度智能化的资源管理。一方面，它深度整合 TMDb（The Movie Database），为影视内容提供高质量的海报、背景图、评分、剧情简介及演职员表等元数据，界面风格向 Netflix 看齐。另一方面，它集成了超过 48 个第三方资源站点的 API（基于 Maccms），并具备自动测速与失效源过滤机制，确保播放线路的可用性与流畅度。

在搜索体验上，E 视界采用了实时流式搜索技术，搜索结果会即时呈现，无需等待所有源站返回。系统能自动将同一影片的不同播放线路进行分组与合并，并在卡片上动态显示可用源的数量。所有搜索记录与元数据均通过内置的高性能 SQLite 数据库进行缓存，实现秒级响应。

播放功能也经过精心设计。全新的影院模式播放页采用暗色系布局，支持剧集网格化选择。播放前会进行线路测速，并在播放失败时自动切换至下一个可用源，无需人工干预。软件还支持 DLNA/AirPlay 投屏功能。

针对中国大陆用户可能遇到的网络问题，E 视界进行了专门优化。它采用双重 IP 检测机制来准确判断用户地域，并自动切换至 TMDB 反代模式以保障元数据正常加载。所有核心前端依赖库均已本地化部署，彻底避免了因公共 CDN 访问不畅导致的加载缓慢问题。项目提供一键式安装脚本，简化配置流程。

在设备兼容性方面，E 视界表现全面。它提供专为 Android TV 或电视盒子优化的 APK 安装包，完美适配遥控器操作。移动端应用封装精良，支持沉浸式状态栏，提供接近原生应用的流畅体验。同时，它也支持 PWA，可添加到设备主屏幕快速启动。

安全管理功能包括可选的全局访问密码，支持长达一年的记住登录状态，兼顾安全与便利。此外，还支持从远程 URL 加载配置文件，便于多实例的统一管理。

请注意，本教程内容仅限用于技术学习与交流目的。在使用相关软件与服务时，请您务必严格遵守所在地的法律法规及各平台的使用协议，切勿将其用于任何商业用途或非法领域。

前期准备工作

在开始部署之前，您需要完成两项关键配置：准备采集源配置文件 db.json 以及获取 TMDb API 密钥。

配置采集源文件 (`db.json`)

影视资源的获取依赖于 db.json 文件中定义的采集源（站点）。配置的采集源越多，理论上可检索到的资源范围就越广。请注意，公开分享具体的采集源地址可能涉及侵权风险，因此需要您自行寻找和添加。

项目在首次运行时通常会尝试自动生成 db.json 文件。如果未能生成，建议您手动创建该文件。文件内容结构如下：

{
  "sites": [
    {
      "key": "unique_key1",       // 每个站点的唯一标识符（英文字母，不可重复）
      "name": "站点名称1",         // 在软件界面中显示的名称
      "api": "https://...",      // Maccms V10/JSON 接口地址
      "active": true             // 是否启用该站点
    },
    {
      "key": "unique_key2",
      "name": "站点名称2",
      "api": "https://...",
      "active": true
    }
    // 您可以继续添加更多站点
  ]
}

获取 TMDb API Key

TMDb 的 API 密钥用于拉取影片的详细信息、海报和评分等元数据，这对于提升界面美观度和使用体验至关重要。获取步骤如下：

访问 TMDb 官方网站：https://www.themoviedb.org/。
您可以在页面底部先将网站语言切换为中文以便操作。
若尚未拥有账号，请先完成注册流程。
使用您的账号密码登录。
登录后，点击右上角头像，在下拉菜单中选择“账户设置”。
在设置页面侧边栏找到并点击“API”选项。
在 API 页面点击“创建”或“新增”按钮。
仔细阅读开发者条款，滚动到页面底部并点击“接受”。
按要求填写申请表。在“应用简介”一栏，可以填写诸如“As an ordinary user, I hope to obtain tmdb API for better configuration of some personal audio-visual software.”的描述。
创建成功后，您将获得一个 API 密钥 (v3 auth)，请妥善保存，在后续部署中将用到它。

（可选）部署 TMDB 反代服务

对于部分国内用户，直接访问 TMDb 可能不稳定，导致海报和元数据无法加载。此时可以配置反向代理来解决。请注意，此步骤非必需，建议先完成容器部署，若遇到图片加载问题再回头配置。另一种更简便的解决方案是在家庭路由器中修改 Hosts，将 TMDb 域名指向一个可访问的 IP 地址。

安装与部署步骤

接下来，我们将在 NAS 上通过 Docker 容器来部署 E 视界。

在 NAS 上创建一个用于存放配置和数据文件的目录，例如 donggua-tv。
在该目录下，创建一个名为 cache.db 的空文件，它将作为 SQLite 缓存数据库。
将之前准备好的 db.json 配置文件也放入此目录。
在 donggua-tv 目录中创建 docker-compose.yml 文件，并填入以下内容。请务必将 your_api_key_here 和 your_password 替换为您实际的 TMDb API 密钥和您想设置的访问密码。

Docker Compose 配置示例：
```
services:
  donggua-tv:
    image: ghcr.io/ednovas/dongguatv:latest
    container_name: donggua-tv
    ports:
      - 3000:3000
    environment:
      - TMDB_API_KEY=your_api_key_here  # 替换为你的TMDb API密钥
      - ACCESS_PASSWORD=your_password   # 替换为你设定的访问密码
      - CACHE_TYPE=sqlite
    volumes:
      - ./db.json:/app/db.json
      - ./cache.db:/app/cache.db
      - ./cache/images:/app/public/cache/images
    restart: unless-stopped
```
关键参数说明（更多选项请参考项目文档）：
- TMDB_API_KEY：必需的 TMDb API 密钥。
- TMDB_PROXY_URL（可选）：如果需要，可在此指定 TMDb 反代地址。
- ACCESS_PASSWORD（可选）：设置后，访问网页需输入此密码。
- PORT（可选）：可自定义容器内部端口，默认为 3000。
- CACHE_TYPE：缓存类型，建议使用 sqlite 以获得更好性能。
- /app/db.json：容器内采集源配置文件的路径。
- /app/cache.db：容器内缓存数据库文件路径。
- /app/public/cache/images：容器内图片缓存目录路径。
打开终端或 SSH 连接到 NAS，进入 donggua-tv 目录，执行命令 docker-compose up -d 启动容器。项目启动后会自动在目录下生成必要的子文件夹，cache.db 文件大小也会增加，这属于正常现象。

使用体验与界面浏览

容器成功运行后，在浏览器地址栏输入 http://你的NAS的IP地址:3000 即可访问 E 视界的管理界面。

首次访问需要输入您在 docker-compose.yml 中设置的 ACCESS_PASSWORD。

登录后的主界面设计精美，布局清晰，与 Emby、Plex 等专业媒体库软件的界面观感相似。如果页面上海报和影片信息显示空白，请检查 TMDb API 密钥是否正确，或网络是否可正常连接 TMDb 服务。

顶部的搜索栏是核心功能，输入想看的影片名称即可进行全局搜索。

您配置的采集源越多，搜索返回的结果通常也更丰富、更全面。

点击任意影片即可开始播放，大部分资源的播放流畅度都有保障。

播放页面底部不仅提供了详细的剧情简介，还支持一键切换不同的播放线路，对于剧集，选集操作也十分便捷。

如果您没有明确的观看目标，可以浏览首页由 TMDb 驱动的各类榜单，如热门电影、本周流行剧集等，从中发现感兴趣的内容。

通过该平台获取的影片资源通常较新，但多数资源的画质为 1080P，在手机、平板等移动设备上观看效果尚可。

软件的网页端已对移动设备做了良好的自适应优化，在手机浏览器上也能获得出色的操作体验。

除了网页版，项目官方发布页面（https://github.com/EdNovas/dongguaTV/releases）还提供了打包好的 Android APK 文件，您可以在电视盒子或安卓电视上直接安装，获得更大的遥控器操作体验。

总结与评价

与之前流行的一些流媒体聚合工具（如 LibreTV、MoonTV、KatelyaTV 等）相比，E 视界（DongguaTV）在整体观影体验上确实更胜一筹。其界面美观度、元数据完整度以及操作的流畅性都令人印象深刻。当然，它目前可能缺乏一个集中的后台管理界面来直观调整所有配置，但这并不影响其核心使用。

对于有轻度影音需求、不希望经历复杂媒体库整理过程的用户而言，E 视界极大地降低了入门门槛。部署完成后，即可享受“即搜即看”的便利，资源获取自动化程度高。

综合推荐指数：⭐⭐⭐⭐⭐（非常适合寻求简便观影方案的轻度用户） 使用体验：⭐⭐⭐⭐（界面与功能出色，主要限制在于片源画质普遍非极致高清） 部署难度：⭐⭐（利用 Docker 部署，流程清晰简单）