Что такое открытые source maps?
Source map — файл (.js.map), который связывает минифицированный JavaScript с исходным кодом для отладки. Если он отдаётся публично в продакшене, любой может скачать и прочитать весь ваш фронтенд-код, включая комментарии, внутренние маршруты API, а иногда и секреты.
Как это работает
Сборщики сжимают код в нечитаемые бандлы. Для отладки они также создают карту с исходным содержимым файлов и именами. Если бандл заканчивается комментарием sourceMappingURL и файл карты развёрнут на сервере, посетитель скачает его и одним инструментом восстановит всё дерево вашего проекта. Опасна не только читаемость: комментарии, TODO, флаги функций, админские маршруты, адреса API и случайно попавшие в код ключи найти гораздо проще, чем в минифицированном коде.
// конец app.3f9a.js
//# sourceMappingURL=app.3f9a.js.map
# Next.js: оставьте карты для браузера выключенными (по умолчанию)
// next.config.js
module.exports = { productionBrowserSourceMaps: false };Как понять, что это касается вашего сайта
- Ваши JavaScript-файлы заканчиваются комментарием //# sourceMappingURL=, и адрес .map возвращает файл.
- На вкладке Sources в инструментах разработчика на рабочем сайте видны ваши исходные имена файлов и папок.
- В конфигурации сборки в продакшене включён sourcemap: true или productionBrowserSourceMaps.
- Трекер ошибок настроен загружать карты, но те же файлы ещё и публикуются на сайте.
Как исправить
Отключите source maps для браузера в продакшене: build.sourcemap: false в Vite, devtool: false в webpack (или productionBrowserSourceMaps: false в Next.js).
Если карты нужны для отслеживания ошибок, загружайте их в Sentry или подобный сервис и удаляйте из развёрнутой сборки.
Уберите комментарий sourceMappingURL из публичных бандлов и закройте *.map в nginx или CDN.
Всё равно поищите в исходниках секреты и перевыпустите найденные. Не полагайтесь на скрытность.
Разверните заново и проверьте, что старые адреса .map теперь отвечают 404.
Как ScanAnt это проверяет
Бесплатная быстрая проверка ищет ссылки на source maps в публичных скриптах и проверяет, скачиваются ли файлы карт. Если да, она ещё и ищет в них ключи и секреты, показывает только маски значений и место находки. Она читает файлы, которые сайт и так отдаёт каждому посетителю.
Вопросы и ответы
Являются ли source maps уязвимостью сами по себе?
Это утечка информации. Её оценивают как низкую или среднюю, если внутри нет секретов или скрытых эндпоинтов, но она упрощает поиск настоящих ошибок.
Если код у меня и так открытый, это неважно?
Если код всё равно публичный, карта раскрывает меньше. Ключи и непубличные маршруты по-прежнему важны.
Поможет ли скрыть имя файла карты?
Нет. Адрес указан в бандле, а скрытность — не защита. Просто не разворачивайте этот файл.
Не помешает ли удаление карт отладке?
Карты можно хранить приватно в трекере ошибок. Пользователям и атакующим они не нужны.
Связанные термины
Утечка API-ключа
Секретный ключ попал в публичный код, репозиторий или сборку.
Читать →Content Security Policy (CSP)
Заголовок, ограничивающий, какие скрипты и ресурсы может грузить страница.
Читать →Проверьте свой сайт
Утёкшие ключи Stripe, OpenAI, AWS и паролей баз в публичном JavaScript.
Открыть подходящую проверку →
Узнайте, касается ли это вашего сайта
Бесплатно для любого публичного сайта, без регистрации. Нужна полная или глубокая проверка? Выберите уровень на странице проверки.
Выбрать уровень проверки →