2.1 虚空终端（网络环境配置）#

Symedia 在刮削元数据、通过 Bot 推送通知以及我们拉取 Docker 镜像时，需要一个相对科学的网络环境。

如果你使用的是家用 NAS，解决方式较多：

1. 旁路网关：在局域网内运行基于虚空终端的软件，开启“允许局域网连接”，获取内网代理地址（如 192.168.1.x:7890）
2. 透明代理：在主路由或软路由层面解决
3. 本机运行：直接在服务端运行虚空终端核心

下面重点介绍方法 3，它同时适用于云服务器和 NAS 环境。

操作步骤：

1. 下载核心：用电脑下载适用于你服务器架构（通常是 linux-amd64​）的虚空终端核心并解压。

2. 上传文件：将核心文件上传到服务器的工作目录，假设重命名为 mihomo-linux-amd64。

3. 安装与配置：执行以下命令，创建目录并赋予权限。

   1
   sudo mv mihomo-linux-amd64 /usr/local/bin/mihomo
   2
   sudo chmod +x /usr/local/bin/mihomo
   3
   sudo mkdir -p /etc/mihomo
   4
   sudo vi /etc/mihomo/config.yaml
   

4. 编辑配置文件：先填入下面的基础配置，然后从你自己的订阅配置文件中复制 proxies​、proxy-groups​ 和 rules 部分填入下方。

   1
   # 基础端口设置
   2
   port: 7890
   3
   socks-port: 7891
   4
   mixed-port: 7893
   5
   allow-lan: true
   6
   mode: Rule
   7
   log-level: info
   8
   ipv6: true
   9
   external-controller: '0.0.0.0:9990'
   10
   secret: "您的后台密码"
   11
   external-ui: /etc/mihomo/ui
   12
   
   13
   # --- 关键：TUN 模式配置 ---
   14
   # 在拉取 Docker 镜像时非常有用，日常运行可关闭
   15
   tun:
   16
     enable: false
   17
     stack: system # 或者 gvisor
   18
     dns-hijack:
   19
       - any:53
   20
     auto-route: true
   21
     auto-detect-interface: true
   22
   
   23
   # --- 关键：DNS 配置 (配合 TUN 必须开启 fake-ip 或 redir-host) ---
   24
   dns:
   25
     enable: true
   26
     listen: 0.0.0.0:53
   27
     enhanced-mode: fake-ip
   28
     nameserver:
   29
       - 8.8.8.8
   30
       - 1.1.1.1
   31
   
   32
   # --- 请在下方粘贴您的 proxies, proxy-groups, rules ---
   

5. 配置 UI 面板：下载 Metacubexd 或其他 UI 的 release 压缩包，解压后将文件夹内的所有文件放入 /etc/mihomo/ui​。
   注意：运行时如果提示缺少 MMDB 文件，请自行下载 ​Country.mmdb​​ 放入 ​/etc/mihomo​​ 目录。

6. 设置开机自启：
   创建服务文件：

   1
   sudo nano /etc/systemd/system/mihomo.service
   

   填入内容：

   1
   [Unit]
   2
   Description=Mihomo Daemon
   3
   After=network.target
   4
   
   5
   [Service]
   6
   Type=simple
   7
   User=root
   8
   # TUN 模式必须用 root 权限运行
   9
   ExecStart=/usr/local/bin/mihomo -d /etc/mihomo
   10
   Restart=on-failure
   11
   
   12
   [Install]
   13
   WantedBy=multi-user.target
   

   启动服务：

   1
   sudo systemctl daemon-reload
   2
   sudo systemctl enable mihomo --now
   3
   sudo systemctl status mihomo
   

7. 验证：访问 http://服务器IP:9990/ui，填入服务器 IP 和密码即可进入控制面板。

2.2 Docker 环境#

在安装 Docker 和拉取镜像之前，建议先在虚空终端的网页面板中，开启 “配置” -> “开启 TUN 转发”​。下载完成后记得关闭此开关，以免影响其他服务。

安装 Docker ：

1
curl -fsSL https://get.docker.com | bash

CloudDrive2 (CD2)#

