Dropstone 문제 해결 가이드 - 진단 및 수정

이 가이드는 Dropstone.io에서 발생하는 일반적인 문제를 체계적으로 진단하고 해결하는 방법을 제공합니다. 아래 단계에 따라 지원팀에 문의하기 전에 필요한 정보를 수집하세요.

문제 해결을 위한 필수 정보

다음 정보는 Dropstone 내에서 대부분의 문제 해결 시나리오에 중요합니다:

1. 시각적 문서화

문제 스크린샷 (민감한 정보는 삭제)

• 오류가 표시된 전체 애플리케이션 창을 캡처하세요
• 오류 메시지나 대화 상자를 포함하세요
• 가능하면 타임스탬프가 보이도록 하세요

2. 재현 단계

문제를 재현하기 위한 자세한 단계를 제공하세요:

1. 수행한 작업 (예: "'배포' 버튼 클릭")
2. 예상 동작
3. 실제 동작
4. 빈도 (항상, 가끔, 한 번)

3. 시스템 정보

다음에서 시스템 정보를 확인하세요:

Dropstone → 도움말 → 정보

여기에는 다음이 포함됩니다:

• Dropstone 버전
• 운영 체제
• 아키텍처 (x64, arm64)
• Electron 버전
• Node.js 버전

4. 네트워크 구성

다음 중 하나를 사용하고 있습니까?

• VPN (가상 사설망)
• Zscaler 또는 기타 보안 프록시
• 기업 방화벽
• 사용자 지정 DNS 설정

5. 개발자 도구 콘솔

JavaScript 오류를 확인하려면 개발자 도구에 접근하세요:

Dropstone → 도움말 → 개발자 도구 전환

콘솔 탭으로 이동하여 다음을 확인하세요:

• 빨간색 오류 메시지
• 문제와 관련된 경고 메시지
• 네트워크 요청 실패

관련 오류 스택 추적을 복사하세요.

6. 애플리케이션 로그

Windows

로그는 다음 위치에 있습니다:

C:\Users\<사용자 이름>\AppData\Roaming\Dropstone\logs

명령 팔레트로 접근:

1. Ctrl + Shift + P 누르기
2. 입력 후 선택: 개발자: 로그 폴더 열기

macOS

로그는 다음 위치에 있습니다:

~/Library/Application Support/Dropstone/logs

명령 팔레트로 접근:

1. Cmd + Shift + P 누르기
2. 입력 후 선택: 개발자: 로그 폴더 열기

Linux

로그는 다음 위치에 있습니다:

~/.config/Dropstone/logs

애플리케이션에서 로그 보기

다음으로 이동하세요: Dropstone → 터미널 → 출력

드롭다운에서 선택:

• Window - 일반 애플리케이션 로그
• Dropstone Core - 핵심 기능 로그
• Dropstone Deployment - 배포 관련 로그
• Dropstone Storage - 스토리지 및 데이터베이스 로그
• Dropstone API - API 요청/응답 로그

일반적인 문제 및 해결 방법

연결 문제

문제: Dropstone 서비스에 연결할 수 없음

증상:

• "연결 시간 초과" 오류
• "서버에 연결할 수 없음" 메시지
• 무한 로딩 상태

해결 방법:

1. 인터넷 연결 확인

   # Windows
   ping dropstone.io
   
   # macOS/Linux
   ping dropstone.io
   

2. 방화벽 설정 확인

   • Dropstone이 방화벽을 통과하도록 허용되어 있는지 확인
   • 기업 네트워크 정책 확인
   • *.dropstone.io 도메인을 허용 목록에 추가

3. 프록시 구성

   프록시 설정 구성:

   Dropstone → 설정 → 네트워크 → 프록시 설정

   또는 환경 변수 설정:

   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)

인증 문제

문제: 로그인 실패 또는 토큰 만료

증상:

• "인증 실패" 오류
• 반복적인 로그인 프롬프트
• 401 Unauthorized 응답

해결 방법:

1. 인증 캐시 지우기

   Dropstone → 명령 팔레트 → 인증 캐시 지우기

2. 재인증

   1. Dropstone에서 로그아웃
   2. dropstone.io에 대한 브라우저 쿠키 삭제
   3. 다시 로그인
   

3. 토큰 유효성 확인

   다음으로 이동: 설정 → 계정 → 세션 관리

   활성 세션을 검토하고 의심스러운 세션을 해지하세요.

4. SSO 문제

   Single Sign-On을 사용하는 경우:

   • SSO 제공자가 접근 가능한지 확인
   • 만료된 SAML 어설션 확인
   • ID 제공자 관리자에게 문의

성능 문제

문제: 느린 애플리케이션 응답 또는 높은 CPU 사용량

증상:

• 입력 또는 클릭 시 지연
• 높은 CPU/메모리 사용량
• UI가 멈추거나 응답하지 않음

