Как использовать curl для загрузки файлов из командной строки Linux

Команда Linux curlможет намного больше, чем просто скачивать файлы. Узнайте, на что curlспособно, и когда вам следует использовать его вместо wget.

curl против wget: в чем разница?

Люди часто испытывают трудности в определении относительных сильных сторон wgetи curlкоманд. Команды действительно имеют некоторое функциональное перекрытие. Каждый из них может извлекать файлы из удаленных мест, но на этом сходство заканчивается.

wgetэто фантастический инструмент для загрузки контента и файлов. Он может загружать файлы, веб-страницы и каталоги. Он содержит интеллектуальные процедуры для перехода по ссылкам на веб-страницах и рекурсивной загрузки контента по всему веб-сайту. Он не имеет себе равных в качестве менеджера загрузки командной строки.

curlудовлетворяет совершенно иную потребность. Да, он может извлекать файлы, но не может рекурсивно перемещаться по веб-сайту в поисках контента для извлечения. На curlсамом деле это позволяет вам взаимодействовать с удаленными системами, отправляя запросы этим системам, а также получая и отображая их ответы вам. Эти ответы вполне могут быть содержимым веб-страницы и файлами, но они также могут содержать данные, предоставленные через веб-службу или API в результате «вопроса», заданного запросом curl.

И curlне ограничивается веб-сайтами. curlподдерживает более 20 протоколов, включая HTTP, HTTPS, SCP, SFTP и FTP. И, возможно, благодаря превосходной обработке каналов Linux curlего легче интегрировать с другими командами и скриптами.

У автора curlесть веб-страница, на которой описаны различия, которые он видит между curlи wget.

Установка curl

Из компьютеров, использованных для исследования этой статьи, curl уже были установлены Fedora 31 и Manjaro 18.1.0 . curlдолжен был быть установлен на Ubuntu 18.04 LTS. В Ubuntu запустите эту команду, чтобы установить его:

sudo apt-get install curl

Версия завитка

В --versionопции делает  curlотчет его версию. В нем также перечислены все поддерживаемые протоколы.

curl --version

Получение веб-страницы

Если мы укажем curlна веб-страницу, она найдет ее для нас.

curl //www.bbc.com

Но его действие по умолчанию - выгрузить его в окно терминала как исходный код.

Осторожно : если вы не говорите, curlчто хотите сохранить что-то в виде файла, он всегда будет выгружать его в окно терминала. Если файл, который он извлекает, является двоичным файлом, результат может быть непредсказуемым. Оболочка может попытаться интерпретировать некоторые байтовые значения в двоичном файле как управляющие символы или escape-последовательности.

Сохранение данных в файл

Скажем curl перенаправить вывод в файл:

curl //www.bbc.com> bbc.html

На этот раз мы не видим полученную информацию, она отправляется нам прямо в файл. Поскольку нет вывода окна терминала для отображения, curlвыводит набор информации о ходе выполнения.

В предыдущем примере этого не было, потому что информация о ходе выполнения была бы разбросана по всему исходному коду веб-страницы, поэтому она curlавтоматически подавлялась.

В этом примере  curlобнаруживает, что вывод перенаправляется в файл и что можно безопасно генерировать информацию о ходе выполнения.

Предоставляемая информация:

  • % Total : общая сумма, которую нужно получить.
  • % Получено : процентное и фактическое значение полученных на данный момент данных.
  • % Xferd : процент и фактическая отправка, если данные загружаются.
  • Средняя скорость загрузки : средняя скорость загрузки.
  • Средняя скорость загрузки : средняя скорость загрузки.
  • Общее время : предполагаемая общая продолжительность передачи.
  • Затраченное время : время, затраченное на данный момент для этой передачи.
  • Оставшееся время : примерное время, оставшееся до завершения передачи.
  • Текущая скорость : текущая скорость передачи для данной передачи.

Поскольку мы перенаправили вывод из curl файла, теперь у нас есть файл с именем «bbc.html».

Двойной щелчок по этому файлу откроет браузер по умолчанию и отобразит полученную веб-страницу.

Обратите внимание, что адрес в адресной строке браузера - это локальный файл на этом компьютере, а не удаленный веб-сайт.

Нам не нужно перенаправлять вывод для создания файла. Мы можем создать файл, используя параметр -o(output) и указав curlсоздать файл. Здесь мы используем -oопцию и указываем имя файла, который мы хотим создать, «bbc.html».

curl -o bbc.html //www.bbc.com

Using a Progress Bar To Monitor Downloads

To have the text-based download information replaced by a simple progress bar, use the -# (progress bar) option.

curl -x -o bbc.html //www.bbc.com

Restarting an Interrupted Download

