手把手教程:在NAS上部署E视界(DongguaTV),打造专属私人影院

本文将介绍如何将您的网络附加存储设备(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 部署,流程清晰简单)