ScrapeFun

覆盖电影、剧集、漫画与远程资源的综合媒体服务器

最后更新：2026 年 9 月 2 日

ScrapeFun 是覆盖电影、剧集、漫画与远程资源的综合媒体服务器，提供媒体刮削、漫画阅读、WebDAV / AList 管理、字幕处理、播放兼容、多用户权限和桌面客户端连接能力，适合个人、家庭及小规模共享媒体库。

下载与部署

使用场景	下载或文档
Linux / NAS Docker Server	Docker 部署指南
macOS Server	下载 DMG
Windows Server	下载安装程序
Linux Client	下载 deb / rpm
macOS Client	下载 DMG
Windows Client	下载安装程序

使用文档

• Docker 一键部署与更新
• NAS Docker Compose
• 数据持久化与备份
• 自定义 Scraper 开发指南（中文）
• Custom Scraper Development Guide (English)
• 在线使用文档

核心能力

影视刮削与整理

• 支持电影、剧集和资源类自定义 scraper
• 支持清洗规则、刮削器绑定、优先级回退和组合刮削
• 支持海报、背景图、演员、简介和剧集信息管理
• 支持用户安装或编辑自定义刮削器

漫画管理与阅读

• 统一扫描、整理和浏览漫画资源
• 支持网页与桌面客户端阅读
• 保存阅读进度，方便跨设备继续阅读
• 持久化漫画清单，重启服务后无需重新生成

WebDAV 与远程媒体库

• 浏览和管理 WebDAV / AList 目录
• 支持移动、复制、重命名、删除和创建文件夹
• 支持直链解析、代理播放和失败重试
• 支持远程媒体库增量扫描与状态同步

播放与字幕

• 支持字幕搜索、上传、压缩包导入和本地化保存
• 支持电影与剧集播放进度同步
• 提供 Emby / Jellyfin 风格兼容接口
• 可配合 Infuse、Yamby、VidHub、SenPlayer 等播放器使用

用户与权限

• 多用户和管理员角色
• 媒体库级访问权限
• Web 与桌面客户端连接
• 实时状态同步

Linux 一键部署

安装 Docker 后运行：

curl -fsSL https://raw.githubusercontent.com/HaoweiLi97/ScrapeFun/main/scripts/one-click-compose-deploy.sh | bash

脚本会创建部署目录、持久化目录和环境文件，选择 GPU 模式，并启动应用与 updater。

部署完成后访问：

http://服务器IP:8096

安装 beta：

curl -fsSL https://raw.githubusercontent.com/HaoweiLi97/ScrapeFun/main/scripts/one-click-compose-deploy.sh | bash -s -- beta

当前 Docker beta 为 0.3.0-beta.1；haoweil/scrapefun:beta 与 haoweil/scrapefun-updater:beta 会保持为配套版本。升级或恢复前请先阅读数据持久化与备份。

重新运行标准命令即可回到 stable。

GPU 配置

GPU 是部署配置的重要部分。首次安装时请按服务器硬件选择：

模式	适用硬件	容器配置
dri	Intel、大多数 AMD、大多数 NAS 集显	/dev/dri
amd	还需要计算设备的 AMD 主机	/dev/dri 与 /dev/kfd
nvidia	已安装 NVIDIA Container Toolkit 的主机	gpus: all
none	明确不使用硬件加速	不透传 GPU

非交互指定示例：

curl -fsSL https://raw.githubusercontent.com/HaoweiLi97/ScrapeFun/main/scripts/one-click-compose-deploy.sh | \
  SCRAPEFUN_GPU_MODE=nvidia bash

数据持久化

Docker 部署必须把整个 scrapefun-data 根目录挂载到容器的 /app/data：

volumes:
  - ./scrapefun-data:/app/data

不要使用逐个挂载 db、images、config 等子目录的旧配置。更新、重建、备份或恢复前，请阅读Docker 数据持久化、备份与恢复。

常用配置

常用环境变量可参考 .env.example：

• PORT：服务端口，默认 8096
• APP_AUTH_SECRET：生产环境登录令牌密钥
• FLARESOLVERR_URL：部分站点的反爬服务地址
• TMDB_API_KEY：可选 TMDB 数据源
• BANGUMI_API_KEY：可选 Bangumi 数据源
• WEBDAV_URL / WEBDAV_USERNAME / WEBDAV_PASSWORD：可选 WebDAV 默认配置

获取帮助

• 在线文档
• 建议反馈
• Product / Business：lihaowei977@gmail.com