JavBoss

本地 JAV/视频 管理一站式解决方案：自动扫描目录视频生成封面截图，识别 JAV 并抓取元数据，提供强大的视频和 JAV 检索功能，并通过内置 mpv 播放器快速播放。

此项目仍处于快速迭代中，点个 Star ⭐支持一下，不错过任何新版本功能更新，你的支持是作者积极更新的动力😊。

为什么选择 JavBoss？

• 零配置开箱即用，小白也能轻松上手。

• 横跨 Windows、MacOS、Linux 三大平台，也支持通过 Docker 部署在 NAS 中长期运行。

• 视频扫描、刮削、管理、播放等全链路完全自研，不被第三方软件卡脖子。

• 针对 JAV 场景进行深度定制，体验远超 JAV刮削器 + 通用媒体库 的常规组合。

• 可在 视频 和 JAV 两种运行模式之间自由切换，既是一个专业的 JAV 管理软件，也可作为通用视频管理软件使用。

• 深度集成 MPV 播放器，支持播放进度条预览，视频截图书签等高级功能。

• 零侵入式设计，运行数据单独存放，充分尊重用户视频目录，不做任何修改。

• 简单直观的 UI 设计，基本不需要任何使用文档，打开就知道怎么用。

作者比较懒，不喜欢写文档，实际上此软件还有批量删除视频、手动刮削、目录整理、导出 nfo 和封面等高级功能，请用户使用过程中自行挖掘。

快速开始

1. 选择安装方式

方式一：命令行一键安装（推荐）

Windows PowerShell：

irm https://raw.githubusercontent.com/Solr159/JavBoss/main/scripts/install.ps1 | iex

Linux / macOS：

curl -fsSL https://raw.githubusercontent.com/Solr159/JavBoss/main/scripts/install.sh | bash

安装脚本会自动下载对应系统的最新版发布包，完成安装后启动 JavBoss。

以后每次打开：

• Windows：双击桌面的 JavBoss 快捷方式，或在开始菜单中搜索 JavBoss。
• Linux / macOS：打开终端运行 javboss。

点击查看默认安装位置

• Windows：C:\Users\你的用户名\AppData\Local\JavBoss （右键点击桌面快捷方式 -> 属性 -> 打开文件所在位置 即可快速定位）
• Linux：~/.local/share/javboss
• macOS：~/Applications/JavBoss

方式二：手动下载

点击下载对应系统的最新版发布包并解压：

• Windows
• Linux
• macOS-x86_64（适用于 Intel 芯片的 macOS）
• macOS-arm64（适用于 M 芯片的 macOS）

也可以前往 Releases 页面查看所有版本。

下载解压后启动程序：

• Windows：双击 javboss.exe。首次运行可能会被 SmartScreen 阻止，点击“更多信息” -> “仍要运行”。
• macOS：打开终端运行 javboss.command。
• Linux：打开终端运行 javboss。

方式三：Docker 部署

docker-compose.yaml（建议放在单独的目录中）：

services:
  javboss:
    image: ghcr.io/solr159/javboss:latest
    container_name: javboss
    ports:
      - "8655:17654"
    extra_hosts:
      - "host.docker.internal:host-gateway"
    volumes:
      - ./data:/app/data
      - /:/host:ro # 默认只读挂载，如果需要使用目录整理、文件重命名、文件删除等功能，将末尾的':ro'移除
    restart: unless-stopped

启动：

docker compose up -d

Docker 部署下默认只能使用浏览器播放器（较为简陋且依赖服务端转码），如果需要使用 MPV，参考 Client 模式说明。添加目录时直接填写宿主机路径，例如 /mnt/disk1/videos，程序会自动映射到容器内可访问路径。

浏览器访问地址：http://localhost:8655，非 docker 方式启动后，程序会自动打开浏览器。
Docker 部署默认支持局域网设备访问，将 localhost 改为部署主机的局域网ip。
非 Docker 部署请在设置中手动开启局域网访问，然后重启软件。
默认登录密码为 admin，可在全局设置中修改。

2. 添加本地目录

点击左下角“设置” -> “目录管理”，添加存放视频的本地文件夹。

视频扫描入库、封面截图生成、JAV 刮削会在后台持续运行，刷新页面或点击侧边栏视频、JAV 等选项查看当前进度。

注意事项：

• 能够正常访问外网是获取 JAV 数据的前提。
• JavBoss 只会读取不会主动修改目录里的任何内容，请放心添加。
• 你可以随时关闭应用程序，下次打开所有任务会自动重启。
• JAV 模式下的女优详情、厂商、系列等信息会逐渐补齐，请耐心等待（补齐速度：女优≈厂商>系列）。

目录扫描和 JAV 刮削说明