此处不使用 Docker 版本的 CD2，前往 CloudDrive2 官网 下载 Linux x86_64 版本。

请详细阅读 CD2 官方教程。将下载的 tgz​ 包解压到你的工作目录，例如 /root​。解压后，最终的可执行文件路径应类似：/root/clouddrive-2-linux-x86_64-x.x.x/clouddrive。

设置开机自启服务：

1
sudo nano /etc/systemd/system/clouddrive.service

1
[Unit]
2
Description=CloudDrive Daemon
3
After=network.target
4

5
[Service]
6
Type=simple
7
User=root
8
# 请根据实际解压路径修改 WorkingDirectory 和 ExecStart
9
WorkingDirectory=/root/clouddrive-2-linux-x86_64-你的版本号
10
ExecStart=/root/clouddrive-2-linux-x86_64-你的版本号/clouddrive
11
Restart=on-failure
12

13
[Install]
14
WantedBy=multi-user.target

启动 CD2：

1
sudo systemctl daemon-reload
2
sudo systemctl enable clouddrive --now
3
sudo systemctl status clouddrive

安装完成后，可通过 http://服务器IP:19798 访问 CD2 管理页面。

OpenList#

OpenList 是一个轻量级的目录列表程序，支持 302 重定向，是本方案中处理非 115 网盘（如 123 盘）直链的工具。

使用官方一键脚本安装（脚本可能随时间更新，建议到官网一键安装寻找最新脚本）：

1
curl -fsSL https://res.oplist.org/script/v4.sh > install-openlist-v4.sh && sudo bash install-openlist-v4.sh

脚本运行过程中选择“安装OpenList”即可。安装完成后，通过 http://服务器IP:5244 访问。初始用户名和密码会显示在终端输出中，请务必记录。如果遗忘，可再次运行脚本重置密码。

Symedia#

Symedia 负责刮削、整理和生成 STRM。

1
docker run -d \
2
    --name symedia \
3
    -e TZ=Asia/Shanghai \
4
    -e LICENSE_KEY=你的Symedia激活码 \
5
    -e COVER_MAKER=true \
6
    -e HTTP_PROXY=http://127.0.0.1:7890 \
7
    -v /var/run/docker.sock:/var/run/docker.sock:ro \
8
    -v ./config:/app/config \
9
    -v ./playwright:/symedia/.cache/ms-playwright \
10
    -v ./fonts:/app/static/fonts \
11
    -v /mnt/CloudNAS:/CloudNAS:rslave \
12
    -v /mnt/media_strm:/media \
13
    -p 8095:8095 \
14
    --restart always \
15
    --network host \
16
    shenxianmq/symedia:latest

• ​HTTP_PROXY​：指向你搭建的虚空终端。如果 Symedia 使用 host​ 网络模式，填 127.0.0.1:7890 即可；否则需填服务器内网 IP。
• ​/mnt/CloudNAS：这是 CD2 挂载网盘的根目录的上级目录。
• ​/mnt/media_strm：这是 Symedia 生成的 STRM 文件存放的本地路径。

访问端口：8095

Emby#

媒体服务器核心。

1
docker run -d \
2
  --name emby_server \
3
  --restart always \
4
  --network host \
5
  -e PUID=0 \
6
  -e PGID=0 \
7
  -e TZ=Asia/Shanghai \
8
  -v /mnt/emby_data:/config \
9
  -v /mnt/CloudNAS:/CloudNAS:rslave \
10
  -v /mnt/media_strm:/media \
11
  linuxserver/emby:latest

• ​/mnt/emby_data：Emby 的配置数据目录，可以改变。
• ​/mnt/media_strm:/media：将 Symedia 生成的 STRM 映射给 Emby 读取。

访问端口：8096

FastEmby#

用于接管 115 视频流量并实现重定向。

1
docker run -d \
2
  --name FastEmby \
3
  --network host \
4
  --restart unless-stopped \
5
  -e LICENSE_KEY=你的Symedia激活码 \
6
  -v /mnt/fastEmby/config:/app/config \
7
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
8
  shenxianmq/fastemby:latest

访问端口：9026

CloudDrive2 挂载#

