Linux wget 命令:下载文件、指定路径与安全续传

wget 是从 HTTP、HTTPS、FTP 等 URL 下载文件的 GNU 工具,适合在终端保存资源及在条件允许时续传。下载前先确认本地保存位置;使用 -O 或 -c 时,还应分别检查覆盖风险和远程文件是否保持不变。

本文介绍 GNU Wget 的常见用法。BusyBox wget、Wget2 和其他同名实现的选项、默认行为可能不同,应先检查 wget --version、wget --help 与本机 man wget,不要仅凭命令名称套用参数。

基本语法与准备

wget [options] URL

这是说明性语法,options 与 URL 应换成实际参数。先准备独立下载目录,检查剩余空间和写入权限,再执行具体命令。URL 中若含 & 等 shell 特殊字符,应适当引用,避免被 shell 拆成其他操作。

普通下载通常以 URL 对应的名称保存到当前目录;URL 以斜杠结尾时,GNU Wget 常用 index.html。默认并不等于服务器可以任意通过 Content-Disposition 决定名称,该行为有单独选项。需要确定文件名时,应明确指定 -O 并先检查目标路径。

单文件、指定名称与续传

下载一个 URL。

wget https://example.com/

这通常取得示例站点的页面文件,不是把整个网站同步到本地。实际保存名称要看 URL、响应与配置;不带 -N、-nc、-r、-p 的常见重复下载会保留旧文件,并给新文件添加 .1、.2 等后缀,不能把这种行为推广到所有选项组合。

明确输出文件。

wget -O example.html https://example.com/

大写 -O 指向下载内容的输出文件,不只是替换远程名称那么简单:GNU Wget 会立即截断该文件,所以即使下载随后失败,原有内容也可能已丢失。先确认文件不存在或已另行备份,不要对重要资料直接重试该命令。

小写 -o 保存的是日志,含义不同。-O 若搭配多个 URL 或递归请求,内容还可能汇总到同一个文件,而不是为每个资源分别命名,因此不要把 -O 当作批量下载的目录选项。

尝试继续先前下载。

wget -c https://example.com/archive.tar.gz

archive.tar.gz 是说明性路径,不保证在 example.com 存在。实际应换成官方提供的稳定文件 URL,并在保存部分文件的同一目录执行。-c 把现有文件视作远程文件的有效前缀,从本地长度处请求剩余内容,并不验证已下载部分是否一致。

若远程文件变大是因为原内容被修改,而不是单纯追加,续传可能把新旧内容拼成损坏文件。服务器不支持续传时,GNU Wget 可能从头重新下载并覆盖;远程文件与本地等长或更小时,也不能把“没有继续下载”当成内容验证成功。可保留旧文件,再换一个新路径重新完整下载并校验。

下载后检查退出码、内容与完整性

下面的两条命令分别下载文件和查看本地名称、大小:

wget -O example.html https://example.com
ls -lh example.html

ls 的结果仅说明本地文件及其大小,不能证明前一条 wget 成功,也不能证明它是预期页面。两行依次运行时,第二条命令的退出状态会取代前一条;脚本应在 wget 返回后立即检查退出码,成功后再执行文件检查。

GNU Wget 的退出状态 0 表示未报告问题,网络错误常为 4,证书验证失败为 5,服务器错误响应为 8;多种错误同时出现时还有优先级规则。不要把 curl 默认遇到 404 仍可能退出 0 的规则直接套到 wget,可参考 curl 的状态与退出码区别作对照。

即使传输退出 0,下载到的也可能是登录页或业务错误页面。检查内容类型、预期格式和大小范围;发行文件还应按发布者说明核对 SHA-256 等摘要或数字签名。摘要必须来自可信来源,不能从同一不明下载地址取一个值就当作真实性证明。

进度与诊断通常写到标准错误;-q 会关闭消息,不只是少显示进度。自动化中仍要记录退出状态,若需要较简洁但保留基本错误信息,可按本机手册考虑 -nv,而不是靠“没有输出”判断成功。

主要选项与保存规则

选项 作用与限制
-O file 把下载内容写入指定文件,可能立即截断旧内容。
-P directory 指定保存目录前缀,与文件内容输出选项不同。
-c 尝试续传已有部分文件,不验证本地前缀或远程内容未变。
-q 关闭消息输出,仍须单独检查退出状态。
--spider 检查资源是否可访问,不把页面作为普通下载文件保存。
-r 递归获取链接资源,先确定允许的范围和请求量。

--spider 仍会发网络请求,并不意味着完全没有传输、完全不读响应或可以代替完整文件校验。若服务器对检查请求与正常 GET 有不同处理,应结合实际下载方式确认,避免把方法限制误判为资源不存在。

例如 wget -P downloads https://example.com/ 指定目录前缀;它与 -O 的组合效果不能简单理解为给输出文件自动加上 -P。新手宜分别选择目录保存或明确文件路径,并核对本机手册中的组合限制。

范围、重试与安全检查

  1. 从可信来源取得准确 URL,确认下载许可、文件版本与目标目录。先下载单个资源,避免直接添加 -r 扩大请求范围。
  2. 检查已有文件;使用 -O 前防止截断重要内容,使用 -c 前确认文件来源与版本。需要重新下载时保留旧副本,选择新的保存位置。
  3. 记录退出码和诊断,完成后检查文件格式及可信摘要或签名。下载后不要把未确认的脚本直接通过管道交给 shell。
  4. 长时间等待时,可按 Ctrl+C 停止,再按本机支持项设置 --tries 和 --timeout。停止后文件可能不完整,重试前仍要检查续传条件。

--timeout 涉及 DNS、连接和读写等待,读超时主要针对空闲间隔,不是整次下载的总秒数;重试还会增加总耗时。不要为解决证书问题直接关闭证书验证,也不要把账号、令牌或带凭证的 URL 写入公开命令和日志。

常见问题

wget -c 总能安全续传吗?

不能。服务器是否支持续传、远程内容是否改变、现有文件是否确为有效前缀都会影响结果。等长也不证明内容相同,完成后仍应按可信来源校验;条件不明时保留旧文件并重新完整下载。

手册与实现依据

GNU Wget 随附手册的 man7 在线副本说明 -O、-c、目录、消息、检查与退出状态。不同版本与其他同名实现可能不同,具体运行应以本机手册及配置为准。