알트스토어 오류 해결: 3840 로그인 문제

01 / 먼저 결론

알트스토어가 안 된다면, 이 두 가지부터 확인하세요

알트스토어 설치 중 NSCocoaErrorDomain 3840이 뜨는 경우와, Mac에서 AltServer를 실행했는데 아무것도 보이지 않는 경우는 점검 경로가 다릅니다. 이 글에서는 애플 ID 인증 오류와 Mac 메뉴 막대의 아이콘 가림 문제를 나누어 설명합니다.

02 / 증상 분류

AltStore와 AltServer, 먼저 이름부터 구분하기

AltServer는 컴퓨터에서 실행하는 프로그램이고, AltStore Classic은 iPhone·iPad에 설치하는 앱입니다. Classic을 설치할 때 AltServer를 사용하므로, 컴퓨터 프로그램과 휴대전화 앱의 버전을 따로 확인해야 합니다. 이 글은 AltStore PAL 설치 안내가 아닙니다. [14]

모바일에서 표가 잘리면 표 안을 좌우로 밀어 전체 내용을 확인하세요.

이 표는 아래 공식 설치·문제 해결 안내를 증상별로 재구성한 점검 순서입니다. 같은 문구라도 추가 원인이 있을 수 있습니다. [5] [10] [12]

03 / 로그인 오류 이해하기

3840·unknown tag html 오류는 왜 발생했을까?

공식 GitHub 저장소에는 다음 문구와 함께 Apple ID 로그인이 실패한다는 보고가 올라왔습니다. [12]

NSCocoaErrorDomain 3840
Encountered unknown tag html on line 1
The data is not in the correct format.

이번 문제를 분석한 AltSign 수정 제안 #52에 따르면, 테스트 환경에서는 인증 요청에 같은 연결을 재사용하면서 마지막 토큰 요청이 HTML 형식의 503 응답을 받았습니다. 프로그램은 이를 기대하던 인증 데이터로 읽으려다가 형식 오류를 표시했습니다. 작성자는 비밀번호가 승인된 뒤에도 마지막 단계가 실패할 수 있었다고 설명합니다. [4]

해당 수정안은 인증 요청마다 별도 연결을 사용하고 서버 오류를 구분해 처리하는 방향이며, 확인 시점에는 Merged, 즉 공식 코드에 병합된 상태입니다. 따라서 같은 구버전을 반복 설치하거나 오류 코드만 보고 비밀번호부터 바꾸기보다, 수정 배포판 적용 여부를 먼저 보는 것이 합리적입니다. [4]

04 / 업데이트 실행

AltServer 업데이트 후 AltStore를 다시 설치하는 방법

2026년 9월 9일 확인한 macOS용 배포 정보는 AltServer 1.7.5, 공식 앱 배포 목록의 iOS 앱은 AltStore Classic 2.2.2입니다. 두 버전 번호는 서로 다른 앱을 가리킵니다. 아래 숫자를 영구적인 ‘최신 버전’으로 읽기보다 이 글의 확인 기준으로 보세요. [2] [3]

버전 지정 ZIP 경로는 Homebrew Cask의 1.7.5 등록 정보를 근거로 제시했습니다. 이 글에서 설치 파일 실행·서명 검증까지 수행한 것은 아닙니다. [3]

1. 1

   Mac에서 실행 중인 AltServer를 종료합니다

   진행 중인 설치·갱신이 끝난 뒤 종료하세요. 아이콘이 보이지 않아 메뉴에서 종료하기 어렵다면 활성 상태 보기 → AltServer → 중단 버튼 → 종료를 사용합니다. 일반 종료에 반응하지 않을 때만 강제 종료를 선택합니다. [7]

2. 2

   새 AltServer를 응용 프로그램 폴더에 넣습니다

   공식 배포본의 압축을 풀어 AltServer.app을 응용 프로그램 폴더에 복사·교체한 다음, 그 폴더의 앱을 실행하세요. 다운로드 폴더에 남은 다른 사본과 혼동하지 않도록 실제 실행하는 버전도 확인합니다. [5]

