家庭轻量级全能视听系统搭建指南（OK影视 + 本地小雅 + 短剧全聚合 + IPTV高清直播）

2026-10-06

核心特色：
极致轻量：抛弃传统的服务端硬解转码（如 Emby/Jellyfin 动辄占用 2GB+ 内存），采用直链直通 + 客户端硬解架构，包含点播、短剧、IPTV直播在内的全套核心容器总内存占用 < 100MB！
单端口统一入口（All-in-One Gateway）：只需开放 8085 端口，即可同时搞定 TVBox 配置托管、小雅百万级影视库、4700+ 短剧秒播、IPTV 直播源代理以及豆瓣正版海报防盗链。
点播 + 直播全覆盖：115 / 夸克 / 阿里 4K REMUX 原盘直连、红果/黄豆/黄果短剧聚合，以及央视/卫视 4K 高清 IPTV 电视直播。

一、整体架构设计

在家庭 NAS 或私有服务器（Docker 环境）中，通过一个极简轻量的 Python 网关（voxpro:8085）将所有视听服务聚合为一个出口，解决跨网段、端口繁多及图片防盗链等问题：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
[ 手机 / 电视 / 平板 OK影视 (TVBox) ]
                 │
                 ▼  (唯一配置地址: http://<NAS_IP>:8085/demo.json)
      ┌──────────────────────┐
      │   voxpro 统一网关     │  (内存 ~8MB，监听 8085 端口)
      └──────────────────────┘
        │         │         │         │
        ▼         ▼         ▼         ▼
   [本地小雅]   [果剧短剧]  [IPTV直播] [豆瓣防盗链代理]
   (5678端口)  (8998端口)  (8767端口) (自动注入 Referer)

核心容器资源占用实测

容器服务	默认端口	内存占用	核心作用
`voxpro`	`8085`	~8 MB	统一网关：托管 TVBox 配置、代理视频流、防盗链海报中继
`playlet`	`8998`	~20 MB	果剧短剧库：本地维护 4,700+ 部短剧并提供秒播中继
`xiaoya`	`5678`	~31 MB	小雅 Alist 影视库：挂载 115、夸克、阿里等各大网盘影视
`ysp-live`	`8767`	~29 MB	IPTV 直播源服务：提供央视/卫视 4K、高清电视直播流

二、核心服务部署步骤

注：以下配置中的 192.168.x.x 为示例 IP，请在实际部署时替换为您 NAS / 服务器的局域网真实 IP；Docker 目录以通用的 /opt/docker 为例。

1. 部署 IPTV 电视直播服务（`ysp-live`）

ysp-live 能够自动提取央视频高清及 4K 电视直播源并生成标准 M3U 播放列表。创建 /opt/docker/ysp-live/docker-compose.yml：

1
2
3
4
5
6
services:
  ysp-live:
    image: python:3.11-alpine
    container_name: ysp-live
    restart: unless-stopped
    network_mode: host

部署完成后，访问 http://192.168.x.x:8767/all.m3u 即可获取完整的央视、卫视 4K 全频道播放列表。

2. 部署本地短剧库（`playlet`）

创建 /opt/docker/playlet/docker-compose.yml：

1
2
3
4
5
6
7
8
9
services:
  playlet:
    image: winglini/juku:latest
    container_name: playlet
    restart: unless-stopped
    ports:
      - "8998:8998"
    volumes:
      - ./data:/app/data

启动：docker compose up -d，本地即可接入 4,700+ 部红果、黄豆、黄果短剧。

3. 部署本地小雅（`xiaoya`）

按照小雅官方脚本正常部署，确保小雅 Alist 容器监听本机 5678 端口（浏览器访问 http://192.168.x.x:5678 正常）。

4. 部署 All-in-One 统一网关（`voxpro`）

创建 /opt/docker/voxpro 目录：

（1）`docker-compose.yml`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
services:
  voxpro:
    image: python:3.11-alpine
    container_name: voxpro
    restart: unless-stopped
    ports:
      - "8085:80"
    volumes:
      - ./:/srv
    working_dir: /srv
    command: python3 /srv/vox_gateway.py

（2）网关核心实现 `vox_gateway.py`

该脚本纯 Python 原生实现，零第三方依赖，集中解决：

豆瓣海报防盗链代理（/douban_img/，解决手机端 HTTP 418）；
红果短剧提取字节跳动 CDN MP4（302 秒开、支持拖拽）；
黄豆/黄果短剧 HLS 切片流转发；
小雅视频流双模转发（公网 CDN 302 硬解，本地中转流 Range 206 断点续传）；
小雅全文搜索与 API 透传。

  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
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import http.server
import socketserver
import urllib.request
import urllib.parse
import json
import re

PORT = 80
GATEWAY_PUBLIC = "http://192.168.x.x:8085"   # 替换为你自己的 NAS 局域网 IP
XIAOYA_INTERNAL = "http://192.168.x.x:5678"  # 小雅内部地址
PLAYLET_INTERNAL = "http://192.168.x.x:8998" # Playlet 内部地址

class NoRedirectHandler(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None

no_redirect_opener = urllib.request.build_opener(NoRedirectHandler)

class ThreadedHTTPServer(socketserver.ThreadingMixIn, http.server.HTTPServer):
    daemon_threads = True

class GatewayHandler(http.server.SimpleHTTPRequestHandler):
    def do_GET(self):
        parsed = urllib.parse.urlparse(self.path)
        path = parsed.path
        qs = urllib.parse.parse_qs(parsed.query)

        # 1. 豆瓣防盗链海报代理 (/douban_img/<url>)
        if path.startswith("/douban_img/"):
            try:
                real_img_url = "https://" + self.path[len("/douban_img/"):]
                req_img = urllib.request.Request(
                    real_img_url,
                    headers={"User-Agent": "Mozilla/5.0", "Referer": "https://movie.douban.com/"}
                )
                with urllib.request.urlopen(req_img, timeout=8) as img_resp:
                    img_data = img_resp.read()
                    self.send_response(200)
                    self.send_header("Content-Type", img_resp.headers.get("Content-Type", "image/webp"))
                    self.send_header("Content-Length", str(len(img_data)))
                    self.send_header("Cache-Control", "public, max-age=604800")
                    self.end_headers()
                    self.wfile.write(img_data)
                    return
            except Exception:
                self.send_response(404)
                self.end_headers()
                return

        # 2. 红果短剧直接提取字节跳动 CDN MP4 直链 (302 秒开)
        if path == "/playlet/hongguo.mp4":
            drama_id = qs.get("id", [""])[0]
            ep = qs.get("ep", ["1"])[0]
            try:
                raw_id = drama_id.split(":", 1)[-1]
                page_url = f"https://novelquickapp.com/s/{raw_id}?episode={ep}"
                req = urllib.request.Request(page_url, headers={
                    "User-Agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_6 like Mac OS X)"
                })
                html = urllib.request.urlopen(req, timeout=8).read().decode("utf-8", errors="ignore")
                m = re.search(r'"main_url"\s*:\s*"([^"]+)"', html)
                if m:
                    cdn_url = m.group(1).encode("utf-8").decode("unicode_escape")
                    self.send_response(302)
                    self.send_header("Location", cdn_url)
                    self.end_headers()
                    return
            except Exception:
                pass
            self.send_response(302)
            self.send_header("Location", f"{GATEWAY_PUBLIC}/playlet/play.m3u8?id={urllib.parse.quote(drama_id)}&ep={ep}")
            self.end_headers()
            return

        # 3. 黄豆/黄果短剧 HLS 播放列表与切片中继
        if path == "/playlet/play.m3u8":
            drama_id = qs.get("id", [""])[0]
            ep = qs.get("ep", ["1"])[0]
            chapter_id = f"{drama_id}:{ep}"
            target = f"{PLAYLET_INTERNAL}/api/video/player.m3u8?id={urllib.parse.quote(drama_id)}&chapter={urllib.parse.quote(chapter_id)}"
            try:
                with urllib.request.urlopen(target, timeout=15) as resp:
                    m3u8 = resp.read().decode("utf-8")
                    rewritten = m3u8.replace("/api/video/segment.ts", f"{GATEWAY_PUBLIC}/playlet/segment.ts")
                    body = rewritten.encode("utf-8")
                    self.send_response(200)
                    self.send_header("Content-Type", "application/vnd.apple.mpegurl")
                    self.send_header("Content-Length", str(len(body)))
                    self.end_headers()
                    self.wfile.write(body)
                    return
            except Exception as e:
                self.send_error(502, str(e))
                return

        if path == "/playlet/segment.ts":
            target = f"{PLAYLET_INTERNAL}/api/video/segment.ts?{parsed.query}"
            try:
                with urllib.request.urlopen(target, timeout=25) as resp:
                    self.send_response(200)
                    self.send_header("Content-Type", "video/mp2t")
                    self.end_headers()
                    while True:
                        chunk = resp.read(65536)
                        if not chunk:
                            break
                        self.wfile.write(chunk)
                    return
            except Exception:
                return

        # 4. 小雅 /d/ 播放直链双模代理 (公网直链 302 + 本地流式 206)
        if path.startswith("/d/"):
            target_url = XIAOYA_INTERNAL + self.path
            headers = {"User-Agent": self.headers.get("User-Agent", "okhttp/3.15")}
            if "Range" in self.headers:
                headers["Range"] = self.headers["Range"]
            req = urllib.request.Request(target_url, headers=headers, method="GET")
            try:
                resp = no_redirect_opener.open(req, timeout=15)
                status = resp.getcode()
            except urllib.error.HTTPError as e:
                status = e.code
                resp = e
            if status in (301, 302, 303, 307, 308):
                loc = resp.headers.get("Location", "")
                if loc.startswith("http") and "5678" not in loc:
                    self.send_response(302)
                    self.send_header("Location", loc)
                    self.end_headers()
                    return
            # 本地中转流
            with urllib.request.urlopen(req, timeout=20) as sresp:
                self.send_response(sresp.getcode())
                for k, v in sresp.headers.items():
                    if k.lower() in ("content-type", "content-length", "content-range", "accept-ranges"):
                        self.send_header(k, v)
                self.end_headers()
                while True:
                    chunk = sresp.read(65536)
                    if not chunk:
                        break
                    self.wfile.write(chunk)
            return

        # 5. 小雅搜索引擎与 API 透传
        if path.startswith(("/api/", "/search", "/whatsnew")):
            target_url = XIAOYA_INTERNAL + self.path
            req = urllib.request.Request(target_url, headers={"User-Agent": "Mozilla/5.0"})
            with urllib.request.urlopen(req, timeout=10) as resp:
                data = resp.read()
                self.send_response(resp.getcode())
                self.send_header("Content-Type", resp.headers.get("Content-Type", "text/html"))
                self.end_headers()
                self.wfile.write(data)
            return

        return super().do_GET()

if __name__ == "__main__":
    with ThreadedHTTPServer(("0.0.0.0", PORT), GatewayHandler) as httpd:
        print(f"Gateway running on port {PORT}...")
        httpd.serve_forever()

三、 TVBox 配置文件（`demo.json`）配置

在 demo.json 中配置 IPTV 电视直播源与点播爬虫，客户端导入一个链接即可同时拥有电视直播与全量点播：

 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
{
  "spider": "./jar/vox.jar",
  "wallpaper": "http://饭太硬.top/深色壁纸/api.php",
  "lives": [
    {
      "name": "📡央视频┃真4K全频道",
      "type": 0,
      "url": "http://192.168.x.x:8767/all.m3u",
      "epg": "https://live.fanmingming.com/e.xml",
      "logo": "https://garysclub.sharewithyou.dpdns.org/logos/ysp-live-logos/{name}.png"
    },
    {
      "name": "📡精选卫视┃高清直播",
      "type": 0,
      "url": "https://sub.ottiptv.cc/huyayqk.m3u"
    }
  ],
  "sites": [
    {
      "key": "csp_Douban",
      "name": "🥰豆瓣┃[导航]",
      "type": 3,
      "api": "csp_Douban",
      "searchable": 0,
      "changeable": 1,
      "indexs": 1,
      "ext": "./json/douban.json"
    },
    {
      "key": "Local_Xiaoya_Py",
      "name": "🌟本地小雅┃[原生]",
      "type": 3,
      "api": "./Zx/本地小雅.py",
      "searchable": 1,
      "quickSearch": 1,
      "filterable": 1,
      "changeable": 1
    },
    {
      "key": "GuoJu_Py",
      "name": "🍎果剧┃[全聚合]",
      "type": 3,
      "api": "./Zx/果剧.py",
      "searchable": 1,
      "quickSearch": 1,
      "filterable": 1,
      "changeable": 1
    },
    {
      "key": "csp_HongGuo",
      "name": "🍎红果┃[官直连]",
      "type": 3,
      "api": "csp_HongGuo",
      "searchable": 1,
      "quickSearch": 1,
      "filterable": 1
    }
  ]
}

四、本地小雅与果剧爬虫核心设计技巧

本地小雅（./Zx/本地小雅.py）：
- 十大频道全覆盖：直接对接小雅原生 /whatsnew 接口，包含每日更新、电影豆瓣榜、中国电影、4K REMUX、国产热剧、欧美大剧、热播韩剧、精选动漫、纪录大片与综艺；
- 正版豆瓣海报中继：卡片与搜索封面通过网关 /douban_img/ 转换，手机端 100% 显示高清官方海报；
- 毫秒级全文搜索：接入小雅专有 /search?box=关键词 全文引擎，搜出剧集后自动向下递归展开各季选集（例如搜出《庆余年》直接展示 82 集 4K 原盘选集）。
果剧全聚合（./Zx/果剧.py）：
- 分类整合：清晰分为「红果精品」、「黄豆短剧」、「黄果短剧」、「全部短剧」四大标签页；
- 自动分流：红果自动提取官方 CDN MP4 享受秒开与拖拽，黄豆与黄果无缝走网关 HLS 流。

五、客户端使用方式（OK影视 / TVBox）

在手机、平板或智能电视上安装 OK 影视（或 TVBox 等兼容客户端）；
打开「设置」->「点播」，在配置地址栏填入：
1
http://192.168.x.x:8085/demo.json
(将 192.168.x.x 替换为您 NAS / 服务器的局域网 IP)
点播使用：在首页站点下拉选择「本地小雅」或「果剧」，或者直接点击右上角放大镜全局搜索大片与短剧；
直播使用：进入客户端底部的「直播」菜单，即可直接收看央视 4K 全频道与各大卫视的高清电视直播！

一、 整体架构设计

核心容器资源占用实测

二、 核心服务部署步骤

1. 部署 IPTV 电视直播服务（ysp-live）

2. 部署本地短剧库（playlet）

3. 部署本地小雅（xiaoya）

4. 部署 All-in-One 统一网关（voxpro）

（1）docker-compose.yml

（2）网关核心实现 vox_gateway.py

三、 TVBox 配置文件（demo.json）配置

四、 本地小雅与果剧爬虫核心设计技巧

五、 客户端使用方式（OK影视 / TVBox）

说些什么吧！