跳到主要内容

下载文件

从网络下载较小的、可公开访问的文件。不要用来下大文件。需要自定义方法、请求体或拿响应头时,用 HTTP请求

当前模块定义

sys:download网络服务Action
风险操作
输入 11 · 输出 5

输入参数

  • 网址urlText必填

    要下载的文件网址

    填写 输入或变量默认 https://
  • 保存文件夹savePathText必填

    下载文件的保存位置(文件夹的路径)

    填写 输入或变量
  • 保存文件名saveNameText必填

    可选。为空时自动判断文件名。

    填写 输入或变量
  • UserAgentuaText可选

    可选。

    填写 固定输入
  • 请求头headerText可选

    发送的HttpHeader。每行一个header,格式为Name:Value

    填写 输入或变量
  • CookiecookieText可选

    请求的cookie内容

    填写 输入或变量
  • 超时秒数expireSecondsNumber可选

    长时间未接收到数据时,中止下载。

    填写 固定输入默认 10
  • 显示进度条showProgressBoolean可选

    是否显示下载进度条

    填写 固定输入默认 false
  • 忽略HTTPS证书验证skipCertVerifyBoolean可选
    填写 固定输入默认 false
  • 如果文件已存在,自动重命名下载的文件autoRenameBoolean可选

    在文件名后面增加"_序号"避免重复。否则将会覆盖已有文件。

    填写 固定输入默认 false
  • 失败后停止stopIfFailBoolean可选

    失败后是否停止动作

    填写 固定输入默认 true

输出参数

  • 是否成功isSuccessBoolean

    是否成功下载了文件

  • 文件路径savedPathText

    文件的完整保存路径

  • 内容MD5contentMd5Text

    内容MD5值,不是所有请求都会返回此内容。

  • 下载大小downloadSizeText

    下载文件的大小(字节数)

  • ETageTagText

    响应头Etag值,不是所有请求都会返回此内容。

概述

下载文件

下载网络文件(请勿用于下载大文件)
网址
https://
要下载的文件网址
保存文件夹
 
下载文件的保存位置(文件夹的路径)
保存文件名
 
可选。为空时自动判断文件名。
UserAgent
 
可选。
请求头
 
发送的HttpHeader。每行一个header,格式为Name:Value
Cookie
 
请求的cookie内容
超时秒数
10
长时间未接收到数据时,中止下载。
是否成功
-- 选择变量 --
是否成功下载了文件
文件路径
-- 选择变量 --
文件的完整保存路径
内容MD5
-- 选择变量 --
内容MD5值,不是所有请求都会返回此内容。
下载大小
-- 选择变量 --
下载文件的大小(字节数)
ETag
-- 选择变量 --
响应头Etag值,不是所有请求都会返回此内容。

参数说明

网址:文件地址。

保存文件夹:保存位置。不填则用系统「下载」文件夹。

保存文件名:不填时按响应文件名或 URL 推断;再不行就用时间生成。已存在时可能覆盖或失败,除非打开自动重命名。

UserAgent:可选。

请求头:通常不用。每行 Name:Value。从浏览器复制后请删掉不必要的头。

Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: zh-CN,zh;q=0.9
Referer: https://example.com/

Cookie:通常不用。例如 name=value; other=value

超时秒数:长时间收不到数据就中止。默认 10

忽略HTTPS证书验证:是否忽略无效证书。默认关闭。

显示进度条:是否显示下载进度。默认关闭。

如果文件已存在,自动重命名下载的文件:在文件名后加 _序号。关掉则会覆盖。

失败后停止:失败是否中止动作。默认开启。

输出

  • 是否成功
  • 文件路径:完整保存路径。
  • 内容MD5:响应 Content-MD5。不是每个服务器都给(1.42.23+)。
  • ETag:响应 ETag,会去掉前后双引号。通常与文件 MD5 一致,但不是每个服务器都给(1.42.23+)。
  • 下载大小:字节数。旧稿未写。

Cookie

  • 方法 1:用下面的动作复制当前网页 Cookie。
  • 方法 2:按下面步骤从开发者工具里复制。
复制当前网页Cookie
运行子程序
写入剪贴板自动(纯文本或图片) => 剪贴板

请求头

  1. F12 打开开发者工具,切到 Network(网络)。
  2. 勾选 Preserve log(保留日志)。
  3. F5 或再点一次链接。
  4. 选状态码 200、类型为 document 的请求。
  5. 右侧 Headers 里找到 Request Headers,切到 Raw。
  6. 复制需要的行,删掉多余头,贴进本模块或 HTTP 请求。

限制与排障

只适合小文件。证书报错可临时打开 忽略HTTPS证书验证。需要登录态时补 Cookie / 请求头。同名文件被覆盖时,打开自动重命名。

相关链接

更新历史

  • 1.1.37 开始提供。
  • 1.42.23 增加内容 MD5、ETag。

更新于