3. 3

   iPhone을 연결하고 기기 신뢰를 확인합니다

   iPhone 잠금을 해제한 상태로 Mac에 연결합니다. 컴퓨터 또는 iPhone에 기기 신뢰 확인이 나타나면 본인의 기기가 맞는지 확인한 뒤 허용하세요. [5]

4. 4

   Install AltStore에서 내 iPhone을 선택합니다

   메뉴 막대의 AltServer → Install AltStore → 연결된 iPhone으로 들어가 설치를 진행합니다. [5] 2.2.2 공식 안내는 AltServer를 통한 재설치를 요구하며, 기존 AltStore를 먼저 지울 필요가 없다고 명시합니다. 이번에는 iPhone 앱 안의 Refresh만 반복하는 것으로 대체하지 마세요. [2]

5. 5

   iPhone 앱의 버전·로그인·갱신을 확인합니다

   재설치 후 iPhone에서 AltStore를 열어 버전과 로그인 상태를 확인합니다. 기존 설치가 정상적으로 열리지 않는다면 기기 신뢰와, iOS 16 이상에서 요구되는 설정 → 개인정보 보호 및 보안 → 개발자 모드도 확인하세요. 이미 설정돼 있다면 반복해서 바꿀 필요는 없습니다. [5]

05 / 실행은 됐는데 아이콘이 없다면

AltServer 실행 안 됨? 메뉴 막대에서 가려졌을 수 있습니다

AltServer를 더블클릭해도 일반 앱처럼 큰 창이 열리지 않아 ‘무반응’으로 느끼기 쉽습니다. 공식 설치 안내상 정상 실행 위치는 Mac 화면 상단 메뉴 막대입니다. [5]

먼저 공간을 확보하고, 그다음 위치를 바꾸세요

당장 쓰지 않는 메뉴 막대 앱을 잠시 종료하거나, 시스템 설정에서 불필요한 상태 아이콘 표시를 줄여 보세요. Wi-Fi·Bluetooth 기능을 끄는 것이 아니라 아이콘 표시만 줄이는 것입니다. macOS 버전에 따라 메뉴 이름이 다를 수 있으나, ‘메뉴 막대’ 설정이 있다면 그곳에서 표시 항목을 확인할 수 있습니다. [9]

AltServer 아이콘이 보이면 ⌘ Command를 누른 채 오른쪽의 시계에 가까운 위치로 드래그하세요. 막대 밖으로 끌어내면 일부 아이콘의 표시가 제거될 수 있으므로 좌우로만 이동합니다. 왼쪽의 Apple 메뉴·파일·편집 영역은 현재 앱의 메뉴 영역이며, 상태 아이콘을 배치하는 오른쪽 영역과 용도가 다릅니다. [8]

macOS 설정에 ‘메뉴 막대에서 허용’ 항목이 있고 AltServer가 목록에 나타난다면 표시가 켜져 있는지도 확인하세요. 해당 항목이 보이지 않는 환경에서는 이 단계는 건너뛰면 됩니다. [9]

06 / 추가 점검

업데이트 후에도 안 된다면 확인할 것

다음은 공식 문제 해결 안내를 바탕으로 정리한 후속 점검 순서입니다. 앞에서 확인한 원인과 다른 문제가 동시에 있을 수도 있으므로, 지금 표시되는 오류 문구를 기준으로 분기하세요.

여전히 같은 인증 오류가 남는다면 macOS·iOS 버전, AltServer·AltStore 버전, 오류 전문, 실패 단계를 함께 기록하세요. 공개 게시물에 올릴 때는 Apple ID 이메일, 기기 식별자, 인증 코드 등 개인 정보는 가려야 합니다. ‘안 된다’는 설명보다 ‘어느 앱에서 어느 단계에 실패했는가’를 분리하는 편이 원인을 좁히기 좋습니다.

07 / 자주 묻는 질문

알트스토어 오류 해결 FAQ