Dropstone Docs

Руководство по устранению неполадок Dropstone - Диагностика и исправление проблем

Комплексное руководство по устранению неполадок Dropstone Desktop. Диагностика проблем с аутентификацией, подключением, производительностью и агентами. Поиск файлов журналов, сброс настроек и получение поддержки.

В этом руководстве представлены систематические подходы к диагностике и решению распространенных проблем с Dropstone.io. Следуйте этим шагам, чтобы собрать необходимую информацию перед обращением в службу поддержки.

Основная информация для устранения неполадок

Следующая информация критически важна для большинства сценариев устранения неполадок в Dropstone:

1. Визуальная документация

Скриншот проблемы (закройте любую конфиденциальную информацию)

  • Захватите все окно приложения с отображаемой ошибкой
  • Включите все сообщения об ошибках или диалоговые окна
  • Убедитесь, что метки времени видны, если это возможно

2. Шаги воспроизведения

Предоставьте подробные шаги для воспроизведения проблемы:

1. Выполненное действие (например, "Нажал кнопку 'Deploy'")
2. Ожидаемое поведение
3. Фактическое поведение
4. Частота (всегда, иногда, один раз)

3. Информация о системе

Получите информацию о системе из:

Dropstone → Help → About

Это включает:

  • Версию Dropstone
  • Операционную систему
  • Архитектуру (x64, arm64)
  • Версию Electron
  • Версию Node.js

4. Конфигурация сети

Используете ли вы что-либо из следующего?

  • VPN (виртуальная частная сеть)
  • Zscaler или другие прокси-серверы безопасности
  • Корпоративный брандмауэр
  • Пользовательские настройки DNS

5. Консоль инструментов разработчика

Откройте инструменты разработчика, чтобы проверить ошибки JavaScript:

Dropstone → Help → Toggle Developer Tools

Перейдите на вкладку Console и проверьте:

  • Красные сообщения об ошибках
  • Предупреждения, связанные с вашей проблемой
  • Сбои сетевых запросов

Скопируйте все соответствующие трассировки стека ошибок.

6. Журналы приложения

Windows

Журналы находятся по адресу:

C:\Users\<ваше-имя-пользователя>\AppData\Roaming\Dropstone\logs

Доступ через палитру команд:

  1. Нажмите Ctrl + Shift + P
  2. Введите и выберите: Developer: Open Logs Folder

macOS

Журналы находятся по адресу:

~/Library/Application Support/Dropstone/logs

Доступ через палитру команд:

  1. Нажмите Cmd + Shift + P
  2. Введите и выберите: Developer: Open Logs Folder

Linux

Журналы находятся по адресу:

~/.config/Dropstone/logs

Просмотр журналов в приложении

Перейдите в: Dropstone → Terminal → Output

Выберите из раскрывающегося списка:

  • Window - Общие журналы приложения
  • Dropstone Core - Журналы основной функциональности
  • Dropstone Deployment - Журналы, связанные с развертыванием
  • Dropstone Storage - Журналы хранилища и базы данных
  • Dropstone API - Журналы запросов/ответов API

Распространенные проблемы и их решения

Проблемы с подключением

Проблема: Невозможно подключиться к сервисам Dropstone

Симптомы:

  • Ошибки "Connection timeout"
  • Сообщения "Unable to reach server"
  • Бесконечные состояния загрузки

Решения:

  1. Проверьте подключение к Интернету

    # Windows
ping dropstone.io

# macOS/Linux
ping dropstone.io

  2. Проверьте настройки брандмауэра

    • Убедитесь, что Dropstone разрешен через ваш брандмауэр
    • Проверьте политики корпоративной сети
    • Добавьте домен *.dropstone.io в белый список

  3. Конфигурация прокси

    Настройте параметры прокси:

    Dropstone → Settings → Network → Proxy Settings

    Или задайте переменные окружения:

    export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080

  4. Разрешение DNS

    • Очистите кэш DNS
    • Попробуйте альтернативный DNS (8.8.8.8, 1.1.1.1)

Проблемы с аутентификацией

Проблема: Сбои входа или истечение срока действия токена

Симптомы:

  • Ошибки "Authentication failed"
  • Повторные запросы на вход
  • Ответы 401 Unauthorized

Решения:

  1. Очистите кэш аутентификации

    Dropstone → Command Palette → Clear Authentication Cache

  2. Повторная аутентификация

    1. Выйдите из Dropstone
2. Очистите файлы cookie браузера для dropstone.io
3. Войдите снова

  3. Проверьте действительность токена

    Перейдите в: Settings → Account → Session Management

    Просмотрите активные сеансы и отзовите подозрительные.

  4. Проблемы с SSO

    При использовании единого входа (SSO):

    • Убедитесь, что поставщик SSO доступен
    • Проверьте срок действия утверждений SAML
    • Свяжитесь с администратором вашего поставщика удостоверений

Проблемы с производительностью

Проблема: Медленный отклик приложения или высокая загрузка ЦП

Симптомы:

  • Задержка при вводе текста или щелчках
  • Высокая загрузка ЦП/памяти
  • Зависший или не отвечающий интерфейс

Решения:

  1. Проверьте использование ресурсов

    Dropstone → Help → Process Manager

    Определите процессы, потребляющие чрезмерные ресурсы.

  2. Отключите расширения

    Временно отключите расширения, чтобы изолировать проблему:

    Settings → Extensions → Отключить все → Перезапустить

  3. Очистите кэш

    Dropstone → Settings → Advanced → Clear Cache

  4. Уменьшите размер проекта

    • Исключите большие файлы из индексации
    • Добавьте в файл .dpsignore:
    node_modules/
