From 53bb98572815a9fc362478ad7ed4a97a02774c67 Mon Sep 17 00:00:00 2001 From: seomin0610 Date: Fri, 19 Dec 2025 20:55:05 +0900 Subject: [PATCH] update(translation): Korean --- .../current/advanced/alternative.mdx | 209 +++++++++++------- .../current/advanced/jit.mdx | 25 +-- .../current/advanced/pairing-file.mdx | 4 +- .../current/installation/install.mdx | 81 +++++-- .../current/installation/prerequisites.mdx | 73 +++--- 5 files changed, 237 insertions(+), 155 deletions(-) diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/advanced/alternative.mdx b/i18n/ko/docusaurus-plugin-content-docs/current/advanced/alternative.mdx index 3dae95e6..f48333d7 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/advanced/alternative.mdx +++ b/i18n/ko/docusaurus-plugin-content-docs/current/advanced/alternative.mdx @@ -3,29 +3,41 @@ title: 대안/구버전 안내 description: "SideStore 설정에 대한 대체/구버전 안내를 모아둔 곳이에요. 주의: 여기 있는 절차는 최신 iOS나 SideStore 버전과 호환되지 않을 수도 있어요." --- +```mdx-code-block +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +``` + ## 설치 ### AltServer -#### macOS -[이 안내](https://faq.altstore.io/altstore-classic/how-to-install-altstore-macos)의 1~3단계를 따라 AltServer를 설정해 주세요. -#### Windows -[이 안내](https://faq.altstore.io/altstore-classic/how-to-install-altstore-windows)의 1~3단계를 따라 AltServer를 설정해 주세요. -#### Linux (Altcon) -시작하기 전에 usbmuxd가 설치돼 있는지 확인해 주세요. - -1. Linux 터미널에서 `sudo apt install -y usbmuxd`를 실행해 usbmuxd가 설치돼 있고 최신인지 확인해 주세요. -2. 기기에 Docker나 Podman 중 하나를 설치해 주세요. -2. 보조 iDevice를 연결해 주세요. 프롬프트가 나오면 “신뢰”를 선택하고 암호를 입력해 주세요. -3. 아래 명령으로 Docker나 Podman에서 Altcon을 실행해 주세요(상황에 따라 `sudo`가 필요할 수 있어요). - -Docker 설정: -```bash -docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd -v /var/lib/lockdown:/tmp/lockdown ghcr.io/sidestore/altcon -``` -Podman 설정: -```bash -podman run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd -v /var/lib/lockdown:/tmp/lockdown ghcr.io/sidestore/altcon -``` -5. Altcon이 기기와 페어링할 거예요. 다시 프롬프트가 나오면 “신뢰”를 선택하고 암호를 한 번 더 입력해 주세요. + + + + [이 안내](https://faq.altstore.io/altstore-classic/how-to-install-altstore-macos)의 1~3단계를 따라 AltServer를 설정해 주세요. + + + [이 안내](https://faq.altstore.io/altstore-classic/how-to-install-altstore-windows)의 1~3단계를 따라 AltServer를 설정해 주세요. + + + 시작하기 전에 usbmuxd가 설치돼 있는지 확인해 주세요. + 1. Linux 터미널에서 `sudo apt install -y usbmuxd`를 실행해 usbmuxd가 설치돼 있고 최신버전인지 확인해 주세요. + 2. 기기에 Docker나 Podman 중 하나를 설치해 주세요. + 2. iDevice를 연결해 주세요. 프롬프트가 나오면 “신뢰”를 선택하고 암호를 입력해 주세요. + 3. 아래 명령으로 Docker나 Podman에서 Altcon을 실행해 주세요(상황에 따라 `sudo`가 필요할 수 있어요). + + Docker: + ```bash + docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd -v /var/lib/lockdown:/tmp/lockdown ghcr.io/sidestore/altcon + ``` + + Podman: + ```bash + podman run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd -v /var/lib/lockdown:/tmp/lockdown ghcr.io/sidestore/altcon + ``` + + 5. Altcon이 기기와 페어링할 거예요. 다시 프롬프트가 나오면 “신뢰”를 선택하고 암호를 한 번 더 입력해 주세요. + + #### AltServer를 사용하여 동일 계정 내 여러 기기에서 SideStore 설정하기 순서는 이래요: @@ -49,24 +61,41 @@ podman run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd -v /va 1. 새 인증서를 가져와 주세요. 2. SideStore 안에서 SideStore ipa를 사이드로드해 주세요. -## 페어링 -### idevice_pair -#### 설치 안내 - -##### macOS +## VPN +### WireGuard +:::note +사이드스토어에서 WireGuard VPN은 **0.3.1-0.6.1 버전과 0.6.3-nightly.4e6756d 버전 사이에서만 작동하며**, 대체 수단(LocalDevVPN)이 있다면 사용을 권장하지 않아요. 해당 버전 외에서 작동하지 않을 경우 **이 문제에 대한 지원을 요청하지 말아주세요**. +::: -1. [macOS용 idevice_pair](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--macos-universal.dmg)를 다운로드해 주세요. -2. 디스크 이미지를 연 뒤 `idevice pair`를 `Applications` 폴더로 드래그해 주세요. +사이드스토어는 기기 내장형 와이어가드 VPN을 활용하여 내부 서비스와 통신합니다. -##### Windows +1. WireGuard 앱을 [공식 App Store](https://apps.apple.com/app/wireguard/id1441195209)에서 다운로드해 주세요. +2. 또한, [여기](https://github.com/SideStore/SideStore/releases/download/0.3.1/SideStore.conf)에서 WireGuard 설정 파일을 다운로드해 주세요. +3. WireGuard를 열고 '터널 추가' 또는 '+' 버튼을 눌러주세요. +4. '파일 또는 아카이브에서 생성'을 선택하고 SideStore.conf 파일을 선택해 주세요. +5. 장치에서 'VPN 구성 허용'을 묻는 메시지가 표시될 수 있습니다. '허용'을 선택하고 인증해 주세요. +6. 사이드스토어 VPN 옵션을 켜주세요. -1. Apple 웹사이트에서 iTunes를 설치해 주세요([64비트](https://apple.com/itunes/download/win64) 또는 [32비트](https://apple.com/itunes/download/win32)). AltServer 설정 과정에서 이미 설치했을 수도 있어요. -2. [Windows용 idevice_pair](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--windows-x86_64.exe)를 다운로드해 기억하기 쉬운 위치로 옮겨 주세요. +사이드스토어를 사용할 때는 항상 이 VPN을 켜야 해요. 대부분의 기능이 VPN 없이 작동하지 않기 때문이에요. -##### Linux +## 페어링 +### idevice_pair +#### 설치 안내 -1. Linux 터미널에서 `sudo apt install -y usbmuxd`를 실행해 usbmuxd가 설치돼 있는지 확인해 주세요. -2. PC 아키텍처에 맞는 Linux용 idevice_pair([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--linux-x86_64.AppImage) 또는 [AArch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--linux-aarch64.AppImage))를 다운로드해 기억하기 쉬운 위치로 옮긴 뒤 실행 권한을 부여해 주세요. + + + 1. [macOS용 idevice_pair](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--macos-universal.dmg)를 다운로드해 주세요. + 2. 디스크 이미지를 연 뒤 `idevice pair`를 `Applications` 폴더로 드래그해 주세요. + + + 1. Apple 웹사이트에서 iTunes를 설치해 주세요([64비트](https://apple.com/itunes/download/win64) 또는 [32비트](https://apple.com/itunes/download/win32)). AltServer 설정 과정에서 이미 설치했을 수도 있어요. + 2. [Windows용 idevice_pair](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--windows-x86_64.exe)를 다운로드해 기억하기 쉬운 위치로 옮겨 주세요. + + + 1. Linux 터미널에서 `sudo apt install -y usbmuxd`를 실행해 usbmuxd가 설치돼 있는지 확인해 주세요. + 2. PC 아키텍처에 맞는 Linux용 idevice_pair([x86_64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--linux-x86_64.AppImage) 또는 [AArch64](https://github.com/jkcoxson/idevice_pair/releases/latest/download/idevice_pair--linux-aarch64.AppImage))를 다운로드해 기억하기 쉬운 위치로 옮긴 뒤 실행 권한을 부여해 주세요. + + #### 페어링 안내 @@ -87,64 +116,65 @@ JitterbugPair(모바일 앱인 Jitterbug와는 달라요)는 SideStore 같은 .mobiledevicepairing 파일을 옮기는 과정에서 확장자가 바뀔 수도 있어요(보통 .txt로 바뀌거나 “ing”이 잘려요). 전송 전에 페어링 파일을 zip으로 압축하는 걸 항상 추천해요. SideStore는 .mobiledevicepairing 파일만 받으며, 구버전에서는 .plist도 가능했어요. ::: -##### Windows - -1. `jitterbugpair-win64.zip`을 **압축 해제**해 주세요. -2. 아직 안 했다면 기기 **잠금 암호를 설정**해 주세요. 기기를 잠금 해제하고 컴퓨터에 연결한 뒤 프롬프트가 나오면 “신뢰”를 선택하고 암호를 입력해 주세요. -3. 기기를 홈 화면에 둬 주세요. -4. 파일 탐색기에서 `jitterbugpair.exe`를 찾아 더블 클릭하거나 마우스 오른쪽 버튼으로 “열기”를 선택해 실행해 주세요. 도구를 처음 실행하면 보조 기기에 암호 입력 프롬프트가 뜰 거예요. 암호를 입력하고 화면을 켠 채 잠금 해제 상태로 다시 실행해 주세요. -5. JitterbugPair가 같은 폴더에 `.mobiledevicepairing` 확장자의 **페어링 파일**을 만들어 줘요. -6. 최상의 결과를 위해 파일을 zip으로 압축한 뒤 One/iCloud/Google Drive, 이메일 등 원하는 방법으로 **페어링 파일을 iOS 기기로 전송**해 주세요. - -Windows에서는 `.exe`를 더블 클릭해도 실행되지 않을 수 있어서 명령 프롬프트나 PowerShell에서 실행해야 할 수도 있어요. - -7. 파일 탐색기에서 jitterbugpair가 있는 폴더로 이동해 주세요. -8. 주소 표시줄의 빈 공간을 클릭하고 `powershell`을 입력해 주세요. PowerShell 창이 열릴 거예요. -9. 기기가 연결된 상태에서 `./jitterbugpair.exe`를 입력하고 Enter를 눌러 주세요. - -##### macOS - -1. `jitterbugpair-macos.zip`을 **압축 해제**해 주세요. -2. 아직 안 했다면 기기 **잠금 암호를 설정**해 주세요. 기기를 잠금 해제하고 컴퓨터에 연결한 뒤 프롬프트가 나오면 “신뢰”를 선택하고 암호를 입력해 주세요. -3. 기기를 홈 화면에 둬 주세요. -4. 추출한 `jitterbugpair` 파일(검은색과 초록색 아이콘)을 찾아 더블 클릭하거나 마우스 오른쪽 버튼으로 “열기”를 선택해 실행해 주세요. 도구를 처음 실행하면 보조 기기에 암호 입력 프롬프트가 뜰 거예요. 암호를 입력하고 화면을 켠 채 잠금 해제 상태로 다시 실행해 주세요. -5. “macOS에서 이 앱이 악성 코드로부터 안전한지 확인할 수 없어요”라는 메시지가 뜨면 이렇게 해 주세요. + + + 1. [macOS 용](https://github.com/osy/Jitterbug/releases/download/v1.3.1/jitterbugpair-macos.zip) JitterbugPair를 다운로드 해주세요. + 2. `jitterbugpair-macos.zip`을 **압축 해제**해 주세요. + 3. 아직 안 했다면 기기 **잠금 암호를 설정**해 주세요. 기기를 잠금 해제하고 컴퓨터에 연결한 뒤 프롬프트가 나오면 “신뢰”를 선택하고 암호를 입력해 주세요. + 4. 기기를 홈 화면으로 이동시켜 주세요. + 5. 압축 해재한 `jitterbugpair` 파일(검은색과 초록색 아이콘)을 찾아 더블 클릭하거나 마우스 오른쪽 버튼으로 “열기”를 선택해 실행해 주세요. 도구를 처음 실행하면 보조 기기에 암호 입력 프롬프트가 뜰 거예요. 암호를 입력하고 화면을 켠 채 잠금 해제 상태로 다시 실행해 주세요. + 6. “macOS에서 이 앱이 악성 코드로부터 안전한지 확인할 수 없어요”라는 메시지가 뜨면 이렇게 해 주세요. - 설정 > 개인정보 보호 및 보안으로 이동해 주세요. - 해당 앱 메시지가 보일 때까지 스크롤해 주세요. - “그래도 열기”를 클릭해 주세요. 자동으로 실행되지 않으면 다시 실행해 주세요. -6. JitterbugPair가 사용자 홈 폴더에 `.mobiledevicepairing` 확장자의 **페어링 파일**을 만들어 줘요. -7. 페어링 파일을 못 찾겠다면: - - 생성된 파일 이름을 복사해 주세요. - - Finder에 붙여 넣어 검색해 주세요. - - 도구를 여러 번 실행했다면 이름이 같아서 해당 기기의 페어링 파일이 모두 표시될 거예요. -8. 최상의 결과를 위해 파일을 zip으로 압축한 뒤 AirDrop, iCloud/One/Google Drive, 이메일 등 원하는 방법으로 **iOS 기기로 전송**해 주세요. - -##### Linux - -이 안내는 Linux 명령줄에 익숙하다고 가정해요. - -1. `jitterbugpair-linux.zip`을 **압축 해제**해 주세요. -2. 추출한 디렉터리에서 터미널을 열어 주세요. -3. 프로그램 실행 권한을 주세요. - ```bash - chmod +x ./jitterbugpair - ``` -4. 아직 안 했다면 기기 **잠금 암호를 설정**해 주세요. 기기를 잠금 해제하고 컴퓨터에 연결한 뒤 프롬프트가 나오면 “신뢰”를 선택하고 암호를 입력해 주세요. -5. 기기를 홈 화면에 둬 주세요. -6. 프로그램을 실행해 주세요. - ```bash - ./jitterbugpair - ``` -7. 도구를 처음 실행하면 보조 기기에 암호 입력 프롬프트가 뜰 거예요. 암호를 입력하고 화면을 켠 채 잠금 해제 상태로 다시 실행해 주세요. -8. JitterbugPair가 `.mobiledevicepairing` 확장자의 **페어링 파일**을 만들어 줘요. -9. 최상의 결과를 위해 파일을 zip으로 압축한 뒤 이메일, 클라우드 저장소 등 원하는 방법으로 **iOS 기기로 전송**해 주세요. + 7. JitterbugPair가 사용자 홈 폴더에 `.mobiledevicepairing` 확장자의 **페어링 파일**을 만들어 줘요. + 8. 페어링 파일을 못 찾겠다면: + - 생성된 파일 이름을 복사해 주세요. + - Finder에 붙여 넣어 검색해 주세요. + - 도구를 여러 번 실행했다면 이름이 같아서 해당 기기의 페어링 파일이 모두 표시될 거예요. + 9. 최상의 결과를 위해 파일을 zip으로 압축한 뒤 AirDrop, iCloud/One/Google Drive, 이메일 등 원하는 방법으로 **iOS 기기로 전송**해 주세요. + + + 1. [Windows (64-bit)용](https://github.com/osy/Jitterbug/releases/download/v1.3.1/jitterbugpair-win64.zip) JitterbugPair를 다운로드 해주세요. + 2. `jitterbugpair-win64.zip`을 **압축 해제**해 주세요. + 3. 아직 안 했다면 기기 **잠금 암호를 설정**해 주세요. 기기를 잠금 해제하고 컴퓨터에 연결한 뒤 프롬프트가 나오면 “신뢰”를 선택하고 암호를 입력해 주세요. + 4. 기기를 홈 화면에 둬 주세요. + 5. 파일 탐색기에서 `jitterbugpair.exe`를 찾아 더블 클릭하거나 마우스 오른쪽 버튼으로 “열기”를 선택해 실행해 주세요. 도구를 처음 실행하면 보조 기기에 암호 입력 프롬프트가 뜰 거예요. 암호를 입력하고 화면을 켠 채 잠금 해제 상태로 다시 실행해 주세요. + 6. JitterbugPair가 같은 폴더에 `.mobiledevicepairing` 확장자의 **페어링 파일**을 만들어 줘요. + 7. 최상의 결과를 위해 파일을 zip으로 압축한 뒤 One/iCloud/Google Drive, 이메일 등 원하는 방법으로 **페어링 파일을 iOS 기기로 전송**해 주세요. + + Windows에서는 `.exe`를 더블 클릭해도 실행되지 않을 수 있어서 명령 프롬프트나 PowerShell에서 실행해야 할 수도 있어요. + + 8. 파일 탐색기에서 jitterbugpair가 있는 폴더로 이동해 주세요. + 9. 주소 표시줄의 빈 공간을 클릭하고 `powershell`을 입력해 주세요. PowerShell 창이 열릴 거예요. + 10. 기기가 연결된 상태에서 `./jitterbugpair.exe`를 입력하고 Enter를 눌러 주세요. + + + + 이 안내는 Linux 명령줄에 익숙하다고 가정해요. + 1. [Linux용 ](https://github.com/osy/Jitterbug/releases/download/v1.3.1/jitterbugpair-linux.zip) JitterbugPair를 다운로드 해주세요. + 2. `jitterbugpair-linux.zip`을 **압축 해제**해 주세요. + 3. 추출한 디렉터리에서 터미널을 열어 주세요. + 4. 프로그램 실행 권한을 주세요. + ```bash + chmod +x ./jitterbugpair + ``` + 5. 아직 안 했다면 기기 **잠금 암호를 설정**해 주세요. 기기를 잠금 해제하고 컴퓨터에 연결한 뒤 프롬프트가 나오면 “신뢰”를 선택하고 암호를 입력해 주세요. + 6. 기기를 홈 화면에 둬 주세요. + 7. 프로그램을 실행해 주세요. + ```bash + ./jitterbugpair + ``` + 8. 도구를 처음 실행하면 보조 기기에 암호 입력 프롬프트가 뜰 거예요. 암호를 입력하고 화면을 켠 채 잠금 해제 상태로 다시 실행해 주세요. + 9. JitterbugPair가 `.mobiledevicepairing` 확장자의 **페어링 파일**을 만들어 줘요. + 10. 최상의 결과를 위해 파일을 zip으로 압축한 뒤 이메일, 클라우드 저장소 등 원하는 방법으로 **iOS 기기로 전송**해 주세요. + + ## SideStore 익스플로잇 ### SparseRestore (앱 3개 제한) :::note - SparseRestore “앱 3개 제한 우회” 익스플로잇은 **iOS/iPadOS 17.0~18.1 beta 4(17.7.1 제외)**에서만 작동해요. 해당 버전에 있지 않은데 동작하지 않는다고 해서 **지원 요청은 삼가 주세요.** - ::: #### 준비물 @@ -163,17 +193,24 @@ SparseRestore “앱 3개 제한 우회” 익스플로잇은 **iOS/iPadOS 17.0~ #### 단계 1. SparseBox를 설치해 주세요. 다양한 방법이 있지만 여기서는 SideStore로 설치한다고 가정해요. 최신 버전은 [여기](https://nightly.link/khanhduytran0/SparseBox/workflows/build/main/artifact.zip)에서 받을 수 있어요(artifact.zip을 풀면 .ipa가 있어요). + 2. SideStore에서 “Disable App Limit”을 켜고 SideStore가 **완전히 종료**돼 있는지(백그라운드에 없어요) 확인한 뒤 SparseBox를 열어 주세요. + 3. StosVPN을 켜고 페어링 파일을 선택한 뒤 “Bypass 3-app limit”을 탭해 주세요. 로그가 표시될 거예요. `idevicebackup2 exited with code -18` 또는 `idevicebackup2 exited with code 2`가 나올 때까지 기다렸다가 앱을 닫아 주세요. Apply를 누를 필요는 없어요. + 4. SideStore를 다시 열고 설정에서 아래로 스크롤해 “clear cache”를 눌러 주세요. 그래야 SideStore가 익스플로잇 상태를 감지해요. + 5. 익스플로잇이 성공했는지 테스트해 주세요(빈 슬롯 수에 따라 앱을 여러 개 설치해야 할 수도 있어요). 제한 관련 오류가 나오면 SideStore를 다시 열거나 익스플로잇을 다시 시도해 주세요. 설치가 되면 성공이에요! 이제 한 번에 3개 이상 앱을 설치할 수 있어요. #### 참고 제한 때문에 앱 3개를 추가로 사이드로드할 때마다 이 익스플로잇을 다시 해야 해요. -다른 이유로 Find My가 필요하다면 이제 다시 켜도 돼요. 다만 앱을 더 설치하거나 갱신하려면 다시 꺼야 해요. +다른 이유로 나의 찾기가 필요하다면 이제 다시 켜도 돼요. 다만 앱을 더 설치하거나 갱신하려면 다시 꺼야 해요. ### MacDirtyCow (앱 3개 제한) +:::note +MacDirtyCow “앱 3개 제한 우회” 익스플로잇은 **iOS/iPadOS 15.0부터 16.1.2 버전 사이에서만 작동합니다**. 해당 버전이 아닌 경우 작동하지 않으며, **이 문제에 대한 지원을 요청하지 마십시오**. +::: [MDC 호환 IPA](https://cdn.discordapp.com/attachments/949183273827983370/1074037820328521829/SideStore_MDC_14.ipa) -위 SideStore MDC 버전(앱 3개 제한 우회)은 iOS 15.0~16.1.2에서만 호환되고 상당히 오래돼서 문제가 발생할 수 있어요. 이 기능이 필요하면 Discord에 참여해서 [sidestore-downloads](https://discord.com/channels/949183273383395328/1126118099930861638) 채널에서 MDC 호환 SideStore 빌드를 받아 주세요. 그다음 [SideStore로 WDBRemoveThreeAppLimit를 따로 설치](https://github.com/zhuowei/WDBRemoveThreeAppLimit/releases/tag/v1.0)해서 패치를 적용해 주세요. +이 기능을 원하신다면, 저희 디스코드에 가입하시고 [SideStore Download](https://discord.com/channels/949183273383395328/1126118099930861638) 채널로 이동하시길 권장합니다. 해당 채널에는 MDC 호환 사이드스토어 빌드가 포함되어 있습니다. 그런 다음, [WDBRemoveThreeAppLimit를 SideStore와 별도로 설치](https://github.com/zhuowei/WDBRemoveThreeAppLimit/releases/tag/v1.0)하여 패치를 적용하세요. \ No newline at end of file diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/advanced/jit.mdx b/i18n/ko/docusaurus-plugin-content-docs/current/advanced/jit.mdx index e15066f1..5510a89b 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/advanced/jit.mdx +++ b/i18n/ko/docusaurus-plugin-content-docs/current/advanced/jit.mdx @@ -4,13 +4,14 @@ description: Just-in-Time (JIT) 컴파일이 필요한 앱을 위한 JIT 활성 --- :::note -iOS 26에서 JIT가 작동하지 않게 되었어요. StikDebug에 수정 사항이 포함된 업데이트가 출시되었으나 지원 범위는 제한적이에요. 작성 시점(11월 10일) 기준으로 지원되는 앱은 다음과 같아요: +iOS 26에서 JIT가 작동하지 않게 되었어요. StikDebug에 수정 사항이 포함된 업데이트가 출시되었으나 지원 범위는 제한적이에요. 작성 시점(12월 18일) 기준으로 지원되는 앱은 다음과 같아요: * UTM * Amethyst * MeloNX * maciOS * DolphiniOS (베타) * Geode +* Manic EMU 추가 업데이트를 위해 저희 디스코드 서버의 공지 채널과 [idevice 서버](https://discord.gg/mACqxMxP3X)의 공지 및 호환성 채널을 확인해 주세요. @@ -22,28 +23,24 @@ JIT를 활성화하는 방법은 AltJIT, SideJITServer 등 여러 가지가 있 ## 사전 요구사항 * iOS/iPadOS 17.4-18.6를 실행하는 iDevice(18.4b1 제외). 17.0-모든 iOS 18 버전을 사용 중인 경우 (18.4b1 제외) [SideJITServer](https://github.com/nythepegasus/SideJITServer)와 같은 대안을 사용해야 해요. SideStore의 JIT 활성화 기능은 기기가 약 4년 이상 된(TXM 미지원) 기기에서만 iOS 26에서 작동해요. -## Apple 앱 스토어를 통한 StikDebug 설치 +## StikDebug 설치 1. **StikDebug 설치** - StikDebug를 [Apple App Store](https://apps.apple.com/ko/app/stikdebug/id6744045754)에서 설치해 주세요. -:::note -좋은 점 - StikDebug에 포함된 VPN은 SideStore에서 사용되는 것과 유사합니다. 즉, SideStore에서 앱을 설치하고 업데이트하는 데도 사용할 수 있으며, StosVPN과 유사한 방식입니다. -::: -2. **설치 절차:** - 아래 사용 가이드의 표준 설치 절차를 따르세요. + StikDebug를 [AltStore 공식 소스](https://intradeus.github.io/http-protocol-redirector?r=sidestore://https://stikdebug.xyz/index.json)에서 설치해 주세요. + -### 표준 설치 절차: +2. **페어링 파일 넣기:** + iloader를 사용하여 SideStore와 동일한 **페어링 파일**을 iloader로 가져옵니다. 이 과정에 대한 자세한 내용은 [여기](https://github.com/StephenDev0/StikDebug-Guide/blob/main/pairing_file.md)를 참조하십시오. -1. **페어링 파일 업로드:** - StikDebug를 열고 닫아 앱의 폴더를 파일 시스템에 생성한 후, idevice pair를 사용하여 SideStore에서 사용하는 동일한 **페어링 파일**을 가져옵니다. 이 과정에 대한 자세한 내용은 [여기](https://github.com/StephenDev0/StikDebug-Guide/blob/main/pairing_file.md)를 참조하세요. +### 표준 설치 절차 (장치를 재시작할 때마다 반드시 먼저 수행해야 함): -2. **DDI 마운트:** - Wi-Fi와 VPN이 연결된 상태에서 StikDebug를 열고 페어링 파일을 수입한 후, 프로그램을 닫고 다시 열면 됩니다. 이 과정은 DDI를 마운트하는 것으로, idevice를 재시작할 때마다 반드시 수행해야 합니다. +1. **DDI 마운트:** + Wi-Fi와 VPN을 연결하고 페어링 파일을 배치한 상태에서 StikDebug를 실행한 후 강제 종료하고 다시 실행하세요. 이렇게 하면 DDI가 마운트됩니다. 이제 StikDebug에 모든 녹색 표시등이 표시되어야 합니다. ## JIT를 활성화하려면 1. **VPN 활성화:** - 먼저 Wi-Fi 또는 셀룰러 데이터를 활성화한 상태에서 StikDebug를 실행하여 내장형 VPN을 활성화합니다. 이제 셀룰러 데이터를 사용하는 경우 비행기 모드를 활성화한 후 VPN이 여전히 활성화된 상태에서 앱을 다시 실행합니다. StikDebug에서 기본 제공 VPN을 활성화하여 시작합니다. + Wi-Fi 또는 셀룰러 데이터가 활성화된 상태에서 LocalDevVPN을 열고 내장 VPN을 활성화하세요. 셀룰러 데이터를 사용하는 경우, 비행기 모드를 켠 후 VPN이 활성화된 상태로 앱을 다시 실행하세요. 2. **JIT 활성화:** “Connect by App” 버튼을 선택하고 목록에서 앱을 선택합니다(목록에 표시되려면 적절한 권한으로 사이드로드되어야 합니다). 이를 통해 디버거를 연결하고 JIT 기능을 활성화할 수 있습니다. \ No newline at end of file diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/advanced/pairing-file.mdx b/i18n/ko/docusaurus-plugin-content-docs/current/advanced/pairing-file.mdx index a288f3fa..e6064f09 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/advanced/pairing-file.mdx +++ b/i18n/ko/docusaurus-plugin-content-docs/current/advanced/pairing-file.mdx @@ -7,7 +7,7 @@ iDevice를 업데이트하거나 초기화하면 페어링 파일이 만료되 ::: ## 페어링 파일 교체하기 -1. iloader 및 SideStore 설치하고 설정하려면, [설치 가이드](/docs/installation/prerequisites)의 있는 단계들을 제대로 따랐는지 확인해 주세요. +1. iloader 및 SideStore 설치하고 설정하려면, [설치 가이드](/docs/installation/prerequisites)의 있는 단계들을 제대로 따랐는지 확인해 주세요. 만약 iloader가 업데이트를 할거냐고 물으면 'Yes를 누르세요. 2. 최상의 결과를 위해 iDevice를 USB 케이블로 컴퓨터에 연결해 주세요. 하지만 기기가 무선으로만 표시된다면 그것도 괜찮아요. 3. "Manage Pairing File"를 클릭해 주세요. -4. "SideStore" 및 원하는 다른 앱 오른쪽에 있는 "Place"를 클릭해 주세요. "Pairing file placed successfully! 라고 초록색 메시지가 표시되어야 해요. \ No newline at end of file +4. "SideStore" 및 원하는 다른 앱 오른쪽에 있는 "Place"를 클릭해 주세요. "Pairing file placed successfully! 라고 초록색 메시지가 표시되어야 해요. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/installation/install.mdx b/i18n/ko/docusaurus-plugin-content-docs/current/installation/install.mdx index 57af6a9b..a9633e0d 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/installation/install.mdx +++ b/i18n/ko/docusaurus-plugin-content-docs/current/installation/install.mdx @@ -1,34 +1,69 @@ --- title: 설치 -description: 당신의 iDevice에 SideStore을 설치하기 +description: 당신의 iPhone, iPad 또는 iPod touch에 SideStore을 설치하기 sidebar_position: 2 --- + +```mdx-code-block +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +``` + +시작하기 전에, [필수 요구 사항](prerequisites)에 있는 모든 소프트웨어를 다운로드하고 설정을 완료하세요! + ## SideStore 설치하기 -1. 당신의 iDevice를 케이블을 통해 컴퓨터에 연결해 주세요. 만약 신뢰 여부를 묻는 창이 뜬다면, 신뢰 버튼을 누르고 기기 비밀번호를 입력해 주세요. +### 컴퓨터에서 +1. 당신의 iPhone, iPad 또는 iPod touch를 케이블을 통해 컴퓨터에 연결해 주세요. 만약 신뢰 여부를 묻는 창이 뜬다면, 신뢰 버튼을 누르고 기기 비밀번호를 입력해 주세요. 2. iloader를 열어주세요. 3. 애플 계정으로 로그인을 해주세요. (연결된 당신의 기기와 계정이 똑같을 필요는 없어요) -4. 당신의 iDevice를 선택해 주세요. -5. "Install SideStore"를 선택해 주세요. +4. 당신의 iPhone, iPad 또는 iPod touch를 선택해 주세요. +5. 'Install SideStore (Stable)'를 선택해 주세요. -### 당신의 iDevice에서 -따라오세요: -1. 설정 앱에 들어가세요 -2. '일반'에 들어간 다음, 'VPN 및 기기 관리'에 들어가세요. -3. 애플 계정 이메일 아래에 있는 "개발자 앱"을 승인해 주세요. -4. '개인정보 보호 및 보안' 탭으로 이동해 주세요. -5. 아래로 내린 다음, '개발자 모드'를 활성화해 주세요. 당신의 기기는 재시작 될거에요. -6. StosVPN에 들어간 다음 'Connect' 버튼을 눌러 주세요. -7. SideStore에 들어가 주세요. -9. iloader에 사용했던 애플 계정으로 로그인해 주세요. -10. "My Apps"로 이동해 주세요. -11. SideStore 오른쪽에 있는 "n DAYS" 버튼을 눌러주세요. (n은 앱이 만료되기까지 남은 일수예요) -12. 서명 인증서를 취소하거나 새로 생성하라는 메시지가 표시되면 "Yes" 또는 "Refresh Now"를 눌러주세요. +### iPhone, iPad 또는 iPod touch에서 + + + 1. 설정 앱을 실행해주세요. + 2. '일반'으로 이동한 다음 'VPN 및 기기 관리'를 선택해주세요. + 3. '개발자 앱' 섹션에서 본인의 Apple 계정 이름으로 된 항목을 선택해주세요. + 4. '[Apple 계정 이름]을(를) 신뢰함'을 선택한 뒤, 확인 화면에서 '신뢰'를 눌러주세요. + 5. LocalDevVPN을 실행하고 '연결'을 눌러주세요. + 6. SideStore를 실행해주세요. + 7. iloader에서 사용한 Apple 계정으로 로그인해주세요. + 8. 'My Apps'로 이동해주세요. + 9. SideStore 오른쪽에 표시된 '7 DAYS'를 눌러 수동으로 새로고침하여 SideStore 설정을 완료해주세요. (7은 앱 만료까지 남은 일수를 의미하며, 남은 기간에 따라 자동으로 변경됩니다. 해당 표시를 누르면 연결된 앱이 새로고침됩니다.) + 10. 서명 인증서를 취소하거나 새로 생성하라는 안내가 표시되면 'Yes' 또는 'Refresh Now'를 선택해주세요. + + + 1. 설정 앱을 실행해주세요. + 2. '일반'으로 이동한 다음 'VPN 및 기기 관리'를 선택해주세요. + 3. '개발자 앱' 섹션에서 본인의 Apple 계정 이름으로 된 항목을 선택해주세요. + 4. '[Apple 계정 이름]을(를) 신뢰함'을 선택한 뒤, 확인 화면에서 '신뢰'를 눌러주세요. + 5. '개인정보 보호 및 보안'으로 이동해주세요. + 6. 화면을 맨 아래로 스크롤한 후 '개발자 모드'를 켜주세요. 기기가 재시작됩니다. + 7. LocalDevVPN을 실행하고 '연결'을 눌러주세요. + 8. SideStore를 실행해주세요. + 9. iloader에서 사용한 Apple 계정으로 로그인해주세요. + 10. 'My Apps'로 이동해주세요. + 11. SideStore 오른쪽에 표시된 '7 DAYS'를 눌러 수동으로 새로고침하여 SideStore 설정을 완료해주세요. (7은 앱 만료까지 남은 일수를 의미하며, 남은 기간에 따라 자동으로 변경됩니다. 해당 표시를 누르면 연결된 앱이 새로고침됩니다.) + 12. 서명 인증서를 취소하거나 새로 생성하라는 안내가 표시되면 'Yes' 또는 'Refresh Now'를 선택해주세요. + + + 1. 설정 앱을 실행해주세요. + 2. '일반'에 들어간 다음, 'VPN 및 기기 관리'에 들어가세요. + 3. 개발자 앱 섹션에서 사용 중인 Apple 계정을 선택합니다. + 4. '[Apple 계정 이름]을(를) 신뢰함'을 선택한 뒤, 확인 화면에서 '신뢰'를 눌러주세요. + 5. 앱을 신뢰할지 확인하라는 메시지가 뜨면 암호를 입력해주세요. + 6. '개인정보 보호 및 보안'으로 이동해주세요. + 7. 화면을 아래로 스크롤한 후 '개발자 모드'를 켜주세요. 기기가 재시작됩니다. + 8. LocalDevVPN을 실행한 뒤 '연결'을 눌러주세요. + 9. SideStore를 실행해주세요. + 10. iloader에서 사용한 Apple 계정으로 로그인해주세요. + 11. 'My Apps'로 이동해주세요. + 12. SideStore 오른쪽에 표시된 '7 DAYS'를 눌러 수동으로 새로고침하여 SideStore 설정을 완료해주세요. (7은 앱 만료까지 남은 일수를 의미하며, 남은 기간에 따라 자동으로 변경됩니다. 해당 표시를 누르면 연결된 앱이 새로고침됩니다.) + 13. 서명 인증서를 취소하거나 새로 생성하라는 안내가 표시되면 'Yes' 또는 'Refresh Now'를 선택해주세요. + + 이 과정이 성공하면, SideStore가 당신의 기기를 홈 화면으로 보내주고 알림도 뜰 겁니다. 몇 초 안에 SideStore를 다시 사용할 수 있어요. -주의: iDevice를 업데이트하거나 초기화하면 페어링 파일이 만료돼서, 다시 가져와야 해요. 이 방법은 [이 가이드](/docs/advanced/pairing-file)를 보면 됩니다. 이건 애플 소프트웨어 때문에 가끔 무작위로 만료될 수 있어요. - -iloader로 SideStore를 다시 설치하면, 인증서가 취소될 수도 있어서 다시 수동으로 갱신해야 해요. - -만약 같은 애플 계정으로 다른 기기에 SideStore를 설치 하고 싶으시다면 [이 단계](/docs/advanced/alternative#altserver를-사용하여-동일-계정-내-여러-기기에서-sidestore-설정하기)를 따라가면 돼요. - +주의: iPhone, iPad 또는 iPod touch를 업데이트하거나 초기화하면 페어링 파일이 만료돼서, 다시 가져와야 해요. 이 방법은 [이 가이드](/docs/advanced/pairing-file)를 보면 됩니다. 이건 애플 소프트웨어 때문에 가끔 무작위로 만료될 수 있어요. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/installation/prerequisites.mdx b/i18n/ko/docusaurus-plugin-content-docs/current/installation/prerequisites.mdx index 1ea95b61..55e9063f 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/installation/prerequisites.mdx +++ b/i18n/ko/docusaurus-plugin-content-docs/current/installation/prerequisites.mdx @@ -4,47 +4,60 @@ description: '설치의 첫 단계입니다.' sidebar_position: 1 --- -SideStore의 설치 과정은 다소 까다로워 보일 수 있지만, ***단 한 번만*** 컴퓨터를 이용하면 얼마 지나지 않아 당신의 기기에 SideStore가 설치되어 있을 것이에요! +```mdx-code-block +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +``` ## 요구 사항 - SideStore를 설치하기 위해서는 아래의 요구사항을 충족해야 해요: - - [비밀번호가 설정된](https://support.apple.com/ko-kr/119586) iOS 또는 iPadOS 14 이상을 사용하는 iPhone 또는 iPad -- 컴퓨터 (한번만) -- Apple 계정 -- Wi-Fi -- 시간 (이 과정은 빠르게 진행되지만, [문제 해결](/docs/troubleshooting/)을 위해 시간을 남겨두어야 해요.) +- Windows 7 또는 그 이상, 또는 macOS High Sierra 또는 그 이상, 또는 최신 Linux 배포판을 사용하는 컴퓨터 (한번만) +- Apple 계정 (Apple ID) +- Wi-Fi 연결 +- 시간 (이 과정은 빠르게 진행되지만, [문제 해결](/docs/troubleshooting/)을 위해 시간을 남겨두어야 해요) ## 기기 준비하기 - -### 당신의 iPhone/iPad: - SideStore는 기기 내 VPN을 활용하여 내부 서비스와 통신해요. 1. LocalDevVPN을 [공식 App Store](https://apps.apple.com/kr/app/localdevvpn/id6755608044)에서 다운로드해 주세요. -2. VPN을 활성화해 주세요. "VPN 구성을 추가하겠냐"는 메시지가 뜨면 '허용'을 누르고 기기 암호를 입력해야 해요. +2. VPN에 연결해 주세요. "VPN 구성을 추가하려고 합니다"라는 메시지가 뜨면 '허용'을 누르고 기기 암호를 입력해 주세요. SideStore에서 앱을 설치, 업데이트, 새로고침하려면 이 VPN을 항상 켜두어야 해요. 이제 사용하는 컴퓨터 OS에 맞는 안내를 따라가주세요. -### Mac에서 -1. iloader를 다운로드 하고 설치해 주세요. ([M시리즈](https://github.com/nab138/iloader/releases/latest/download/iloader-darwin-aarch64.dmg) 또는 [Intel](https://github.com/nab138/iloader/releases/latest/download/iloader-darwin-x64.dmg)). -2. 터미널을 연 후, `sudo xattr -c ./Applications/iloader.app`를 입력해 주세요. 그리고 만약 비밀번호를 물어보는 창이 나타나면 비밀번호를 입력해 주세요. - - -### Windows PC에서 -1. [iTunes](https://apple.co/ms)를 다운로드하고 설치해 주세요. -2. iloader 인스톨러를 다운로드해 주세요. ([.exe](https://github.com/nab138/iloader/releases/latest/download/iloader-windows-x64.exe) 또는 [.msi](https://github.com/nab138/iloader/releases/latest/download/iloader-windows-x64.msi)) (참고: 현재 iloader 설치 프로그램 .exe 파일이 바이러스/트로이목마로 오탐지되고 있어요. 해당 문제는 실제 악성 코드가 아니며, 현재 원인을 조사 중이에요. 문제 해결 전까지는 .msi 설치 파일을 다운로드하여 사용하시는 것을 권장드려요.) -3. 설치프로그램을 실행해 주세요. - -### Linux 머신에서 -1. `usbmuxd`를 다운로드 하고 설치해 주세요. (당신이 쓰는 Linux 배포판에는 기본으로 깔려 있을 수도 있어요. 아니면 패키지 관리자로 설치하면 돼요.) -2. 당신의 Linux 배포판에 맞는 iloader를 다운로드하고 설치해 주세요. ([.deb](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-amd64.deb), [.rpm](https://github.com/nab138/iloader/releases/download/v0.1.3/iloader-linux-x86_64.rpm), [.AppImage](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-amd64.AppImage)). - - -## 다음 단계 - -다음으로 SideStore을 설치하기 위해 다음 가이드를 따라가 주세요! -- [설치](install) + + + [iloader](https://github.com/nab138/iloader/releases/latest/download/iloader-darwin-universal.dmg)를 다운로드 하고 설치해 주세요. + + + :::warning + 32비트 버전의 Windows 또는 Arm 기반 Windows 10은 지원되지 않습니다. + +
+ **대부분의 Windows 버전은 64비트입니다.** 그러나 지원되지 않는 Windows 버전을 사용 중인지 확인하려면 다음 지침을 따라주세요. + 1. Windows+R(또는 Command+R 또는 Super+R)을 눌러 실행 창을 열어 주세요. + 2. `control /name microsoft.system`을 입력해 주세요. + 3. "장치 사양" 탭에서 "시스템 종류"을 찾으세요. + + * "32비트 운영 체제"로 표시되면 해당 Windows 버전이 지원되지 않습니다. + * "ARM64 프로세서"를 사용 중이며 Windows 10을 실행 중인 경우 해당 Windows 버전이 지원되지 않습니다. +
+ ::: + + 1. [Microsoft Store](https://apple.co/ms) 또는 [Apple 웹사이트](https://www.apple.com/itunes/download/win64)에서 iTunes를 다운로드하고 설치해 주세요. + 2. iloader 인스톨러를 다운로드해 주세요. [msi](https://github.com/nab138/iloader/releases/latest/download/iloader-windows-x64.msi) (추천) 또는 [exe](https://github.com/nab138/iloader/releases/latest/download/iloader-windows-x64.exe) + 3. 설치프로그램을 실행해 주세요. + + + :::warning + 64비트 배포판만 지원됩니다. + + **대부분의 리눅스 배포판은 64비트입니다.** 64비트 배포판을 사용 중인지 확인하려면 터미널을 열고 `uname -m`을 실행하세요. 예상 출력은 `x86_64`입니다. + ::: + + 1. `usbmuxd`를 다운로드 하고 설치해 주세요. (당신이 쓰는 Linux 배포판에는 기본으로 깔려 있을 수도 있어요. 아니면 패키지 관리자로 설치하면 돼요 구글에 install usbmuxd [배포판 이름] 라고 검색해보는 것도 도움이 될수도 있어요.) + 2. 당신의 Linux 배포판에 맞는 iloader를 다운로드하고 설치해 주세요. Debian/Ubuntu용 [DEB](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-amd64.deb), Fedora/openSUSE용 [RPM](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-x86_64.rpm)로 제공되며, 기타 배포판용으로는 [AppImage](https://github.com/nab138/iloader/releases/latest/download/iloader-linux-amd64.AppImage)로 제공됩니다. (커뮤니티에서 관리하는 패키지도 존재합니다. 예를 들어 [Arch Linux AUR의 이 패키지](https://aur.archlinux.org/packages/iloader-bin)가 있지만, 해당 패키지의 안전성이나 보안성을 보장할 수 없음을 유의하시기 바랍니다. 시스템에 알 수 없는 패키지를 설치하기 전에는 항상 충분한 검토를 거치셔야 합니다.) + + \ No newline at end of file