下载文件
从网络下载较小的、可公开访问的文件。不要用来下大文件。需要自定义方法、请求体或拿响应头时,用 HTTP请求。
当前模块定义
sys:download输入 11 · 输出 5
输入参数
- 网址
urlText必填要下载的文件网址
- 保存文件夹
savePathText必填下载文件的保存位置(文件夹的路径)
- 保存文件名
saveNameText必填可选。为空时自动判断文件名。
- UserAgent
uaText可选可选。
- 请求头
headerText可选发送的HttpHeader。每行一个header,格式为Name:Value
- Cookie
cookieText可选请求的cookie内容
- 超时秒数
expireSecondsNumber可选长时间未接收到数据时,中止下载。
- 显示进度条
showProgressBoolean可选是否显示下载进度条
- 忽略HTTPS证书验证
skipCertVerifyBoolean可选 - 如果文件已存在,自动重命名下载的文件
autoRenameBoolean可选在文件名后面增加"_序号"避免重复。否则将会覆盖已有文件。
- 失败后停止
stopIfFailBoolean可选失败后是否停止动作
输出参数
- 是否成功
isSuccessBoolean是否成功下载了文件
- 文件路径
savedPathText文件的完整保存路径
- 内容MD5
contentMd5Text内容MD5值,不是所有请求都会返回此内容。
- 下载大小
downloadSizeText下载文件的大小(字节数)
- ETag
eTagText响应头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
Cookie
- 方法 1:用下面的动作复制当前网页 Cookie。
- 方法 2:按下面步骤从开发者工具里复制。
复制当前网页Cookie
运行子程序
写入剪贴板自动(纯文本或图片) => 剪贴板
请求头

- F12 打开开发者工具,切到 Network(网络)。
- 勾选 Preserve log(保留日志)。
- F5 或再点一次链接。
- 选状态码 200、类型为 document 的请求。
- 右侧 Headers 里找到 Request Headers,切到 Raw。
- 复制需要的行,删掉多余头,贴进本模块或 HTTP 请求。
限制与排障
只适合小文件。证书报错可临时打开 忽略HTTPS证书验证。需要登录态时补 Cookie / 请求头。同名文件被覆盖时,打开自动重命名。
相关链接
更新历史
- 1.1.37 开始提供。
- 1.42.23 增加内容 MD5、ETag。
更新于