Перейти к основному содержимому
Reincubate

Работа с устройствами iOS и резервными копиями из командной строки

Опубликовано 18 июля 2019 г.· Обновлено 3 февраля 2023 г.

Cover image for: Работа с устройствами iOS и резервными копиями из командной строки

В iPhone Backup Extractor есть инструмент командной строки rictl для работы с резервными копиями и устройствами iOS. rictl работает на любой платформе, на которой работает iPhone Backup Extractor, и, как любой инструмент командной строки в стиле UNIX, следует привычному синтаксису аргументов и справки и кодам возврата оболочки.

Основные возможности:

  • Формат, совместимый с UNIX (коды возврата оболочки $?, даты в формате текущей локали, вывод, удобный для awk, потоки экспортируемых данных stdout)
  • Поддержка нескольких путей поиска одновременно
  • Поддержка всех форматов зашифрованных резервных копий
  • Поддержка относительных путей и путей от домашней папки (~)
rictl в Терминале macOS

rictl в Терминале macOS

rictl в командной строке Windows

rictl в командной строке Windows

Быстрый старт: извлечение файлов баз данных из резервной копии iOS

Найдите резервные копии, доступные в локальной системе:

$ rictl backup search
00000000-0000000000000000 02/07/2019 11:33:41 12.3.1 iPhone11,6 ok

Извлеките из резервной копии все файлы баз данных (обратите внимание на формат регулярного выражения):

$ rictl backup extract -u 00000000-0000000000000000 -r "\.db"
Extracting HomeDomain/Library/Voicemail/voicemail.db
Extracting HomeDomain/Library/Safari/Bookmarks.db
Extracting RootDomain/Library/Caches/locationd/consolidated.db
Extracting WirelessDomain/Library/CallHistory/call_history.db
...

Справочник команд

Получение справки

Справку по rictl можно получить привычным способом, с помощью команды rictl help:

$ rictl help
Usage: rictl <command> [args]

Available commands:
   backup   Work with a local backup
   device   Work with devices over USB and Wi-Fi

Use 'rictl help <command>' for detailed help on a particular command

rictl поддерживает режим backup для работы с локальными резервными копиями и режим device для работы с устройствами iOS по USB или Wi-Fi.

Работа с локальными резервными копиями

$ rictl help backup
Usage: rictl backup <command> [args]
Work with local backups

Available commands:
  search   Search for local backups
  info     Show info about a backup
  list     List files in a backup
  extract  Extract files from a backup
  export   Export data from a backup

Use 'rictl help backup <command>' for detailed help on a particular backup command

При работе с резервными копиями доступны пять параметров: search, info, list, extract и export.

$ rictl help backup search
Usage: rictl backup search [args]
Search for local backups

Available arguments:
  -s, --search-path=VALUE    path to search for backups (two directories deep)
  -l                         include full path in listing output
  -h, --help                 show this message and exit

В простейшем случае search покажет резервные копии в вашей системе:

$ rictl backup search
00000000-0000000000000000 02/07/2019 11:33:41 12.3.1 iPhone11,6 ok

Поля в выводе разделены пробелами. Вот они:

Параметр -l показывает пути к резервным копиям

С помощью -l можно добавить в вывод ещё одно поле — путь к резервной копии:

$ rictl backup search -l
00000000-0000000000000000 02/07/2019 11:33:41 12.3.1 iPhone11,6 ok /Users/afit/Library/Application Support/MobileSync/Backup/00000000-0000000000000000
Параметр -s ищет в дополнительных папках

С помощью -s можно добавить дополнительные пути для поиска резервных копий.

$ rictl backup search -s /Users/afit/Google\ Drive\ File\ Stream/My\ Drive/My\ backups/  -s Downloads/
00000000-0000000000000000                02/07/2019 11:33:41 12.3.1 iPhone11,6 ok
DB72CB76A00CB81675F19907D4AC2B298628D83C 09/06/2014 13:57:08 7.1.1  iPhone6,2 ok
DB72CB76A00CB81675F19907D4AC2B298628D83C 23/07/2014 12:37:55 8.0    iPhone6,2 ok
DB72CB76A00CB81675F19907D4AC2B298628D83C 28/07/2014 12:43:56 8.0    iPhone6,2 ok
CDBF062964613D325EB9E41AD83E85EA16B7E399 10/02/2014 14:29:59 7.0.4  iPad4,1   ok
57BE3B9E8087809F53666B887B9DD81B06299078 29/07/2014 14:18:54 7.1    iPhone3,1 ok
F60040E968F533434B9B6CCA10C7E0C673B7CC13 07/10/2014 09:44:17 8.0.2  iPhone7,2 ok
CC5D2A27218BD9E4A14B1E59918171A8676EF5BB 26/03/2015 11:07:42 2.2.1  iPhone1,1 ok
46A663D1A1A5C5146476A2C6164EA5F5FE771294 26/03/2015 11:09:54 4.2.1  iPhone1,2 ok
9F8FDEEFFCDA4BD53CA4D6F8229A04497CA5FA4C 31/10/2016 17:05:36 10.1.1 iPhone9,4 ok
  • Как обычно, пробелы в путях можно заключать в кавычки ("My folder") или экранировать (My\ folder)
  • -s позволяет указать папку резервной копии или папку, содержащую резервные копии

