使用教程 / 01

安装与部署

在 Windows 电脑、服务器或 NAS 上安装 JavSP WEB，设置影片目录并完成首次登录。

开始使用

Windows 电脑可直接运行 EXE，服务器或 NAS 推荐使用 Docker。安装后先用一个影片目录试刮削，确认资料和输出位置正确，再处理整个媒体库。

01安装与登录

Windows 本机使用 EXE，服务器或 NAS 使用 Docker。

02检查预设

确认分类、数据源、输出路径以及移动/硬链接设置。

03小范围验证

先刮削一个影片目录，核对资料和输出位置，再开启自动化。

首次账号和密码均为 admin。登录后到“系统设置 → 用户管理”修改密码。网页填写的路径必须由运行 JavSP WEB 的那台机器或容器访问，浏览器所在电脑的文件并不会自动上传。

安装前也可以打开交互示例熟悉操作。示例使用演示数据，不会处理你的影片；填写的内容会在刷新后清除，请勿输入真实密码或密钥。

Windows：本机运行与文件选择

从 Releases 下载 JavSP-Web.exe，放入可写入的固定文件夹。
双击运行，程序进入 Windows 通知区域并打开浏览器。若没有自动打开，访问下方地址。
登录后选择“手动刮削”，可选择文件夹、单个视频或批量选择视频文件；多选时使用 Ctrl / Shift。
第一次使用先确认预设中的输出路径与整理方式，避免在未经检查的默认设置下整理整个媒体库。

http://127.0.0.1:8090/login

EXE 的配置和任务数据默认保存在程序旁的 data 目录。关闭浏览器不等于退出程序；通过通知区域菜单退出后再替换 EXE。EXE 可检查新版本，但不能通过网页安装，需下载后手动替换并保留数据目录。

页面打不开时先检查程序是否运行、8090 端口是否被占用。EXE 默认监听本机地址；需要长期供其他设备使用时，建议使用 Docker 部署。

下载 Windows 正式版 ↗

使用 Docker Compose 安装

安装 Docker 与 Compose 插件后，新建工作文件夹，并将以下内容保存为 docker-compose.yml。此配置使用 latest 正式版镜像。

services:
  javsp-web:
    image: apecme/javsp-web:latest
    container_name: javsp-web
    restart: unless-stopped
    ports:
      - "8090:8090"
    environment:
      JAVSP_WEB_HOST: 0.0.0.0
      JAVSP_WEB_PORT: 8090
      JAVSP_WEB_TIMEZONE: Asia/Shanghai
      TZ: Asia/Shanghai
    extra_hosts:
      - "host.docker.internal:host-gateway"
    volumes:
      - ./data:/app/data
      - ./video:/video

把影片放入 ./video，或替换冒号左侧为真实影片目录，例如 /mnt/media:/video。Windows Docker 可使用 D:/Videos:/video。在 Compose 文件所在目录执行：

docker compose config --quiet
docker compose up -d

浏览器打开 http://服务器地址:8090/login。若宿主机 8090 已占用，可将端口映射改成 8091:8090，网页访问 8091；容器端口无需改变。

路径示例宿主机 /mnt/media/待整理 → 容器 /video/待整理。在“待处理路径”和定时规则中填后者。输入和输出目录都应挂载，容器需有相应写入权限。

./data:/app/data 用于保存账号、配置和任务记录，重新创建容器时请保留左侧的 data 文件夹。启动失败可查看 docker compose logs --tail 100 javsp-web。如何更新或切换正式版、体验版，见更新与备份。