访问 CD2 后台，登录你的 115 和 123 网盘账号。

• 115 网盘挂载名设为：/115open
• 123 网盘挂载名设为：/123云盘

进入“挂载”，点击添加挂载点。按照下图填写，将网盘挂载到我们预设的 /mnt/CloudNAS/CloudDrive。

挂载完成后，进入“我的文件”，找到网盘内的影视库文件夹，点击“详情”，将缓存时间修改为 0 秒。如果后期遇到添加了影片，但是Symedia却找不到文件、无法链接的情况，可以点击黄色时钟按钮清空缓存。

目录结构建议： 为了配合 Symedia 的自动整理，建议按照如下树状结构组织你的网盘影视库：

1
115影视库
2
├── 电影
3
│   └── 上海堡垒 (2019)
4
│       ├── 上海堡垒 (2019) {tmdb-xxxxx} - 4K DV.mkv
5
│       └── (元数据)
6
├── 动漫
7
│   └── 笨女孩 (2017)
8
│       ├── (元数据)
9
│       └── Season 1
10
│           ├── (集元数据)
11
│           └── 笨女孩 (2017) S01E01 - 标题.mkv
12
├── 演唱会
13
└── 电视剧

OpenList 挂载#

OpenList 主要用于解决 123 盘等非 115 网盘的直链分发。

1. 全局设置：进入设置 -> 全局，关闭“签名所有”。
   ​

2. 添加驱动：

   • 进入存储 -> 添加。
   • 驱动选择：123开放平台
   • 挂载路径：/123云盘
   • WebDAV 策略：302 重定向
   • 其他参数（客户端 ID、密钥等）：请参考 OpenList 官方文档 - 123开放平台驱动 获取并填写

6.1 插件配置：EmbyServer#

进入 Symedia 插件中心，找到 EmbyServer。
按照下图填写 Emby 地址和 API Key。API Key 可以在 Emby 后台 -> API 页面生成。填写完毕记得保存。

6.2 添加网盘账号#

1. 115 设置：设置 -> 115设置 -> 添加配置 -> 随便填写名称 -> 保存。
   ​

   • Cookie 获取：去插件中心安装“115扫码cookie”插件，扫码获取 Cookie 后，可以一键填入刚才创建的配置中。

2. 123 设置：设置 -> 123设置 -> 直接填写账号密码保存。
   ​

6.3 STRM 链接同步#

115 网盘同步任务： 打开“链接同步”界面，创建任务。

• 媒体目录：选择 CD2 挂载的 115 影视库目录。
• 链接目录：选择 /media/影视库115（Symedia 容器内的路径）。

​

在“实时监控”选项卡中，选择 Webhook 模式。

123 网盘同步任务： 创建新任务，设置逻辑同上，但请注意下图红框标记的字段。

6.4 连接 CD2 并开启 Webhook#

Symedia 插件 -> clouddrive2助手。

• 服务器地址：填写 CD2 的访问地址（如果你的CD2是容器化的，IP填写服务器的内网IP，如果你按照本文来部署的，无需改动）。
• API Token：在 CD2 界面创建一个拥有**所有权限**的 Token 填入。

保存配置后，Symedia 就能接收到 CD2 的文件变动通知。

6.5 运行同步与归档#

1. 启动同步：在链接同步界面，启动 115 和 123 的任务。可以在日志中查看进度。
   如果卡住，可以在“CD2-系统任务-下载任务”查看情况，通常是由于下载到了体积较大的元数据或者多音轨。这是正常现象，如果嫌慢，可以编辑任务-高级配置-元数据后缀-去掉mka,mp3,flac等体积可能较大的文件。

2. 配置自动归档：

   • 创建规则：Symedia -> 归档刮削 -> 规则。推荐使用“自动二级分类”，文件名保持默认。
   • 创建任务：Symedia -> 归档刮削 -> 任务列表。源目录指向网盘内的“影视库待归档”文件夹，目标目录指向正式的“影视库”文件夹。

​

设置完成后，只需将下载或转存的影片丢入“待归档”文件夹，Symedia 就会全自动刮削、重命名并移动到影视库，整个过程行云流水。