Получение сведений и метаданных из локальных резервных копий iOS с помощью info

$ rictl help backup info
Usage: rictl backup info [args]
Show info about a backup

Available arguments:
  -u, --udid=VALUE           backup UDID
  -s, --search-path=VALUE    path to search for backups (two directories deep)
  -h, --help                 show this message and exit

Давайте попробуем:

$ rictl backup info -u 00000000-0000000000000000
UDID: 00000000-0000000000000000
Path: /Users/afit/Library/Application Support/MobileSync/Backup/00000000-0000000000000000
Backup in progress: False
Device name: Aidan's iPhone
Backup display name: Aidan's iPhone
Backup date: 02/07/2019 11:33:41
Backup size: 104258399691 bytes
Backup encrypted: True
Product version: 12.3.1
Product type: iPhone11,6
Serial number: FK1XH•••KPH6
Phone Number: +44 •••• ••••••
ICCID: 894411••••••••••••5
MEID: 35728209••••••

Конечно, хотя UDID устройства iOS уникален, на вашем компьютере может быть несколько его резервных копий (например, архивная копия), как здесь:

$ rictl backup search -l | grep B919
DB72CB76A00CB81675F19907D4AC2B298628D83C 09/06/2014 13:57:08 7.1.1 iPhone6,2 ok /Users/afit/Library/Application Support/MobileSync/Backup/backup1
DB72CB76A00CB81675F19907D4AC2B298628D83C 23/07/2014 12:37:55 8.0   iPhone6,2 ok /Users/afit/Library/Application Support/MobileSync/Backup/backup2
DB72CB76A00CB81675F19907D4AC2B298628D83C 28/07/2014 12:43:56 8.0   iPhone6,2 ok /Users/afit/Library/Application Support/MobileSync/Backup/backup3

$ rictl backup info -u DB72CB76A00CB81675F19907D4AC2B298628D83C
Multiple backups found with UDID DB72CB76A00CB81675F19907D4AC2B298628D83C. Use the '--search-path' option to specify the backup's location. This can be shown with the '-l' argument on 'rictl backup search'.

Как быть? Сузьте путь поиска: укажите папку самой резервной копии, а не папку, содержащую папку резервной копии!

$ rictl backup info -s /Users/afit/Library/Application Support/MobileSync/Backup/backup3 -u DB72CB76A00CB81675F19907D4AC2B298628D83C
UDID: DB72CB76A00CB81675F19907D4AC2B298628D83C
Path: /Users/afit/Library/Application Support/MobileSync/Backup/backup3
Backup in progress: False
Device name: Aidan's iPhone
Backup display name: Aidan's iPhone
Backup date: 28/07/2014 12:43:56
Backup size: 239001214 bytes
Product version: 8.0
Product type: iPhone6,2
Serial number: C7KNG•••G5MV
Phone Number: +44 •••• ••••••
ICCID: 894411••••••••••••5
MEID: 35728209••••••

Список файлов в резервной копии iOS с помощью list

$ rictl help backup list
Usage: rictl backup list [args]
List files in a backup

Available arguments:
  -u, --udid=VALUE           backup UIUD
  -s, --search-path=VALUE    path to search for backups (two directories deep)
  -p, --password=VALUE       backup password
  -l                         use a long listing format
  -r, --pattern=VALUE        file pattern (regex)
      --allow-in-progress    allow use of in-progress backups
  -h, --help                 show this message and exit

Давайте попробуем:

$ rictl backup list -u 00000000-0000000000000000 -r plist$ -l
rw-r--r-- 321   24/06/2019 13:04:37 ManagedPreferencesDomain\mobile\.GlobalPreferences.plist
rw------- 16975 21/06/2019 14:52:54 AppDomainPlugin-com.apple.stocks.widget\Library\Preferences\com.apple.stocks.widget.plist
rw-r--r-- 219   01/07/2019 09:37:24 HomeDomain\Library\UserNotifications\A4CCFF5B-F963-425F-8068-729972F77C67\DeliveredNotifications.plist
...

Извлечение файлов из резервной копии iOS с помощью extract

