原库地址 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/我的收藏/ |
📝 安装后配置
- 访问
http://your-ip:28083/admin/admin
确认服务是否正常运行 一定要注意 是带有/admin/admin的 不然 访问首页是空白
- 详细配置说明请参考使用方法
详细配置说明请参考使用方法。