dist/
build/
*.log
.git/

  5. Аппаратное ускорение

    Переключите ускорение GPU:

    Settings → System → Use Hardware Acceleration

Проблемы с развертыванием

Проблема: Неудачные развертывания

Симптомы:

  • Сбои сборки
  • Тайм-ауты развертывания
  • Ошибки "Unable to push to remote"

Решения:

  1. Проверьте журналы сборки

    Просмотрите подробный вывод сборки:

    Deployment → History → Выберите неудачное развертывание → View Logs

  2. Проверьте переменные окружения

    Settings → Deployment → Environment Variables

    Убедитесь, что все необходимые переменные заданы.

  3. Проверьте конфигурацию развертывания

    Проверьте ваш dropstone.config.js:

    module.exports = {
  build: {
    command: 'npm run build',
    output: 'dist'
  },
  deployment: {
    region: 'us-east-1',
    runtime: 'nodejs18.x'
  }
}

  4. Квота хранилища

    Убедитесь, что вы не превысили лимиты хранилища:

    Dashboard → Usage → Storage

  5. Тайм-аут сборки

    Увеличьте тайм-аут в конфигурации:

    deployment: {
  timeout: 900 // 15 минут в секундах
}

Проблемы с хранилищем и базой данных

Проблема: Ошибки синхронизации данных или хранилища

Симптомы:

  • "Storage quota exceeded"
  • Конфликты синхронизации
  • Данные не сохраняются

Решения:

  1. Проверьте использование хранилища

    Dashboard → Storage → Usage Statistics

  2. Разрешите конфликты синхронизации

    1. Перейдите к конфликтующему файлу
2. Dropstone покажет маркеры конфликта
3. Разрешите вручную или выберите версию для сохранения

  3. Подключение к базе данных

    Проверьте подключение к базе данных:

    // В консоли Dropstone
await dropstone.db.test()

  4. Очистите локальный кэш

    Settings → Storage → Clear Local Cache

    Предупреждение: это удалит локально кэшированные данные.

  5. Резервное копирование и восстановление

    Создайте резервную копию перед устранением неполадок:

    Dropstone → Tools → Backup → Create Backup

Расширенное устранение неполадок

Безопасный режим

Запустите Dropstone в безопасном режиме, чтобы отключить все расширения:

Windows/Linux:

dropstone --disable-extensions

macOS:

/Applications/Dropstone.app/Contents/MacOS/Dropstone --disable-extensions

Сброс к настройкам по умолчанию

Чтобы сбросить все настройки к значениям по умолчанию:

  1. Создайте резервную копию текущих настроек

    Settings → Advanced → Export Settings

  2. Сброс

    Settings → Advanced → Reset All Settings

Подробное ведение журнала

Включите подробное ведение журнала для отладки:

  1. Откройте палитру команд (Ctrl/Cmd + Shift + P)
  2. Выберите: Developer: Set Log Level
  3. Выберите: Trace

Журналы теперь будут включать подробную диагностическую информацию.

Сетевая диагностика

Запустите встроенную сетевую диагностику:

Dropstone → Help → Run Network Diagnostics

Это проверяет:

  • Разрешение DNS
  • Доступность конечных точек API
  • Подключения WebSocket
  • Доступность CDN

Получение помощи

Перед обращением в службу поддержки

Убедитесь, что у вас есть:

  • Проверено это руководство по устранению неполадок
  • Просмотрена страница статуса
  • Собрана вся основная информация для устранения неполадок

Обращение в службу поддержки

Электронная почта: support@blankline.org

Включите в ваше сообщение:

  1. Краткое описание проблемы
  2. Шаги для воспроизведения
  3. Информацию о системе
  4. Соответствующие журналы (последние 100 строк)
  5. Скриншоты
  6. Что вы уже пробовали

Другие ресурсы

Полезные команды

Краткий справочник по палитре команд

КомандаОписание
Ctrl/Cmd + Shift + PОткрыть палитру команд
Ctrl/Cmd + ,Открыть настройки
Ctrl/Cmd + Shift + DОткрыть инструменты разработчика
Ctrl/Cmd + Shift + LОткрыть журналы
Ctrl/Cmd + Shift + RПерезагрузить окно
Ctrl/Cmd + K Ctrl/Cmd + TОчистить терминал

Диагностика CLI

# Проверить версию Dropstone CLI
dropstone --version

# Проверить установку
dropstone doctor

# Проверить подключение к API
dropstone ping

# Просмотреть текущую конфигурацию
dropstone config list

# Очистить локальный кэш
dropstone cache clear

# Экспортировать журналы
dropstone logs export --output ./dropstone-logs.txt

Приложение

Расположение файлов журналов

ПлатформаРасположение
Windows%APPDATA%\Dropstone\logs
macOS~/Library/Application Support/Dropstone/logs
Linux~/.config/Dropstone/logs

Расположение файлов конфигурации

ПлатформаРасположение
Windows%APPDATA%\Dropstone\config.json
macOS~/Library/Application Support/Dropstone/config.json
Linux~/.config/Dropstone/config.json

Переменные окружения

ПеременнаяНазначениеПример
DROPSTONE_API_URLПереопределить конечную точку APIhttps://api.dropstone.io
DROPSTONE_LOG_LEVELЗадать уровень подробности журналаdebug, info, warn, error
DROPSTONE_TIMEOUTТайм-аут запроса API (мс)30000
DROPSTONE_PROXYURL прокси-сервераhttp://proxy:8080
DROPSTONE_DISABLE_TELEMETRYОтключить телеметриюtrue, false

Последнее обновление: 29 сентября 2025 г. Версия: 1.0.0

Ctrl+I