콘텐츠로 이동

제4장: 자주 묻는 질문 (FAQ), 시스템 진단 및 피드백

본 장에서는 사용자들이 자주 묻는 질문, 보안 및 계정 보호 주의사항, 내장 진단 도구인 Doctor 활용법, 오류 발생 시 GitHub Issue 제출 절차를 설명합니다.

📑 목차

❓ 자주 묻는 질문 (FAQ)

1. 클론을 생성하면 원본 앱의 데이터에 영향이 있나요?

전혀 영향을 주지 않습니다. ATBClone 은 완전히 독립된 데이터 디렉토리(~/ATBClone/Data/<클론이름>)를 생성하여 사용합니다. 원본 앱의 데이터 및 캐시 디렉토리에는 일절 접근하지 않습니다.

2. 클론 데이터는 어디에 저장되나요? 백업 및 이전 방법은?

  • 저장 위치: 기본적으로 ~/ATBClone/Data/<클론이름> 에 모든 데이터가 저장됩니다.
  • 백업 및 이전: 대시보드에서 클론 카드의 "폴더 열기" 아이콘을 클릭한 후 표시된 폴더를 외장 SSD 나 새 Mac 으로 복사하기만 하면 완벽하게 이전됩니다.

3. 계정이 차단(BAN)될 위험이 있나요?

ATBClone 은 비침투형(Non-Invasive) 샌드박스 격리 기술을 사용합니다. 통신 패킷을 변조하거나 메모리를 조작하는 불법 프로그램이 아닙니다. macOS 네이티브 환경 변수 리다이렉션을 통해 동작하므로 공식 앱이 실행되는 것과 기술적으로 동일하며 안전합니다.

또한 독립 프록시 기능을 함께 사용하면 앱별로 IP 주소를 분산시킬 수 있어 동일 IP 다중 접속 감지 위험을 방지할 수 있습니다.

4. 관리자 비밀번호 (Root / Sudo) 가 필요한가요?

전혀 필요하지 않습니다. ATBClone 의 모든 파일 복제, 래퍼 생성, 애드혹 서명, 데이터 관리는 현재 사용자 권한(User Space) 내에서 완결됩니다. 시스템 시스템 파일(/System)을 수정하지 않습니다.

5. "확인되지 않은 개발자" 또는 손상 경고가 발생할 때 해결 방법은?

macOS Gatekeeper 보안 정책에 의해 차단된 경우 다음 방법으로 해결할 수 있습니다: 1. Finder 에서 우클릭으로 열기: 클론 앱(.app)을 마우스 우클릭(또는 두 손가락 탭)한 후 "열기" 를 선택하고 대화상자에서 "열기"를 클릭합니다. 2. 터미널에서 격리 속성 제거: 

xattr -cr ~/ATBClone/Apps/<클론이름>.app

6. 클론 앱의 아이콘을 변경하려면 어떻게 하나요?

  1. ATBClone 대시보드에서 대상 카드의 "편집" 버튼을 클릭합니다.
  2. 아이콘 영역에 원하는 .png 또는 .icns 이미지를 드래그하여 저장합니다.

7. 메신저 앱에서 메뉴바 아이콘이나 알림이 작동하지 않을 때 해결 방법은?

일부 메신저 앱은 번들 ID 가 변경되면 알림 센터 등록이 초기화될 수 있습니다: * macOS 의 "시스템 설정 ➔ 알림" 으로 이동하여 클론 앱의 알림 권한이 활성화되어 있는지 확인하십시오.

🩺 시스템 환경 진단 (Doctor 도구)

환경 의존성과 권한 상태를 점검하려면 내장 Doctor 도구를 사용하십시오:

  • GUI 에서: 좌측 사이드바의 "시스템 환경 진단 (Doctor)" 클릭.
  • CLI 에서: 
    atbclone doctor

Doctor 도구는 다음 항목을 자동으로 검사합니다: * [✔] macOS 버전 호환성 (macOS 12+ Monterey / Ventura / Sonoma / Sequoia) * [✔] Xcode Command Line Tools 및 codesign 유틸리티 작동 상태 * [✔] 앱 및 데이터 저장 디렉토리 쓰기 권한 * [✔] 내장 레시피 구문 유효성

🐞 문제 발견 및 GitHub Issue 보고 절차 (표준 트러블슈팅)

앱 실행 실패 등 이상 현상이 발생하면 다음 절차에 따라 정확한 진단 정보를 수집하여 보고할 수 있습니다:

1단계: 메인 화면에서 오류 클론 선택 후 "세부 정보" 클릭

대상 클론 카드를 클릭하고 툴바의 "세부 정보 (Details)" 버튼을 누릅니다.

2단계: "클론 세부 정보" 에서 진단 리포트 복사

"클론 세부 정보" 대화상자에는 다음 기술 데이터가 자동 수집되어 있습니다: * 기본 정보 (클론 이름, 전략, Bundle ID, 원본 경로) * 실행 바이너리 아키텍처 (arm64 / x86_64) * 주입된 환경 변수 및 프록시 구성 * 최근 크래시 로그 및 실행 로그 요약

하단의 "진단 정보 복사 (Copy Diagnostic Info)" 버튼을 클릭합니다.

3단계: GitHub Issue 에 제출

  1. 브라우저에서 ATBClone Issues 로 이동합니다.
  2. "New Issue" 를 클릭하고 "Bug Report" 를 선택합니다.
  3. 복사한 진단 정보를 붙여넣고 제출하면 개발팀이 신속히 원인을 분석합니다.

💬 커뮤니티 및 지원