StreamVault 多平台视频下载 支持通过小程序、快捷指令、API、WEB

MochiQ

原库地址 https://github.com/lemon8866/StreamVault

# 安装指南

## 系统要求

- 支持 Docker 的设备（Linux/Windows/MacOS）
- 足够的磁盘空间用于视频存储
- 稳定的网络连接

## 🐳 Docker 部署

目前仅提供 Docker 方式部署，确保简单稳定的安装体验。

### 快速启动

```bash
docker run --name stream-vault -d \
  -p 28083:28081 \
  -v /path/to/data:/app \
  -v /path/to/tmp:/tmp \
  qingfeng2336/stream-vault

参数说明

参数	说明
--name stream-vault	容器名称
-d	后台运行
-p 28083:28081	端口映射，前面是主机端口，后面是容器端口
-v /path/to/data:/app	数据持久化目录
-v /path/to/tmp:/tmp	临时文件目录

示例

Windows 环境下运行：

docker run --name stream-vault -d -p 28083:28081 ^
  -v d:/home/spirit:/app ^
  -v d:/home/spirit/tmp:/tmp ^
  qingfeng2336/stream-vault

Linux/MacOS 环境下运行：

docker run --name stream-vault -d -p 28083:28081 \
  -v /home/spirit:/app \
  -v /home/spirit/tmp:/tmp \
  qingfeng2336/stream-vault

目录结构说明

Docker 容器的 /app 目录包含以下重要子目录：

目录	说明	是否必需
/app/cookies	yt-dlp 的 cookie 存档位置- 在web端导入后生成- 注：哔哩哔哩和抖音不使用此 cookie	可选
/app/db	数据库文件存储位置	必需
/app/log``/app/logs	日志文件目录	建议挂载
/app/lot	与 f2 库交互的文件目录⚠️ 默认为空，请勿手动操作	可选
/app/resources	所有资源文件存储位置	必需
/app/tmp	应用临时文件目录- 可以随时清理- 不影响核心功能	可选

⚠️ 重要提示：

• 建议使用完整的 /app 目录挂载，而不是分别挂载子目录
• 分别挂载各个子目录仅建议 Docker 专业用户使用，可能会导致未知问题

推荐的挂载方式

docker run --name stream-vault -d -p 28083:28081 \
  -v /path/to/data:/app \
  -v /path/to/tmp:/tmp \
  qingfeng2336/stream-vault

Windows 环境示例：

docker run --name stream-vault -d -p 28083:28081 ^
  -v d:/stream-vault:/app ^
  -v d:/stream-vault/tmp:/tmp ^
  qingfeng2336/stream-vault

资源目录结构说明

/app/resources 目录下的文件组织方式根据下载模式不同而不同：

1. 分享链接模式

/app/resources/
**── platform/           # 平台名称（如 bilibili、douyin）
    **── odd/           # 单链下载视频存储位置
        **── 2024/      # 按年份归档
        **── 2023/
        **── ...

2. 收藏夹模式

/app/resources/
**── platform/          # 平台名称（如 bilibili、douyin）
    **── collection/    # 收藏夹视频存储位置
        **── favname1/  # 收藏夹名称或任务名称
        **── favname2/
        **── ...

目录结构	说明	示例
/app/resources/platform/odd/yyyy	单链下载的视频存储位置- platform: 平台英文名称- yyyy: 年份	/app/resources/bilibili/odd/2024/
/app/resources/platform/collection/favname	收藏夹模式下载的视频存储位置- platform: 平台英文名称- favname: 收藏夹或任务名称	/app/resources/bilibili/collection/我的收藏/

📝 安装后配置

1. 访问 http://your-ip:28083/admin/admin 确认服务是否正常运行 一定要注意 是带有/admin/admin的 不然 访问首页是空白
2. 详细配置说明请参考使用方法

详细配置说明请参考使用方法。