It is easy to restart a download that has been terminated or interrupted. Let’s start a download of a sizeable file. We’ll use the latest Long Term Support build of Ubuntu 18.04. We’re using the --output option to specify the name of the file we wish to save it into: “ubuntu180403.iso.”

curl --output ubuntu18043.iso //releases.ubuntu.com/18.04.3/ubuntu-18.04.3-desktop-amd64.iso

The download starts and works its way towards completion.

If we forcibly interrupt the download with Ctrl+C , we’re returned to the command prompt, and the download is abandoned.

To restart the download, use the -C (continue at) option. This causes curl to restart the download at a specified point or offset within the target file. If you use a hyphen - as the offset, curl will look at the already downloaded portion of the file and determine the correct offset to use for itself.

curl -C - --output ubuntu18043.iso //releases.ubuntu.com/18.04.3/ubuntu-18.04.3-desktop-amd64.iso

The download is restarted. curl reports the offset at which it is restarting.

Retrieving HTTP headers

With the -I (head) option, you can retrieve the HTTP headers only. This is the same as sending the HTTP HEAD command to a web server.

curl -I www.twitter.com

This command retrieves information only; it does not download any web pages or files.

Downloading Multiple URLs

Using xargs we can download multiple URLs at once. Perhaps we want to download a series of web pages that make up a single article or tutorial.

Copy these URLs to an editor and save it to a file called “urls-to-download.txt.” We can use xargs to treat the content of each line of the text file as a parameter which it will feed to curl, in turn.

//tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-ubuntu#0 //tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-ubuntu#1 //tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-ubuntu#2 //tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-ubuntu#3 //tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-ubuntu#4 //tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-ubuntu#5

This is the command we need to use to have xargs pass these URLs to curl one at a time:

xargs -n 1 curl -O < urls-to-download.txt

Note that this command uses the -O (remote file) output command, which uses an uppercase “O.” This option causes curl to save the retrieved  file with the same name that the file has on the remote server.

The -n 1 option tells xargs to treat each line of the text file as a single parameter.

When you run the command, you’ll see multiple downloads start and finish, one after the other.

Checking in the file browser shows the multiple files have been downloaded. Each one bears the name it had on the remote server.

RELATED:How to Use the xargs Command on Linux

Downloading Files From an FTP Server

Using curl with a File Transfer Protocol (FTP) server is easy, even if you have to authenticate with a username and password. To pass a username and password with curl use the -u (user) option, and type the username, a colon “:”, and the password. Don’t put a space before or after the colon.

This is a free-for-testing FTP server hosted by Rebex. The test FTP site has a pre-set username of “demo”, and the password is “password.” Don’t use this type of weak username and password on a production or “real” FTP server.

curl -u demo:password ftp://test.rebex.net

curl figures out that we’re pointing it at an FTP server, and returns a list of the files that are present on the server.

The only file on this server is a “readme.txt” file, of 403 bytes in length. Let’s retrieve it. Use the same command as a moment ago, with the filename appended to it:

curl -u demo:password ftp://test.rebex.net/readme.txt

The file is retrieved and curl displays its contents in the terminal window.

In almost all cases, it is going to be more convenient to have the retrieved file saved to disk for us, rather than displayed in the terminal window. Once more we can use the -O (remote file) output command to have the file saved to disk, with the same filename that it has on the remote server.

curl -O -u demo:password ftp://test.rebex.net/readme.txt

The file is retrieved and saved to disk. We can use ls to check the file details. It has the same name as the file on the FTP server, and it is the same length, 403 bytes.

ls -hl readme.txt

RELATED:How to Use the FTP Command on Linux

Sending Parameters to Remote Servers

Some remote servers will accept parameters in requests that are sent to them. The parameters might be used to format the returned data, for example, or they may be used to select the exact data that the user wishes to retrieve. It is often possible to interact with web application programming interfaces (APIs) using curl.

As a simple example, the ipify website has an API can be queried to ascertain your external IP address.

curl //api.ipify.org

By adding the format parameter to the command, with the value of “json” we can again request our external IP address, but this time the returned data will be encoded in the JSON format.

curl //api.ipify.org?format=json

Here’s another example that makes use of a Google API. It returns a JSON object describing a book. The parameter you must provide is the International Standard Book Number (ISBN) number of a book. You can find these on the back cover of most books, usually below a barcode. The parameter we’ll use here is “0131103628.”

curl //www.googleapis.com/books/v1/volumes?q=isbn:0131103628

The returned data is comprehensive:

Sometimes curl, Sometimes wget

If I wanted to download content from a website and have the tree-structure of the website searched recursively for that content, I’d use wget.

Если бы я хотел взаимодействовать с удаленным сервером или API и, возможно, загружать некоторые файлы или веб-страницы, я бы использовал curl. Особенно, если протокол был одним из многих, не поддерживаемых wget.