TL;DR

  • Sideloop은 무료 Apple ID로 서명한 사이드로드 앱을 서명 만료 전 와이파이를 통해 재설치하는 자체 호스팅 서비스임.
  • Linux(amd64·arm64) 또는 Mac에서 실행되며, AltServer-Linux로 앱을 재서명하고 기존 앱 데이터는 유지함.
  • 여러 iPhone·iPad의 앱을 관리하고, 기기가 온라인 상태가 되면 서명이 만료되기 전에 자동으로 재서명함.
  • 웹 UI에서 기기 페어링, IPA 업로드, 2단계 인증 코드 입력, 진행 상황 확인을 지원함.
  • Docker와 Compose가 필요하며, 무료 Apple 계정은 기기당 앱 3개와 주당 App ID 10개로 제한됨.

Sideloop

  • Sideloop은 무료 Apple ID로 서명한 사이드로드 IPA를 서명 만료 전 와이파이로 재설치하는 자체 호스팅 서비스임.
  • Linux 머신(amd64 또는 arm64)이나 Mac에서 실행되며, AltServer-Linux로 앱을 재서명해 기존 앱에 덮어 설치하므로 앱 데이터가 유지됨.
  • 기기에 AltStore나 SideStore를 설치할 필요가 없음.

기능

  • 여러 iPhone 및 iPad에서 여러 앱 관리
  • 기기가 온라인 상태가 되면 서명 만료 전에 자동 재서명
  • 페어링, IPA 업로드, 2단계 인증 코드 입력, 실시간 진행 상황 확인을 제공하는 웹 UI
  • 각 IPA의 FairPlay 암호화, 트윅, 앱 확장 검사
  • anisette-v3-server를 통한 자체 호스팅 Apple 로그인
  • Python 표준 라이브러리만 사용하며 amd64와 arm64용 Docker 이미지 하나로 실행

데모

  • 2분 분량의 음성 안내 영상에서 설정, 기기와 앱 추가, 2단계 인증 코드를 이용한 첫 설치, 자동 재서명 과정을 설명함.

스크린샷

  • 로그인
  • 앱
  • 서명
  • 설정
  • 활동

빠른 시작

사전 준비

  • Docker와 Compose
  • 별도로 사용하는 Apple ID

Linux에서 실행

  • 저장소를 복제하고 .env.example을 .env로 복사한 다음 Docker Compose로 서비스를 시작함.
  • 첫 빌드에서 AltServer를 컴파일하므로 몇 분이 걸림.
  • Raspberry Pi 3 같은 소형 보드에서는 다른 arm64 머신에서 이미지를 빌드한 뒤 보드로 복사하면 빌드 시간을 줄일 수 있음. 복사한 뒤 --no-build 옵션으로 서비스를 시작함.
  • http://<host>:8080을 열어 비밀번호를 설정한 다음 USB로 기기를 페어링하고 IPA와 Apple ID를 추가함.

macOS에서 실행

  • macOS용 Docker는 USB 또는 와이파이 기기를 인식하지 못하므로 먼저 시스템 usbmuxd에 연결하는 브리지를 설정함.
  • socat을 사용해 로컬 TCP 포트 27015를 /var/run/usbmuxd에 연결한 뒤 docker-compose.mac.yml을 추가해 서비스를 시작함.
  • Finder에서 기기를 페어링하고 ‘와이파이 연결 시 이 iPhone 보기’를 활성화함.

참고 사항

  • Apple ID의 일반 비밀번호를 사용해야 하며 앱 전용 비밀번호는 작동하지 않음.
  • 첫 로그인에는 Apple이 2단계 인증 코드를 요청하며, 이후 로그인은 별도 입력 없이 진행됨.
  • 재서명 중에는 기기의 잠금이 해제되어 있어야 하며 Sideloop과 같은 와이파이에 연결되어야 함.
  • 무료 계정은 기기당 앱 3개와 주당 App ID 10개를 허용하며, 각 앱 확장에는 자체 App ID가 필요함.
  • 설정 > 일반 > VPN 및 기기 관리에서 개발자를 한 번 신뢰해야 하며, 새로고침 후에도 신뢰 상태가 유지됨.
  • Apple 로그인이 작동하지 않으면 Dockerfile의 ALTSERVER_TAG를 업데이트해야 함. AltServer는 해당 태그와 altserver/ 디렉터리의 패치를 사용해 빌드됨.
  • 데이터는 ./data에 저장됨.

제작자

  • Filippo Finke
  • 웹사이트: filippofinke.ch
  • Twitter: @filippofinke
  • GitHub: @filippofinke
  • LinkedIn: @filippofinke

라이선스

  • 저작권 © 2026 Filippo Finke.
  • 프로젝트는 MIT 라이선스이며 아이콘은 Ionicons의 MIT 라이선스를 따름.
  • Apple과 제휴 관계가 아니며 별도로 사용하는 Apple ID를 권장함.