Any3DAny3D
·Any3D Team

Web Worker недоступен? Диагностика по платформе и среде

troubleshootingbrowser-compatibilityweb-worker

Какие симптомы вы видите

Внизу Any3D появляется жёлтое предупреждение: «Текущий браузер не поддерживает Web Worker». Предпросмотр может работать, но обработка больших файлов часто приводит к зависанию страницы, а пути Worker для сжатия текстур и конвертации изображений в модели остаются недоступными.

Web Worker позволяет запускать ресурсоёмкие вычисления в фоновом потоке. Any3D использует набор «Worker + OffscreenCanvas + createImageBitmap» для сжатия текстур и части конвертационных процессов.

Основные причины

ПричинаТипичные ситуации
Незащищённый контекстОткрытие через file://, HTTP-страницы в корпоративной сети (не localhost)
Устаревший браузер / WebViewВстроенные браузеры в старых ОС, страницы внутри приложений
Ограничение CSPКорпоративные порталы в iframe, Zero-Trust клиенты, инжектирующие worker-src
Блокировка расширениямиПлагины конфиденциальности, блокирующие Worker или blob: URL
Аномалии сетевого кэшаПрокси/VPN возвращают неполные скрипты Worker
Управление устройствомУправляемые профили, отключающие фоновые скрипты

Поиск причин по платформам

Windows

  1. Обязательно используйте HTTPS (https://any3d.cc), не открывайте локальные HTML-файлы.
  2. Корпоративная политика Edge: Проверьте Computer Configuration → Administrative Templates → Microsoft Edge на наличие ограничений Worker или сторонних cookie (косвенно влияет на загрузку Worker).
  3. Семейная безопасность Windows: Веб-ограничения в дочерней учётной записи могут помешать созданию Worker.

macOS

  1. Safari / Chrome требуют macOS 12+ и актуальной версии браузера.
  2. Время на экране → Контент и конфиденциальность: Если включены «Ограничение взрослых сайтов» или пользовательские фильтры, они могут случайно заблокировать домены скриптов Worker.
  3. Если корпоративный профиль MDM отключает скриптовые возможности, помимо «межсайтового отслеживания», обратитесь в ИТ-отдел.

Linux

  1. Убедитесь, что URL использует HTTPS; корпоративные прокси Squid должны разрешать запросы blob: и worker-src.

iOS / Android

  1. Не обрабатывайте большие файлы во встроенных браузерах WeChat/DingTalk; используйте системный браузер.
  2. Режим низкого заряда iOS обычно не блокирует Worker, но старый WebKit может не иметь нужных API — обновляйте систему.
  3. Устаревшая версия WebView на Android (системный WebView без обновлений) делает Worker недоступным: обновите «Android System WebView» из Play Store.

Сеть, VPN и корпоративная интранет

СценарийПояснение
Корпоративный VPNНекоторые VPN принудительно расшифровывают HTTPS и инжектируют CSP; необходимо разрешение Worker от ИТ-отдела
SSO-портал интранета в iframeCSP внешней страницы может запрещать worker-src blob:; необходимо отдельная настройка вложенной страницы или открытие Any3D в новой вкладке
Обратный проксиНеправильная настройка Nginx/шлюза может привести к некорректному MIME-типу скрипта Worker
DNS-фильтрация роутерами родительского контроляРедко влияет на Worker, но если сайт переведён на HTTP-зеркало, Worker перестанет работать

Самопроверка: Отключите VPN, переключитесь на мобильный热点 4G/5G, проверьте, исчезло ли предупреждение.

Справочник по корпоративному CSP (для ИТ)

Если Any3D встроен через iframe, рекомендуется разрешить:

worker-src 'self' blob:;
script-src 'self' 'unsafe-eval' blob:;

Обычным пользователям не нужно вручную изменять CSP.

Пошаговое исправление (универсальное)

  1. Убедитесь, что доступ осуществляется по HTTPS, обновите страницу (Ctrl+F5 / Cmd+Shift+R).
  2. Откройте окно в режиме инкогнито, чтобы исключить влияние расширений.
  3. Обновите браузер и (на Android) системный WebView.
  4. Откройте Any3D в новой вкладке, чтобы избежать встраивания в iframe корпоративного портала.

Быстрая самопроверка

typeof Worker !== "undefined"

Возврат true означает только наличие API; Any3D также требует, чтобы OffscreenCanvas и createImageBitmap были полностью доступны для использования полного пути Worker.

Последствия отсутствия Worker

ФункцияВлияние
Сжатие геометрии (Draco и др.)Обычно доступно (главный поток + WASM)
Сжатие текстур (KTX2)Путь Worker недоступен, большие файлы могут вызывать зависания
Конвертация изображений в моделиВозможно ухудшение производительности или понижение качества

Итог

Предупреждения Web Worker чаще всего вызваны незащищённым HTTP, устаревшим WebView, корпоративным CSP/VPN, блокировкой расширениями. Обновите браузер по платформе, проверьте другую сеть и попросите ИТ-отдел проверить iframe/CSP — это обычно восстанавливает фоновую обработку.

Поддержите нас