$ rictl help backup extract
Usage: rictl backup extract [args]
Extract files from a backup

Available arguments:
  -u, --udid=VALUE           backup UIUD
  -s, --search-path=VALUE    path to search for backups (two directories deep)
  -p, --password=VALUE       backup password
  -o, --output-path=VALUE    path to extract files to
  -r, --pattern=VALUE        file pattern (regex)
      --allow-in-progress    allow use of in-progress backups
  -h, --help                 show this message and exit

Давайте извлечём все файлы .db из резервной копии в папку Extracted, указав пароль резервной копии password:

$ rictl backup extract -u 00000000-0000000000000000 -r "\.db" -o "Extracted" -p "password"
Extracting HomeDomain/Library/Voicemail/voicemail.db
Extracting HomeDomain/Library/Safari/Bookmarks.db
Extracting RootDomain/Library/Caches/locationd/consolidated.db
Extracting WirelessDomain/Library/CallHistory/call_history.db
...

Экспорт данных из резервной копии iOS с помощью export

$ rictl help backup export
Usage: rictl backup export [args]
Export data from a backup

Available arguments:
  -u, --udid=VALUE           backup UIUD
  -s, --search-path=VALUE    path to search for backups (two directories deep)
  -p, --password=VALUE       backup password
  -t, --type=VALUE           data type (messages, whatsapp, viber, kik, wechat,
                               line, hike, tinder, photos, videos, recordings,
                               contacts, calendar, notes, calls, locations,
                               voicemail)
  -o, --output-path=VALUE    associated file output path
  -r, --pattern=VALUE        search pattern (regex)
  -f, --force                allow overwriting exising files
      --allow-in-progress    allow use of in-progress backups
  -h, --help                 show this message and exit

Экспортируемые данные предоставляются в том же формате JSON, который использует ricloud API; эти форматы описаны здесь.

Давайте извлечём из резервной копии все данные сообщений. Эти данные будут выведены в стандартный поток вывода консоли (stdout), поэтому мы перенаправим их в файл messages.json. Связанные файлы мы сохраним в папку Associated files, указав пароль резервной копии password:

$ rictl backup export -u 00000000-0000000000000000 -t messages -o "Associated files" -p "password" > messages.json
...

$ cat messages.json
[
  {
    "From": "789789",
    "To": "Me",
    "Date": "2012-12-17T14:12:30Z",
    "Deleted": false,
    "Message": "All done! You're now on our Big Data Texts Tariff. We switched you over on 17/12/12",
    "Attachments": []
  },
  {
    "From": "789789",
    "To": "Me",
    "Date": "2012-12-17T18:12:50Z",
    "Deleted": false,
    "Message": "You have 300 Texts and Unlimited data",
    "Attachments": []
  },
...

Работа с устройствами

$ rictl help device
Usage: rictl device <command> [args]
Work with devices over USB and Wi-Fi

Available commands:
  search    Show connected devices over USB and Wi-Fi
  backup    Backup a connected device
  restart   Restart a connected device
  shutdown  Shutdown a connected device

Use 'rictl help device <command>' for detailed help on a particular device command

При работе с устройствами доступны четыре параметра: search, backup, restart и shutdown.

Добавление rictl в переменную path

iPhone Backup Extractor может автоматически добавить rictl в переменную path на компьютере с Windows или macOS на вкладке Preferences, чтобы инструментом было удобно пользоваться в любом терминале на вашем компьютере.

Вкладка настроек «Скрипты» в iPhone Backup Extractor

Вкладка настроек «Скрипты» в iPhone Backup Extractor

Однако путь можно задать и самостоятельно или воспользоваться командой alias. Функциональность rictl доступна через исполняемый файл iPhone Backup Extractor, как показывает скрипт-обёртка:

$ cat `which rictl`
#!/bin/bash
/Applications/iPhone\ Backup\ Extractor.app/Contents/MacOS/iPhoneBackupExtractor cli "$@"

Типовые шаблоны регулярных выражений для поиска файлов

  • Поиск путей, оканчивающихся на текст plist: -r plist$
  • Поиск путей с расширением файла .db: -r \.db

Использование в организациях

Возможности rictl в целом повторяют возможности iPhone Backup Extractor: инструмент позволяет без ограничений изучать резервные копии, но при каждом запуске извлекает не более четырёх файлов или экспортирует не более четырёх элементов данных.

Нам интересно узнавать, как применяется эта технология, и мы поддерживаем ряд компаний, которые создали на её основе собственные инструменты или продукты для внутреннего управления и контроля соответствия. Если это может быть полезно и вам, свяжитесь с нами.

Похожие статьи

Нужна помощь?

Мы стараемся отвечать на все сообщения в течение одного рабочего дня.

support@reincubate.com
Помощь