ofl0w/stash-vr

镜像概述

该镜像是一个自托管服务，旨在为用户提供在VR（虚拟现实）环境中访问和观看个人媒体收藏库的解决方案。通过本地部署，用户可将电影、视频等媒体文件组织成私有库，并通过VR设备实现沉浸式观影体验，无需依赖第三方平台。

核心功能与特性

• 自托管架构：支持本地服务器或私有网络部署，数据存储在用户自有设备中，保障媒体文件隐私与访问控制权。
• VR兼容性：适配主流VR头显设备（如Oculus Quest、HTC Vive、Valve Index等），提供3D沉浸式观影界面。
• 媒体库集成：支持访问本地存储或网络共享目录中的媒体文件，兼容常见视频格式（MP4、MKV、AVI、MOV等）。
• 轻量化部署：基于容器化设计，资源占用低，可运行于个人电脑、NAS或小型服务器。

使用场景与适用范围

• 个人VR影院：用户通过VR头显在虚拟环境中观看私有媒体库，模拟巨幕影院体验。
• 家庭媒体中心：家庭用户在VR设备中共享媒体收藏，支持多人同步观影（需VR设备支持）。
• 隐私优先场景：对数据隐私敏感的用户，通过自托管方式避免第三方平台的数据收集与内容审查。

使用方法与配置说明

Docker Run 部署示例

bash
docker run -d \
  --name vr-media-library \
  -p 8080:8080 \
  -v /path/to/local/media:/media \
  -e MEDIA_ROOT=/media \
  -e VR_DISPLAY_MODE=theater \
  --restart unless-stopped \
  [镜像名称]

参数说明：

• -p 8080:8080：映射服务端口（主机端口:容器端口）
• -v /path/to/local/media:/media：挂载本地媒体目录到容器内/media路径
• -e MEDIA_ROOT：指定媒体库根目录（需与挂载路径一致）
• -e VR_DISPLAY_MODE：设置VR显示模式（可选值：theater/immersive/flat）

环境变量配置

访问与使用流程

1. 部署完成后，在VR设备中打开浏览器，访问 http://[主机IP]:[映射端口]
2. 首次访问需完成VR头显适配（根据页面指引校准显示参数）
3. 系统自动扫描MEDIA_ROOT目录下的媒体文件，生成可浏览的媒体库列表
4. 选择目标文件即可开始VR观影，支持播放控制（暂停/快进/音量调节）及显示模式切换

注意事项

• 确保VR设备与主机处于同一网络环境，建议通过有线网络连接以保障流媒体稳定性
• 媒体文件分辨率建议不低于1080p，以获得更佳VR观影效果
• 高分辨率视频播放需主机具备足够的CPU/GPU性能，避免卡顿