Dropstone Docs

일반적인 문제

Dropstone CLI 설치 및 실행 중 발생하는 일반적인 문제를 해결하세요. 설치 실패, 인증 문제, 업데이트 오류에 대한 단계별 해결 방법을 제공합니다.

Dropstone 사용자가 가장 자주 겪는 문제와 해결 단계를 정리했습니다. 런타임 오류 및 기능별 디버깅은 CLI 문제 해결 페이지를 참조하세요.

macOS에서 설치 실패

"Command not found: brew"

Homebrew가 먼저 필요합니다. 한 번만 설치하세요:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Apple Silicon에서는 Homebrew를 PATH에 추가하세요:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

그런 다음 Dropstone 설치를 다시 실행하세요:

brew tap blankline-org/dropstone-cli
brew install dropstone

"Cannot install: package already exists"

기존 설치를 강제로 덮어쓰세요:

brew uninstall dropstone
brew install dropstone

Homebrew tap 새로고침 실패

캐시를 지우고 다시 tap하세요:

brew untap blankline-org/dropstone-cli
brew cleanup
brew tap blankline-org/dropstone-cli
brew install dropstone

Windows에서 설치 실패

"irm is not recognized as an internal or external command"

CMD가 아닌 PowerShell에서 실행 중입니다. PowerShell로 전환하세요:

irm https://dropstone.io/install.ps1 | iex

또는 CMD 설치 프로그램을 사용하세요:

curl -fsSL https://dropstone.io/install.cmd -o install.cmd && install.cmd

"The token '&&' is not a valid statement separator"

PowerShell에서 CMD 명령을 실행하려고 하고 있습니다. 위의 PowerShell 명령으로 전환하세요.

보류 중인 업데이트가 적용되지 않음

dropstone update가 성공을 보고했지만 dropstone --version이 여전히 이전 버전을 표시한다면 터미널을 다시 시작하세요. Windows에서는 다음 실행 시 새 바이너리로 교체됩니다.

그래도 해결되지 않으면 강제로 재설치하세요:

irm https://dropstone.io/install.ps1 | iex

인증

"Failed to sign in"

  1. dropstone을 다시 실행하세요. 첫 실행 시 PKCE 기반 로그인을 위해 dropstone.io/login이 열립니다.
  2. 브라우저 흐름이 실패하면 대신 토큰을 붙여넣으세요. dropstone.io/account에서 토큰을 받고 로그인 프롬프트에서 "Paste a token"을 선택하세요.

"Session expired"

Dropstone 내부에서 /login을 실행하여 자격 증명을 새로고침하세요.

잘못된 계정에 고정됨

계정을 전환하려면 Dropstone 내부에서 /login을 실행하고 브라우저 프롬프트에서 올바른 계정을 선택하세요.

업데이트 문제

dropstone update가 "Update Available"을 보고하지만 아무 작업도 하지 않음

이는 일반적으로 자동 설치 프로그램이 바이너리 디렉터리에 쓰기 권한이 없음을 의미합니다. 원래 설치 방법을 사용하여 재설치하세요:

플랫폼명령
macOS (Homebrew)brew upgrade dropstone
macOS / Linux (스크립트)curl -fsSL https://dropstone.io/install | bash
Windows (PowerShell)irm https://dropstone.io/install.ps1 | iex

이전 버전에 고정됨

설치된 버전을 확인하세요:

dropstone --version

download.dropstone.io/latest.txt의 최신 버전과 비교하세요. 일치하지 않으면 위의 플랫폼 명령을 사용하여 재설치하세요.

여전히 문제가 있나요?

위의 방법으로 해결되지 않으면 더 자세한 CLI 문제 해결 페이지를 참조하거나 dropstone.io/contact에 다음 정보와 함께 이슈를 등록하세요:

  • OS 및 버전
  • dropstone --version의 출력
  • 전체 오류 메시지와 실행한 정확한 명령
Ctrl+I