快速开始 ​

v5版本 ​

V5.0以上的版本功能优化：

1. 优化了界面
2. 提供了任务管理功能
3. 支持user-agent自定义
4. 支持自定义转码格式和转码预设
5. 重构了整体代码逻辑，拆分项目。

目前处于测试版本，为了体验新功能可以安装。

由于项目内置了sqlite3, pkg打包无法自动带入.node原生的依赖，导致github actions打包的release存在缺少.node文件的问题。当前正在想办法解决。

必看 ​

建议使用v4.2.1以上的releases版本, 较低版本，config.yml配置可能不兼容

• 更新日志

releases安装 ​

releases 安装只需要在下载对应平台的可执行文件即可：点我下载 ⬇️

注意事项 ​

windows平台不过多解释，直接双击运行即可

linux平台用户下载完毕，首先要给文件授权：chmod +x fffandown-linux, 然后执行即可./ffandown-linux

macos平台用户和linux一样需要授权之后，再执行文件，不多赘述。

docker 安装 ​

终端执行以下命令：

docker run -d -p 8081:8081 -v /home/media:/app/media  -v /Uses/helson/config:/app/config -v /Uses/helson/logs:/app/logs h55205l/ffandown:latest

命令说明 ​

默认启动端口为8081, 对应配置内的port字段

/app/media为容器内下载媒体的目录

/app/config为容器内配置文件目录

/app/logs为容器内日志文件目录，可以根据实际需求是否映射

群晖安装 ​

1. 拉取镜像：h55205l/ffandown

   

2. 新增容器

   网络：可以使用桥接或者直通网络

   端口：本地端口看自己需求内部默认是8081

   

   文件夹映射：媒体文件夹内部/app/media, 内部日志文件夹：/app/logs, 配置文件夹：/app/logs

   

   

配置文件说明 ​

如果没有config.yml配置文件会采用默认配置，并自动创建配置文件（运行目录config文件夹下面）。

• port: 服务监听的端口
• downloadDir: 下载目录，相对于执行文件位置，或者使用绝对路径（在地址前面加载@）
• webhooks: webhook通知地址，可以使用钉钉或者bark之类软件,$TEXT为变量：下载文件的名称（注意变量是纯大写的，仅支持bark）！！！请大家手动修改地址
• webhookType: bark | 'feishu' ｜ 'dingding'
• thread: 是否开启express 多线程服务（默认不开启）
• downloadThread: 是否开启ffmpeg多线程转码
• useFFmpegLib: 是否自动内置ffmpeg，启动服务会自动去下载对应平台的ffmpeg，不启动默认采用本地环境的

常规使用 ​

服务启动成功之后，直接在浏览器打开localhost:8081就可以看到下载页面

Api使用 ​

创建下载任务

接口地址：http://localhost:8081/down

请求方式：post

请求头： Content-Type: application/json

请求参数:

v5.0以下版本v5.0 以上版本

js

{
  name: "videoname",
  url: "http://playertest.longtailvideo.com/adaptive/bipbop/gear4/prog_index.m3u8",
  useragent: "",  // 不支持 
  preset: "", // 不支持 
  outputformat: "", // 不支持 
}

js

{
  name: "videoname",
  url: "http://playertest.longtailvideo.com/adaptive/bipbop/gear4/prog_index.m3u8",
  useragent: "", // 用户代理
  preset: "", // 预设 
  outputformat: "" // 文件格式：'mp4', 'mov', 'flv', 'avi'
}

配置暴力猴插件使用 ​

暴力猴安装 ​

首先确保你已经安装了暴力猴插件, 这里不赘述如何安装 你可以在以下地方获取：

极简插件

Github

---

暴力猴插件安装 ​

目前greasyfork无法上传插件分享，所以需要自行获取脚本手动安装。

---

复制脚本内容 ​

点击这个地址ffandown-violentmonkey-script，然后复制内容

---

创建脚本 ​

点击插件的图标，然后添加+按钮

---

粘贴并保存 ​

粘贴复制的内容，然后修改FFANDOWN_URL参数为你的服务部署地址：http://192.168.31.20:8081

---

使用 ​

配置快捷指令使用 ​

点我下载快捷指令

使用前记得先编辑指令，修改服务器的地址IP和端口