해결 방법:

1. 리소스 사용량 확인

   Dropstone → 도움말 → 프로세스 관리자

   과도한 리소스를 소비하는 프로세스를 식별하세요.

2. 확장 기능 비활성화

   문제를 격리하기 위해 확장 기능을 임시로 비활성화:

   설정 → 확장 기능 → 모두 비활성화 → 다시 시작

3. 캐시 지우기

   Dropstone → 설정 → 고급 → 캐시 지우기
   

4. 프로젝트 크기 줄이기

   • 인덱싱에서 큰 파일 제외
   • .dpsignore 파일에 추가:
   node_modules/
   dist/
   build/
   *.log
   .git/
   

5. 하드웨어 가속

   GPU 가속 전환:

   설정 → 시스템 → 하드웨어 가속 사용

배포 문제

문제: 배포 실패

증상:

• 빌드 실패
• 배포 시간 초과
• "원격으로 푸시할 수 없음" 오류

해결 방법:

1. 빌드 로그 확인

   자세한 빌드 출력 보기:

   배포 → 기록 → 실패한 배포 선택 → 로그 보기

2. 환경 변수 확인

   설정 → 배포 → 환경 변수
   

   필요한 모든 변수가 설정되어 있는지 확인하세요.

3. 배포 구성 확인

   dropstone.config.js 검증:

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

4. 스토리지 할당량

   스토리지 한도를 초과하지 않았는지 확인:

   대시보드 → 사용량 → 스토리지

5. 빌드 시간 초과

   구성에서 시간 초과 증가:

   deployment: {
     timeout: 900 // 15분 (초 단위)
   }
   

스토리지 및 데이터베이스 문제

문제: 데이터 동기화 또는 스토리지 오류

증상:

• "스토리지 할당량 초과"
• 동기화 충돌
• 데이터가 유지되지 않음

해결 방법:

1. 스토리지 사용량 확인

   대시보드 → 스토리지 → 사용량 통계

2. 동기화 충돌 해결

   1. 충돌이 있는 파일로 이동
   2. Dropstone이 충돌 표시를 보여줍니다
   3. 수동으로 해결하거나 유지할 버전 선택
   

3. 데이터베이스 연결

   데이터베이스 연결 테스트:

   // Dropstone 콘솔에서
   await dropstone.db.test()
   

4. 로컬 캐시 지우기

   설정 → 스토리지 → 로컬 캐시 지우기
   

   경고: 이렇게 하면 로컬에 캐시된 데이터가 제거됩니다.

5. 백업 및 복원

   문제 해결 전에 백업 생성:

   Dropstone → 도구 → 백업 → 백업 생성
   

고급 문제 해결

안전 모드

모든 확장 기능을 비활성화하려면 안전 모드로 Dropstone을 시작하세요:

Windows/Linux:

dropstone --disable-extensions

macOS:

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

기본 설정으로 재설정

모든 설정을 기본값으로 재설정하려면:

1. 현재 설정 백업

   설정 → 고급 → 설정 내보내기
   

2. 재설정

   설정 → 고급 → 모든 설정 재설정
   

상세 로깅

디버깅을 위한 자세한 로깅 활성화:

1. 명령 팔레트 열기 (Ctrl/Cmd + Shift + P)
2. 선택: 개발자: 로그 수준 설정
3. 선택: Trace

이제 로그에 자세한 진단 정보가 포함됩니다.

네트워크 진단

내장 네트워크 진단 실행:

Dropstone → 도움말 → 네트워크 진단 실행

다음을 확인합니다:

• DNS 확인
• API 엔드포인트 접근성
• WebSocket 연결
• CDN 가용성

지원 받기

지원팀에 문의하기 전에

다음을 확인하세요:

• 이 문제 해결 가이드를 확인했습니다
• 상태 페이지를 검토했습니다
• 모든 필수 문제 해결 정보를 수집했습니다

지원팀에 문의

이메일: support@blankline.org

메시지에 포함할 내용:

1. 문제 요약
2. 재현 단계
3. 시스템 정보
4. 관련 로그 (마지막 100줄)
5. 스크린샷
6. 이미 시도한 방법

기타 리소스

• 문서: docs.dropstone.io
• 상태 페이지: status.dropstone.io
• 영업 / 엔터프라이즈: dropstone.io/contact

유용한 명령

명령 팔레트 빠른 참조

CLI 진단

# Dropstone CLI 버전 확인
dropstone --version

# 설치 확인
dropstone doctor

# API 연결 테스트
dropstone ping

# 현재 구성 보기
dropstone config list

# 로컬 캐시 지우기
dropstone cache clear

# 로그 내보내기
dropstone logs export --output ./dropstone-logs.txt

부록

로그 파일 위치

구성 파일 위치

환경 변수

마지막 업데이트: 2025년 9월 29일 버전: 1.0.0