telegram-history-dump

Эта утилита является преемником telegram-json-backup, полностью переписанным на Ruby. Она позволяет создавать резервные копии ваших личных и (супер)групповых диалогов Telegram, используя функцию удаленного управления telegram-cli.

По сравнению со старым проектом, telegram-history-dump:

• Улучшена поддержка загрузки медиафайлов
• Поддерживает форматы вывода, отличные от JSON, и расширяется с помощью пользовательских форматов
• Поддерживает инкрементальное резервное копирование (загружаются только новые сообщения)
• Не зависит от нестабильных привязок Python/Lua внутри telegram-cli
• Имеет отдельный конфигурационный файл в формате YAML

Конфигурация по умолчанию создает резервную копию всех диалогов в каталог с именем output в формате JSON, без загрузки каких-либо медиафайлов.

Использование

Первоначальная настройка

1. Скомпилируйте telegram-cli, запустите его один раз, чтобы привязать свою учетную запись Telegram
2. Убедитесь, что в вашей системе установлен Ruby 2+: ruby --version
3. При необходимости настройте процедуру резервного копирования, отредактировав config.yaml

Выполнение резервного копирования

1. Запустите telegram-cli как минимум со следующими параметрами: telegram-cli --json -P 9009
2. Пока telegram-cli работает, выполните скрипт: ruby telegram-history-dump.rb

Форматировщики

История всегда будет сохраняться в файлах, соответствующих формату JSON Lines. Однако дополнительные форматы вывода можно включить, раскомментировав несколько строк в конфигурационном файле.

Вы можете включить один или несколько из следующих модулей форматировщиков:

html создает стилизованные, разбитые на страницы журналы чатов, просматриваемые в веб-браузере.

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

bare выводит только текст фактических сообщений без какого-либо контекста. Предназначен для лингвистического / статистического анализа.

pisg создает ежедневные журналы, совместимые с форматом журналирования IRC EnergyMech, в качестве входа для генератора статистики чатов PISG. См. также telegram-pisg.

Вы также можете реализовать свой собственный форматировщик; подробности см. в formatters/lib/formatter_base.rb.

Параметры командной строки

Большая часть конфигурации резервного копирования осуществляется через конфигурационный файл, но несколько специфических параметров доступны в качестве опций CLI. Ни один из них не является обязательным.

Использование: telegram-history-dump.rb [options]
    -c, --config=cfg.yaml            Путь к файлу конфигурации YAML
    -k, --kill-tg                    Завершить telegram-cli после резервного копирования
    -h, --help                       Показать справку
    -d, --dir=DIR                    Подкаталог для выходных файлов
                                     (относительно backup_dir в конфигурации YAML)
    -l, --limit=LIMIT                Максимальное количество сообщений для резервного копирования
                                     для каждой цели (переопределяет конфигурацию YAML)

Примечания

Примечания по использованию:

• Возможно запускать telegram-cli на другой машине, например, в качестве демона на сервере. В этом случае вы должны передать --accept-any-tcp в telegram-cli и соответствующим образом настроить межсетевой экран на порту, чтобы предотвратить нежелательное раскрытие. Имейте в виду, что некоторые опции, касающиеся медиафайлов, не будут работать в удаленной настройке.
• Будьте осторожны при уменьшении chunk_delay или увеличении chunk_size. Telegram по-видимому, ограничивает запросы истории по скорости. Слишком быстрое выполнение может привести к тайм-ауту операции и заставит скрипт пропустить часть дампа.

Известные проблемы telegram-cli, влияющие на telegram-history-dump:

• vysheng/tg#947 может вызывать сбои при дампе каналов с более чем 100 сообщениями.
• vysheng/tg#904 может вызывать сбои, если диалоги содержат определенные медиафайлы. Если вы столкнулись с этим, перекомпилируйте telegram-cli с предложенным обходным решением.