monolith
monolith — компактный инструмент командной строки на Rust для сохранения веб-страницы в один самодостаточный HTML-файл: CSS, изображения, шрифты и JavaScript встраиваются в документ как data URL. Может также сохранять страницу в формате MHTML. Альтернатива SingleFile для командно й строки и скриптов. Лицензия — CC0-1.0 (общественное достояние).
Сайт: github.com/Y2Z/monolith
Зачем нужен
Когда нужна одна страница без внешних зависимостей — одним файлом, который откроется в браузере без сети. Главные отличия от SingleFile:
- Чистый CLI — без браузерного расширения и без JavaScript-движка.
- Не выполняет JS — сохраняется HTML в том виде, в каком его отдал сервер.
- Быстрый — написан на Rust.
- Один бинарник без зависимостей.
Где незаменим:
- Скрипты и автоматизация — без браузера.
- Серверы без графического интерфейса.
- Быстрые разовые задачи — «сохрани эту страницу одной командой».
Возможности
- Один файл — CSS, изображения, шрифты, JS встраиваются в HTML.
- Формат MHTML (
-m) вместо HTML. - Выборочное удаление: JavaScript (
-j), изображения (-i), CSS (-c), шрифты (-F), фреймы (-f), аудио (-a), видео (-v). - Изоляция документа (
-I) — сохранённая страница не будет обращаться к сети. - Белые и чёрные списки доменов для загрузки ресурсов (
-d,-B). - Свой User-Agent (
-u) и cookies из файла (-C, формат Netscape). - Прокси — через переменные окружения
https_proxy,http_proxy,no_proxy. - Вывод в файл или stdout для пайпов; чтение HTML из stdin.
- Метаданные: по умолчанию в файл добавляется комментарий с исходным URL и временем сохранения (
-Mотключает). - Графический интерфейс — отдельная программа
monolith-gui(собирается с функциейgui).
Когда использовать
✅ Подходит для:
- сохранения одной страницы в скрипте или cron-задаче;
- CI/CD — сохранение отчётов, документации;
- быстрой обработки списка URL в bash-пайплайне.
❌ Не подходит для:
- современных SPA с обязательным JS (React, Vue без SSR) — сохранится пустой каркас; в README предлагается предварительно получить DOM через headless Chromium (см. ниже);
- сайтов с защитой от ботов — monolith не выполняет JavaScript-проверки; обходить защиту нельзя, используйте другие источники копии;
- рекурсивного обхода сайта — monolith сохраняет одну страницу;
- сложных медиа (видеоплееры, интерактивные графики) — сохраняются без интерактивности.
Установка
Через пакетные менеджеры
# macOS / Linux (Homebrew)
brew install monolith
# Arch Linux
sudo pacman -S monolith
# Alpine Linux
apk add monolith
# Snap
snap install monolith
# Nix
nix-env -iA nixpkgs.monolith
# FreeBSD
pkg install monolith
# Windows
winget install --id=Y2Z.Monolith -e
# или
choco install monolith
scoop install main/monolith
Для Debian README предлагает APT-репозиторий pkg.haus (sudo apt install monolith после его подключения).
Cargo
cargo install monolith
Гото вые бинарники
В релизах публикуются бинарники monolith-linux-x86_64, monolith-linux-aarch64, monolith-linux-armhf и monolith.exe:
sudo curl -L -o /usr/local/bin/monolith \
https://github.com/Y2Z/monolith/releases/latest/download/monolith-linux-x86_64
sudo chmod +x /usr/local/bin/monolith
monolith -V
Docker
Готовый образ в README не публикуется — его собирают из репозитория:
git clone https://github.com/Y2Z/monolith.git
cd monolith
docker build -t y2z/monolith .
sudo install -b dist/run-in-container.sh /usr/local/bin/monolith
Команды и параметры сверены с README и
src/main.rsрепозиторияY2Z/monolithверсии 2.11.3 (октябрь 2026).
Использование
Базовая команда
# В файл
monolith https://example.com -o page.html
# В stdout
monolith https://example.com > page.html
# Имя файла из заголовка страницы и времени
monolith https://example.com -o %title%.%timestamp%.html
В формате MHTML
monolith -m https://example.com -o page.mhtml
Удалить JavaScript
monolith -j https://example.com -o page.html
Полезно для очистки от трекеров, экономии места и для страниц, где JS не нужен для отображения содержимого.
Удалить изображения
monolith -i https://example.com -o page.html
Оставить только текст и вёрстку
monolith -j -i -v -a -F https://example.com -o page-text.html
Останутся HTML и встроенный CSS; если убрать и CSS (-c), останется только текст с базовой разметкой.
Cookies
monolith -C cookies.txt https://example.com/private -o page.html
Cookies передаются только файлом в формате Netscape (его можно экспортировать из браузера расширением). Внимание: -c (строчная) — это --no-css, а не cookies.
Для HTTP Basic-авторизации логин и пароль указываются в URL: monolith https://user:[email protected] -o page.html.
User-Agent
monolith -u "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36" \
https://example.com -o page.html
Через прокси
https_proxy=http://127.0.0.1:8080 monolith https://example.com -o page.html
Только ресурсы с указанных доменов
# Загружать ресурсы только с example.com и www.example.com
monolith -I -d example.com -d www.example.com https://example.com -o example-only.html
# Не загружать ресурсы с перечисленных доменов (например, рекламных)
monolith -I -B -d .googleusercontent.com -d googleanalytics.com -d .google.com \
https://example.com -o example-no-ads.html
Страницы, которые строятся JavaScript-ом
monolith не выполняет JavaScript, но может обработать DOM, полученный от headless Chromium (пример из README):
chromium --headless --window-size=1920,1080 --run-all-compositor-stages-before-draw \
--virtual-time-budget=9000 --incognito --dump-dom https://github.com \
| monolith - -I -b https://github.com -o github.html
Обработка списка URL
# urls.txt — один URL на строку
while read -r url; do
filename=$(echo "$url" | sed 's|https\?://||;s|/|_|g').html
monolith "$url" -o "$filename"
done < urls.txt
Вывод в пайп
monolith https://example.com | gzip > page.html.gz
monolith https://example.com | aws s3 cp - s3://my-bucket/page.html
Параметры
Конфигурационного файла нет, всё задаётся флагами. Полный список — monolith --help.
| Флаг | Описание |
|---|---|
-o, --output <file> | Записать в файл (- — в stdout) |
-m, --mhtml | Сохранить в формате MHTML |
-u, --user-agent <ua> | User-Agent |
-C, --cookie-file <file> | Cookies из файла (формат Netscape) |
-t, --timeout <seconds> | Таймаут сетевого запроса (по умолчанию 120 секунд) |
-b, --base-url <url> | Базовый URL для относительных ссылок |
-d, --domain <domain> | Домены для белого (или, с -B, чёрного) списка |
-B, --blacklist-domains | Считать домены из -d чёрным списком |
-I, --isolate | Изолировать документ от сети |
-c, --no-css | Удалить CSS |
-j, --no-js | Удалить JavaScript |
-i, --no-images | Удалить изображения |
-v, --no-video | Удалить видео |
-a, --no-audio | Удалить аудио |
-F, --no-fonts | Удалить веб-шрифты |
-f, --no-frames | Удалить фреймы и iframe |
-n, --unwrap-noscript | Заменить элементы NOSCRIPT их содержимым |
-e, --ignore-errors | Игнорировать сетевые ошибки |
-E, --encoding <charset> | Принудительная кодировка |
-k, --insecure | Принимать недействительные TLS-сертификаты |
-M, --no-metadata | Не добавлять комментарий с URL и временем сохранения |
-D, --create-dirs | Создавать недостающие каталоги в пути вывода |
-q, --quiet | Тихий режим |
-V, --version | Версия |
Сравнение с другими инструментами
| Инструмент | Язык | JS | CLI | Расши рение | Скорость |
|---|---|---|---|---|---|
| monolith | Rust | ❌ | ✅ | ❌ | ⚡ Очень быстро |
| SingleFile | JavaScript | ✅ | ⚠️ | ✅ | 🟡 Средне |
| Obelisk | Go | ❌ | ✅ | ❌ | ⚡ Быстро |
| HTTrack | C | ❌ | ✅ | ❌ (есть GUI) | 🟡 Медленнее (но с рекурсией) |
| MHTML (встроен в Chrome) | — | ✅ | ❌ | ✅ | ⚡ Встроенный |
Когда monolith лучше всех
- Нужен один бинарник без зависимостей.
- Скрипт на сервере без графического интерфейса и без Node.js.
- Нужен минимальный, предсказуемый результат без выполнения JS.
Когда лучше SingleFile
- Страница с обязательным JS (SPA, динамическая загрузка).
- Нужно расширение браузера для интерактивной работы.
- Нужно точное соответствие тому, что видит пользователь.
Когда лучше Obelisk
- Нужен Go в стеке (единый язык).
- Нужна библиотека для встраивания в собственный код.
Best practices
1. Удаляйте JS для долгосрочного хранения
monolith -j https://example.com -o archive/page.html
JavaScript — главный источник нестабильности сохранённых страниц: скрипты обращаются к внешним API и CDN, которые со временем перестают работать.
2. Если нужен WARC — используйте другие инструменты
monolith создаёт HTML или MHTML, а не WARC. Если нужен WARC той же страницы, сохраните её через Wget (--warc-file) или Browsertrix Crawler; в Python запрос и ответ в WARC записывает библиотека warcio.
3. Указывайте осмысленный User-Agent
monolith -u "Mozilla/5.0 (compatible; MyArchiveBot/1.0; +https://example.org/contact)" URL
4. Настройте таймаут
monolith -t 30 URL -o page.html
По умолчанию таймаут на каждый ресурс — 120 секунд; для массовых задач его разумно уменьшить.
5. Для массовых выгрузок — параллелизм
# 4 параллельных процесса
cat urls.txt | xargs -P 4 -I {} \
sh -c 'monolith "$1" -o "out/$(echo "$1" | tr / _).html"' _ {}
Не увеличивайте параллелизм без необходимости, чтобы не перегружать сайт.
6. Проверяйте результат
monolith https://example.com -o page.html
test -s page.html && grep -q "<title>" page.html && echo "OK"
Ограничения
- Нет выполнения JavaScript — современные SPA сохранятся пустыми.
- Нет рекурсивного обхода — одна страница за раз.
- Нет браузерной авторизации — cookies передаются вручную через файл.
- Большие страницы (несколько МБ ресурсов) занимают много памяти.
- Бинарные ресурсы (видео, аудио) встраиваются как base64 — файл сильно растёт.
- Не пишет WARC.
Ресурсы
- GitHub: monolith — исходный код и README.
- Releases — готовые бинарники.
- monolith на crates.io — пакет Rust.
Связанные материалы
- SingleFile — для страниц с обязательным JS.
- Obelisk — альтернатива на Go.
- WebScrapBook — для коллекций со структурой.
- Wget — для рекурсивного обхода сайтов.
- Пользовательские workflow — monolith в скриптах.
- Экстренная архивация — быст рый захват одной страницы.
- Формат MHTML — альтернативный формат одной страницы.