StrmGuide

STRM 配置指南

STRM 文件是实现云端资源本地化播放的核心，本文档详细介绍 STRM 的配置和使用。

---

1. STRM 概述

什么是 STRM

STRM（Stream）是一种文本文件，包含媒体播放地址，让媒体服务器（Emby/Jellyfin/Plex）可以播放云端资源。

文件格式

# 内容示例
http://192.168.1.100:8097/proxy/video.mkv

---

2. STRM 配置

基础配置

在"STRM"页面管理所有 STRM 配置：

配置项	说明
启用 STRM	全局开关
使用流代理	通过代理端口播放

路径映射

配置云端路径与本地路径的映射关系：

云端路径前缀: /189Cloud/影视
本地路径前缀: /media/video

---

3. STRM 生成方式

实时生成（自动）

任务转存完成后自动生成 STRM：

1. 扫描云端文件列表
2. 创建对应目录结构
3. 生成 STRM 文件

批量生成

针对已有文件批量生成：

1. 进入"STRM"页面
2. 点击"批量生成"
3. 选择任务或输入路径
4. 确认生成

懒转存 STRM

播放时才触发转存：

• 无需预先转存
• 播放时自动处理
• 节省网盘空间

---

4. 流代理配置

独立代理端口

默认端口：8097

功能：

• 动态获取最新直链
• 解决链接过期问题
• 支持多账号切换

Docker 映射

docker run -d \
  -p 3000:3000 \
  -p 8097:8097 \
  ...

Nginx 反向代理

location /emby-proxy/ {
    proxy_pass http://127.0.0.1:8097/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

---

5. STRM 文件结构

目录结构示例

/media/
├── 电影/
│   ├── 阿凡达 (2009).strm
│   └── 盗梦空间 (2010).strm
└── 电视剧/
    └── 庆余年/
        ├── S01E01.strm
        ├── S01E02.strm
        └── ...

内容格式

# 直接直链（会过期）
https://cloud.189.cn/download/xxx

# 代理地址（推荐）
http://192.168.1.100:8097/proxy/账号ID/文件ID/视频.mkv

---

6. 与 Alist 联动

配置 Alist

1. 在"媒体设置"中配置 Alist
2. 设置 Alist 挂载路径

同步 Alist 结构

从 Alist 同步目录结构生成 STRM：

1. 输入 Alist 路径
2. 选择目标 STRM 目录
3. 执行同步

---

7. API 接口

批量生成 STRM

POST /api/tasks/strm
Header: x-api-key: YOUR_API_KEY
Body: {
  "taskId": 1,
  "force": false
}

获取 STRM 配置列表

GET /api/strm-configs
Header: x-api-key: YOUR_API_KEY

---

💡 最佳实践

• 使用流代理：避免直链过期问题
• 合理规划目录：便于媒体服务器刮削
• 定期同步：保持 STRM 与云端一致