JavBoss

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

为什么选择 JavBoss？

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

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

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

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

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

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

• 接入 CloudDrive2 api，配合自带的 Chrome 扩展可实现任意网站点击磁力链接直接下载到本地。

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

• 简单直观的 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
    network_mode: host
    command: ["./javboss", "-port", "8655"]
    environment:
      JAVBOSS_PROXY_HOST_GATEWAY: "0"
    volumes:
      - ./data:/app/data
      - /:/host
    restart: unless-stopped

v2.1.0 版本此 yaml 文件有所变化，老用户请即时更新

启动：

docker compose up -d

添加目录时直接填写宿主机路径，例如 /mnt/disk1/videos，程序会自动映射到容器内可访问路径。

Docker 部署下默认只能使用浏览器播放器（维护力度较弱只保证基本可用性），可参考Client 模式以使用 MPV 播放器获得更好的播放体验。

浏览器访问地址：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”，即可自动提取影片信息，返回 JavBoss 检查并保存。
• JavDB 辅助跳转：在各个卡片中点击 JavDB 图标，可直接跳转到对应详情页。此功能默认开启，关闭后跳转到搜索页。
• 显示已拥有状态：在外部网站的影片列表和详情页标记“已拥有”，此功能默认开启，可在扩展中关闭。
• 磁力下载：开启扩展中的“启用磁力下载”后，在任意网页点击磁力链接，确认即可提交到 JavBoss 下载队列，通过 CloudDrive2 创建云端离线任务并下载到本地。使用前需在 JavBoss 的“下载”→“下载设置”中配置 CloudDrive2 和本地下载目录。

连接设置：显示已拥有状态和磁力下载需要先连接 JavBoss：

1. 在 JavBoss 的“全局设置”→“安全”→“浏览器扩展 API 令牌”中新建令牌并复制。
2. 点击浏览器工具栏中的“JavBoss 助手”，在“连接设置”中填写 JavBoss 访问地址和 API 令牌，点击“测试连接”确认可用。
3. 按需开启功能，设置修改后自动保存。

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

如何升级版本

一键安装用户

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

手动下载用户

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

Docker 用户

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

docker compose pull
docker compose up -d

Client 模式

备注：此模式的目的是让用户在远程访问 JavBoss 时，可以使用本地的 MPV 播放器（比如 JavBoss 通过 docker 部署在 NAS 中，在某个局域网 PC 里访问）。

Client 模式可以让本机的 JavBoss 充当远程 JavBoss 的反向代理，浏览远程媒体库并使用本机 MPV 播放视频，同时支持本地播放器设置及截图自动同步。

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

server_url = "http://192.168.1.100:8655"

也可以通过加上命令行临时参数 --server-url http://192.168.1.100:8655 启动。

Q&A

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

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

• Q: 目录整理或者文件重命名之后重新扫描，会导致视频卡片的标签和播放次数等信息丢失吗？
• A: 不会，这些信息是绑定的视频文件唯一指纹，只要还是同一个文件就不会丢失。

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

• Q: 怎么修改启动端口？
• A: 找到程序目录里的 config.toml 文件，修改其中 port 的值更换启动端口。

开发者文档

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

风险提示与免责声明

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