설치 및 시작 문제

지금 겪고 있는 증상에 맞는 항목부터 살펴보세요. 각 목록은 가능성이 높은 해결책부터 순서대로 정리되어 있습니다.

설치 프로그램이 실행되지 않거나 끝까지 진행되지 않습니다.

1. 시스템이 요구 사항을 충족하는지 확인하세요. 64비트 Windows 10(버전 2004) 이상, Apple Silicon Mac, 또는 systemd를 갖춘 주류 glibc x86-64 Linux 배포판이 필요합니다. ARM64와 musl 기반 배포판은 지원하지 않습니다. 시스템 요구 사항을 참고하세요.
2. Windows에서 Nexus-Setup.exe는 시스템 전체에 설치되므로 관리자 권한이 필요합니다. 한 번 표시되는 UAC 요청을 승인하세요. 요청이 나타나지 않으면 설치 프로그램을 우클릭해 관리자 권한으로 실행하세요.
3. Linux에서 install.sh는 sudo가 필요하며, 압축을 푼 tarball 디렉터리에서 실행해야 합니다.
4. 설치가 도중에 실패하거나 파일이 손상된 것 같다면 다운로드 페이지에서 다시 받아 실행하세요. 전체 안내는 Nexus 설치에 있습니다.

백신 프로그램이 Nexus를 차단하거나 삭제했습니다.

오탐입니다. 격리 보관함에서 파일을 복원하고 Nexus 폴더를 허용하세요. 백신별 단계는 백신 프로그램과 오탐에서 확인하세요.

Nexus가 설치되어 있는데 실행 중이 아닌 것 같습니다.

Nexus는 백그라운드 서비스로 실행되고, 그 위에 대시보드 앱이 올라갑니다. 서비스부터 확인하세요:

1. Windows: 서비스(services.msc)를 열고 Nexus Service를 찾으세요. 시작 유형은 자동입니다. 중지되어 있다면 시작하세요. 아예 없다면 설치 프로그램을 다시 실행하세요.
2. macOS: Finder에서 Nexus를 다시 실행하세요. 설정에서 시스템 시작 시 Nexus 실행이 켜져 있으면 Nexus가 로그인 시 실행되는 launch agent(~/Library/LaunchAgents의 com.hellonexus.panel.service)를 등록합니다.
3. Linux: systemctl status nexus를 실행하세요. sudo systemctl restart nexus로 재시작하고, journalctl -u nexus -f로 출력을 확인하세요. 데스크톱에 처음 로그인하기 전에 설치했다면 sudo systemctl restart nexus를 한 번 실행해 서비스가 로그인 세션을 이어받게 하세요.
4. 서비스가 시작되었다가 다시 멈춘다면, 다시 시도하기 전에 로그 파일부터 수집해 실패 기록을 남기세요. 로그 및 버그 신고를 참고하세요.

서비스는 실행 중인데 대시보드가 열리지 않습니다.

1. 같은 PC의 브라우저에서 http://localhost:9400을 여세요. 대시보드는 Nexus가 실행 중인 컴퓨터에만 제공되므로, 로컬에서만 열리고 다른 곳에서는 열리지 않습니다. 여기서 대시보드가 뜬다면 서비스는 정상이고 문제는 앱 창에만 있는 것입니다.
2. Windows에서는 Nexus 트레이 아이콘을 우클릭해 Open(열기)를 고르거나, 시작 메뉴에서 Nexus를 실행하세요.
3. 브라우저 확인도 실패한다면 위 항목대로 서비스를 재시작한 뒤 다시 시도하세요.
4. 그래도 막혀 있나요? PC를 재부팅한 다음 로그를 챙겨 신고해 주세요: 로그 및 버그 신고.