설치와 로그인 문제

설치했는데 명령을 찾을 수 없어요#

설치 직후라면 터미널을 완전히 닫고 새로 연 뒤 mirr --version을 실행해 주세요. Windows에서도 새 PowerShell 창을 열어야 합니다.

명령을 계속 찾을 수 없다면 설치 로그에서 완료 메시지와 설치 경로를 확인해 주세요. 기본 실행 파일 위치는 macOS/Linux에서 ~/.local/bin/mirr, Windows에서 %USERPROFILE%\.local\bin\mirr.exe입니다.

설치 파일은 있지만 명령을 찾지 못하는 경우에는 설치 로그의 안내에 따라 PATH를 설정해야 합니다. PATH는 터미널이 실행할 프로그램을 찾는 폴더 목록입니다. 이 문제를 해결하기 위해 Node.js나 npm을 설치할 필요는 없습니다.

설치 파일을 내려받지 못해요#

인터넷 연결 상태와 설치 안내에 나온 다운로드 주소를 확인해 주세요. 회사나 기관의 컴퓨터에서는 다운로드가 허용되는지 관리자에게 확인해야 할 수 있습니다.

다운로드 주소가 404 또는 파일 없음으로 응답하면 설치 파일 제공 상태를 확인해야 합니다. 오류가 난 주소와 문구를 문의하기로 보내 주세요. 설치에는 출처가 확인된 패키지를 사용해 주세요.

설치에 필요한 프로그램이 없다고 나와요#

missing required command는 설치에 사용하는 기본 프로그램이 없다는 뜻입니다. Linux에서 다운로드·압축 해제 도구가 빠진 경우, Ubuntu/Debian에서는 다음과 같이 준비할 수 있습니다.

sudo apt-get install curl tar coreutils gawk

다른 Linux 배포판에서는 해당 배포판의 설치 도구로 필요한 프로그램을 준비하시면 됩니다. macOS에서 기본 도구를 찾지 못하거나 관리 권한이 없다면 운영체제 또는 장비 관리자에게 도움을 요청해 주세요. 파일 검증 실패 메시지가 나오면 검증은 그대로 유지하고 다시 다운로드하거나 지원을 요청해 주세요.

브라우저가 열리지 않아요#

mirr login이 표시한 주소를 브라우저에서 직접 열어 주시면 됩니다. 인증 코드 입력을 요청하면 같은 터미널에 표시된 코드를 사용합니다. 인증이 끝날 때까지 해당 터미널은 열어 두어야 합니다.

브라우저에서 로그인했는데 완료되지 않아요#

웹사이트 로그인과 Mirr Code 연결 완료는 다릅니다. 브라우저에서 인증을 마친 뒤 터미널에 완료 메시지가 표시되어야 합니다. 코드가 만료됐다면 명령을 다시 실행해 새 주소와 코드를 사용해 주세요.

계정 이용 권한, 승인 대기, 기기 수 관련 오류가 표시되면 화면 안내에 따라 필요한 조치를 진행해 주세요. 다른 계정으로 인증하셨거나 연결을 다시 시작해야 한다면 로그인 안내에서 해당 절차를 확인하실 수 있습니다.

수동으로 인증 파일을 복사하거나 비밀번호를 설정 파일에 입력할 필요는 없습니다. 오류가 계속되면 비밀번호나 인증 토큰 같은 민감한 정보를 지운 오류 메시지와 함께 문의해 주세요.