程序默认会自动持续对目录进行扫描，扫描过程中同步进行 JAV 刮削，相邻两次扫描间隔为1分钟。

可以在 全局设置 -> 目录管理 -> 扫描设置 中修改相邻扫描间隔或关闭自动扫描。也可点击 手动扫描 立刻触发一次目录扫描和 JAV 刮削。

一旦目录内容发生任何变化（比如有新视频入库、旧视频被删除、视频移动等），需要再进行一次目录扫描和 JAV 刮削完成内容的更新同步，请根据个人的扫描设置自行把握扫描时机。

对于通过 Docker 部署在 NAS 中长期运行的用户，建议调大扫描间隔或者关闭自动扫描，避免影响硬盘寿命。

请注意一次扫描并不能保证所有可刮削的视频都被成功刮削，原因是每次扫描过程中每个视频只会尝试一次刮削，可能会因为网络抖动或者网站风控等原因导致部分请求失败，个人实测每次扫描约1%左右的视频会刮削失败，需要再扫描一次。

Chrome 扩展说明

JavBoss 现在还有一个随程序包一起发布的 Chrome 扩展：JavBoss 助手，目前扩展支持以下功能：

• 手动刮削辅助回填：点击视频卡片底部刮削按钮，选择手动刮削，点击跳转到某个 JAV 网站，进入某个影片详情页面后，点击页面右下角按钮可自动提取当前影片信息并回填。
• JavDb 辅助跳转：在 JAV、女优、片商、系列卡片里点击 JavDb 图标都可直接跳转到对应的 JavDb 详情页面，未启用则还是跳转搜索页。

扩展不是必须的，有以上需要的可点击此处下载。

如何升级版本

一键安装用户

先退出正在运行的 JavBoss，然后重新执行一键安装命令即可升级。

手动下载用户

下载并解压新版本后，将旧版本目录中的 data/ 文件夹复制到新版本目录，然后启动新版本。

Docker 用户

进入 docker-compose.yaml 所在目录，拉取新镜像并重启：

docker compose pull
docker compose up -d

注意事项

• JavBoss 是本地媒体库管理工具，不提供任何资源分发、获取、共享等功能。
• JAV 元数据、封面资料首次抓取依赖外部站点可访问性，请确保网络环境通畅。
• 发布包根目录会包含 config.toml 文件，程序默认启动端口为 8655，如有需要可修改其中 port 的值更换启动端口。

Client 模式说明

备注：此模式唯一的用处就是使用本机 MPV 播放器播放局域网 JavBoss 中的视频，没有此项需求的用户可忽略。

Client 模式可连接远程 JavBoss Server，浏览远程媒体库并使用本机 MPV 播放视频，同时支持本地播放器设置及截图自动同步。

使用此模式需要在本地安装 JavBoss，然后在程序目录的 config.toml 中设置远程 JavBoss Server 地址，之后正常启动 JavBoss 即可：

server_url = "http://192.168.1.100:8655"

也可以通过命令行临时指定远程 Server：

• Windows：.\javboss.exe --server-url http://192.168.1.100:8655
• Linux / macOS：./javboss --server-url http://192.168.1.100:8655

Q&A

• Q: 使用时要一直确保外网访问通畅吗？
• A: JavBoss 所有的信息读取来源于 data/ 目录，已经看到的信息都是永远离线可用的。无法访问外网意味着 JavBoss 无法做后续的 JAV 信息的抓取和更新，已入库的信息不受影响。

• Q: 新下载的视频怎么入库？想删除一些视频怎么办？
• A: 直接在目录里面操作，然后需要重新触发一次扫描，参考上方的 目录扫描和 JAV 刮削说明。

• Q: 视频文件夹在移动硬盘里，没插硬盘时启动会丢数据吗？
• A: 不会。目录不可用时，JavBoss 会保留已入库数据；移动硬盘再次接入后，数据会恢复显示。

• Q: 某个移动硬盘不够大了，文件夹要移动到新的硬盘里怎么办？
• A: 直接移动文件夹，然后在“目录管理”里点击编辑更新目录路径，不用担心数据丢失，JavBoss 会处理好这一切。

• Q: 换电脑时怎么迁移？
• A: 在新电脑下载对应系统的 javboss，然后将旧电脑的data/目录复制到新电脑的 javboss 目录下即可。（如果视频目录路径也发生了变化，请在目录管理中点击编辑进行调整）

开发者文档

开发环境、常用命令及项目结构请参阅 DEVELOPMENT.md。

风险提示与免责声明

• 本项目是本人在学习 Go 语言期间开发的练手项目，仅供学习与交流。
• 使用本项目时，请遵守所在国家或地区的法律法规。
• 请勿将本项目用于任何商业用途。
• 用户应自行承担使用本项目产生的一切后果，开发者不对用户的任何使用行为承担法律责任。