软鉴SoftMemo
浏览软件目录

Stash-VR 是连接自建 Stash 媒体库与 VR 播放器的中间层服务，让 HereSphere、DeoVR 直接用原生 VR 界面浏览播放你的片库，并把标签、评分、标记双向同步回 Stash。

适合已用 Stash 管理片库的 VR 头显用户 · HereSphere 重度用户 · NAS/家庭服务器玩家

亮点

  1. 双向同步不做单向桥

    HereSphere 里改标签、打评分、加 marker、增加播放与 o-count，都会写回 Stash，不用回电脑补录元数据。

  2. 沿用 Stash 已存筛选器

    Stash 里保存的 scene filter 直接变成播放器里的分区，片库组织方式不用为 VR 重做一遍。

  3. 一个容器就跑起来

    docker run 加 Stash 的 graphql 地址和 API key 即可，默认 9666 端口，几乎没有额外配置负担。

  4. 互动内容原样支持

    Stash 生成的热力图、funscript、字幕都会透传给播放器，交互场景不用另开一套工具链。

功能说明

播放与浏览

  1. 原生 VR UI

    直接在 HereSphere / DeoVR 自带界面里浏览和播放，不需要额外前端。

  2. 转码端点

    提供指向 Stash 转码流的端点，兼容原文件播不动的场景。

  3. 2D 视频同样可看

    平面视频与 VR 视频都能纳入同一片库浏览。

  4. 热力图展示

    互动场景显示 Stash 生成的热力图，高度可用 HEATMAP_HEIGHT_PX 调整。

元数据管理

  1. 标签读写

    在 HereSphere 用 #:名称 格式的 Video Tag 增删 Stash 标签，不存在时自动创建。

  2. 分类元数据生成

    自动生成分类标签、工作室、演员维度，便于在头显里按维度找片。

  3. 收藏标签

    用 FAVORITE_TAG 指定的 Stash 标签承载收藏，默认 FAVORITE。

  4. 删除场景

    HereSphere 端可直接删除场景，操作会作用到 Stash。

部署与配置

  1. Docker 镜像

    Docker Hub 提供 ofl0w/stash-vr 镜像，仓库内附 docker-compose 示例。

  2. 独立二进制

    也可下载二进制直接运行，参数与环境变量等价。

  3. 配置持久化

    设置 CONFIG_PATH 才能让页面内的改动在重启后保留。

  4. 反代兜底选项

    FORCE_HTTPS 用于反向代理下链接协议出错时的最后手段。

适合场景

  1. 已用 Stash 管理片库的 VR 头显用户

    零成本把现有库和筛选器搬进头显，还能在头显里补元数据。

  2. HereSphere 重度用户

    标签、评分、marker、o-count 双向同步是这款工具的完整形态。

  3. NAS/家庭服务器玩家

    一个轻量容器挂在现有 Docker 环境旁边，资源占用低。

取舍

选它的理由

  • 双向同步真能写回 Stash 元数据
  • 复用已有 filter，零重复整理片库
  • 单容器部署，必填项只有两个
  • 热力图、funscript、字幕一并透传

先想清楚

  • 没有也不打算搭建 Stash
  • 用 Pico/Quest 自带播放器或其他第三方播放器
  • 想要开箱即用的安装向导
  • 必须先有一个跑起来的 Stash 实例

安全警示

  • 项目服务于成人内容管理工具 Stash 的片库，涉及敏感隐私数据，暴露到公网前务必加认证与反向代理保护。
  • Stash-VR 需要 Stash 的 API key 才能工作，密钥以环境变量形式明文传入容器，主机被入侵即等于片库完全失控。
  • 星标约 135、单人维护、最后推送 2026-04，属小众项目，供应链与漏洞响应能力有限，未见第三方安全审计。

基于公开资料与 AI 分析整理，仅供参考，请自行核实。

同类推荐

查看全部

更多「影音娱乐」软件

软鉴 SoftMemo

AI 整理的软件知识库

AI 整理软件资料、版本动态、更新通知、订阅权益与对比分析，沉淀可复用的工具知识。

进入软鉴浏览软件目录
访问网站