OSX-KVM

KO | EN

gitlite — search

#javascript #php #c-plus-plus #python #game #java #linux #ios #shell #ansible #mysql #webpack

★ 23,553 Open GitHub ↗

QEMU/KVM에서 macOS를 실행하세요. 현재 OpenCore + Monterey + Ventura + Sonoma 지원이 가능합니다! 스팸성 이슈를 방지하기 위해 현재는 상용(유료) 지원만 제공됩니다. Mac 시스템이 필요하지 않습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

### 참고

이 `README.md`는 `Virtual Hackintosh` 시스템을 구축하는 과정을 문서화합니다.

참고: 이 저장소에 포함된 모든 블롭(blob)과 리소스는 다시 파생할 수 있습니다(모든 지침이 포함되어 있습니다!).

:green_heart: 이와 관련하여 **상용** 지원이 필요하신가요? **상용 지원 옵션에 한해서만** [이메일로 문의해 주시면](mailto:dhiru.kholia@gmail.com?subject=[GitHub]%20OSX-KVM%20Commercial%20Support%20Request&body=Hi%20-%20We%20are%20interested%20in%20purchasing%20commercial%20support%20options%20for%20your%20project.) 대화가 가능합니다. 참고: 프로젝트 후원자에게는 `Private OSX-KVM` 저장소 접근 권한과 직접적인 지원이 제공됩니다.

`Content Caching` 관련 문제로 어려움을 겪고 계신가요? 저희가 도와드릴 수 있습니다.

`Proxmox` 및 macOS 작업 시:
- [Nick의 블로그](https://www.nicksherlock.com/)를 반드시 확인하세요.
- `Proxmox`용으로 좀 더 최신 버전인 [OpenCore-ISO](https://github.com/LongQT-sea/OpenCore-ISO)를 참고하세요.

네, 이제 오프라인 macOS 설치도 지원합니다 - [이 문서](./run_offline.md)를 참조하세요 🎉

### 기여하기

이 프로젝트에는 여러분의 도움, 시간, 관심이 언제나 필요합니다. 다음 작업 항목에 대한 도움(풀 리퀘스트!)을 찾고 있습니다:

* 인기 클라우드 제공업체(Hetzner, GCP, AWS)에서 macOS를 실행하는 것과 관련된 문서. `Is This Legal?` 섹션과 관련 참고 자료를 참조하세요.

* 이 프로젝트를 사용하여 오픈소스 프로젝트를 빌드 및 테스트하거나 작업을 완료하는 방법을 문서화(공유)합니다.

* XNU 커널 디버깅 및 개발을 위해 이 프로젝트를 사용하는 방법을 문서화합니다.

* 헤드리스 macOS VM 여러 개를 실행하는 프로세스(빌드 팜)를 문서화합니다.

* 이러한 `build farm`에 소프트웨어를 배포하기 위한 [munki](https://github.com/munki/munki) 사용법을 문서화합니다.

* VNC 및 SSH 지원을 기본적으로 또는 더 쉽게 활성화합니다.

* 안정성 개선은 언제나 환영합니다!

* (조금은 터무니없는) 아이디어 - OpenCV를 통한 macOS 설치 자동화.

### 요구 사항

* 최신 Linux 배포판. 예: Ubuntu 24.04 LTS 64비트 이상.

* QEMU >= 8.2.2

* Intel VT-x / AMD SVM을 지원하는 CPU가 필요합니다 (`grep -e vmx -e svm /proc/cpuinfo`)

* macOS Sierra 이상을 실행하려면 SSE4.1을 지원하는 CPU가 필요합니다.

* macOS Ventura 이상을 실행하려면 AVX2를 지원하는 CPU가 필요합니다.

참고: 구형 AMD CPU는 문제가 있는 것으로 알려져 있으나, 최신 AMD Ryzen 프로세서는 (macOS Sonoma에서도) 잘 작동합니다.

### 설치 준비

* QEMU 및 기타 패키지를 설치합니다.

```
  sudo apt-get install qemu-system uml-utilities virt-manager git \
      wget libguestfs-tools p7zip-full make dmg2img tesseract-ocr \
      tesseract-ocr-eng genisoimage vim net-tools screen -y
  ```

이 단계는 사용 중인 Linux 배포판에 맞게 조정해야 할 수 있습니다.

* QEMU 시스템에 이 저장소를 복제(클론)합니다. 이 저장소의 파일들은 다음 단계에서 사용됩니다.

```
  cd ~

git clone --depth 1 --recursive https://github.com/kholia/OSX-KVM.git

cd OSX-KVM
  ```

저장소 업데이트는 다음 명령어를 통해 가져올 수 있습니다:

```
  git pull --rebase
  ```

이 저장소는 리베이스 기반 워크플로를 적극적으로 사용합니다.

* 호스트 기기에서 KVM이 정상 작동하도록 다음 조정을 해야 할 수 있습니다.

```
  sudo modprobe kvm; echo 1 | sudo tee /sys/module/kvm/parameters/ignore_msrs
  ```

이 변경 사항을 영구적으로 적용하려면 다음 명령어를 사용할 수 있습니다.
  확실하지 않은 경우 `lscpu`를 사용하세요.

```
  sudo cp kvm.conf /etc/modprobe.d/kvm.conf  # 인텔 장비 전용

sudo cp kvm_amd.conf /etc/modprobe.d/kvm.conf  # AMD 장비 전용
  ```

* 사용자를 `kvm` 및 `libvirt` 그룹에 추가합니다(필요할 수 있음).

```
  sudo usermod -aG kvm $(whoami)
  sudo usermod -aG libvirt $(whoami)
  sudo usermod -aG input $(whoami)
  ```

참고: 이 명령어를 실행한 후 다시 로그인하세요.

* macOS 설치 프로그램을 가져옵니다.

```
  ./fetch-macOS-v2.py
  ```

여기서 원하는 macOS 버전을 선택할 수 있습니다. 이 단계를 실행하고 나면 현재 폴더에 `BaseSystem.dmg` 파일이 생성되어 있어야 합니다.

주의: `>= Big Sur` 설정 시 속도가 느리더라도 `Country Selection` 화면 및 기타 유사한 화면에서 잠시 기다려 주세요. 초기 macOS 설치 마법사는 결국 완료됩니다.

실행 예시:

```
  $ ./fetch-macOS-v2.py
  1. High Sierra (10.13)
  2. Mojave (10.14)
  3. Catalina (10.15)
  4. Big Sur (11.7)
  5. Monterey (12.6)
  6. Ventura (13)
  7. Sonoma (14) - RECOMMENDED
  8. Sequoia (15)
  9. Tahoe (26)

Choose a product to download (1-9): 7
  ```

참고: 최신 NVIDIA GPU는 High Sierra에서는 지원되지만 이후 버전의 macOS에서는 지원되지 않습니다.

* 다운로드한 `BaseSystem.dmg` 파일을 `BaseSystem.img` 파일로 변환합니다.

```
  dmg2img -i BaseSystem.dmg BaseSystem.img
  ```

* macOS가 설치될 가상 HDD 이미지를 생성합니다. 디스크 이미지 이름을 `mac_hdd_ng.img`에서 다른 이름으로 변경하는 경우, 새 이미지 이름을 가리키도록 부팅 스크립트를 업데이트해야 합니다.

```
  qemu-img create -f qcow2 mac_hdd_ng.img 256G
  ```

참고: 최상의 결과를 얻으려면 이 HDD 이미지 파일을 빠른 SSD/NVMe 디스크에 생성하세요.

* 이제 macOS를 설치할 준비가 되었습니다 🚀

### 설치

- CLI 방식(기본). 설치 프로세스를 시작하려면 `OpenCore-Boot.sh` 스크립트를 실행하기만 하면 됩니다.

```
  ./OpenCore-Boot.sh
  ```

참고: 이 동일한 스크립트는 모든 최근 macOS 버전에서 작동합니다.

- macOS 설치 프로그램 내의 `Disk Utility` 도구를 사용하여 macOS VM에 연결된 가상 디스크를 분할하고 포맷합니다. 최신 macOS 버전의 경우 `APFS`(기본값)를 사용하세요.

- 자, 이제 macOS를 설치하세요 🙌

- (선택 사항) 이 macOS VM 디스크를 libvirt(virt-manager / virsh 관련 도구)와 함께 사용합니다.

- `macOS-libvirt-Catalina.xml` 파일을 편집하고 다양한 파일 경로를 변경합니다(해당 파일에서 `CHANGEME` 문자열을 검색하세요). 일반적으로 다음 명령어로 해결할 수 있습니다.

```
    sed "s/CHANGEME/$USER/g" macOS-libvirt-Catalina.xml > macOS.xml

virt-xml-validate macOS.xml
    ```

- 다음 명령어를 실행하여 VM을 생성합니다.

```bash
    virsh --connect qemu:///system define macOS.xml
    ```

- 필요한 경우 libvirt-qemu 사용자에게 필요한 권한을 부여합니다.

```
    sudo setfacl -m u:libvirt-qemu:rx /home/$USER
    sudo setfacl -R -m u:libvirt-qemu:rx /home/$USER/OSX-KVM
    ```

- `virt-manager`를 실행하고 `macOS` 가상 머신을 시작합니다.

### 헤드리스(Headless) macOS

- 제공된 [boot-macOS-headless.sh](./boot-macOS-headless.sh) 스크립트를 사용하세요.

```
  ./boot-macOS-headless.sh
  ```

### 기대치 설정하기

`Virtual Hackintosh` 시스템을 성공적으로 구축하셨습니다! 이러한 시스템은 다양한 목적(예: 소프트웨어 빌드, 테스트, 리버싱 작업)으로 사용할 수 있으며, 이 저장소에 문서화된 몇 가지 트윅과 함께 여러분에게 필요한 전부일 수 있습니다.

하지만 이러한 시스템에는 그래픽 가속, 안정적인 사운드 서브시스템, USB 3 기능 및 기타 유사한 기능이 부족합니다. 이러한 기능을 활성화하려면 [참고 문서](notes.md)를 살펴보세요. 저희는 이 영역과 관련된 테스트 및 문서화 작업을 재개하고자 합니다. 이 작업 영역에 자금을 지원할 수 있는 경우 [저희에게 연락해 주세요](mailto:dhiru.kholia@gmail.com?subject=[GitHub]%20OSX-KVM%20Funding%20Support).

'네이티브 Apple 하드웨어를 뛰어넘는' 성능을 구현하는 것도 가능하지만, 이는 노력과 인내, 그리고 약간의 행운(어쩌면?)이 필요합니다.

### 설치 후 작업

* VM에서 네트워킹을 설정하는 방법(아웃바운드 및 SSH, VNC 등을 통한 VM 원격 접속을 위한 인바운드)에 대해서는 [네트워킹 참고 문서](networking-qemu-kvm-howto.txt)를 참조하세요.

* GPU 및기타 장치를 패스스루하려면 [이 참고 문서](notes.md#gpu-passthrough-notes)를 참조하세요.

* 다른 해상도가 필요하신가요? 이 저장소에 포함된 [참고 문서](notes.md#change-resolution-in-opencore)를 확인하세요.

* iMessage에 문제가 있으신가요? 이 저장소에 포함된 [참고 문서](notes.md#trouble-with-imessage)를 확인하세요.

* 강력히 추천하는 macOS 트윅 - https://github.com/sickcodes/osx-optimizer

### 이거 합법인가요?

Apple의 "비밀" OSK 문자열은 인터넷에 널리 퍼져 있습니다. 또한 [여기에서 확인할 수 있는](http://www.rcfp.org/sites/default/files/docs/20120105_202426_apple_sealing.pdf) 공개 법원 문서에도 포함되어 있습니다. 저는 변호사가 아니지만, OSK 문자열을 영업 비밀로 취급하려는 Apple의 시도는 성공하지 못한 것으로 보입니다. 이러한 이유로 OSK 문자열은 이 저장소에 자유롭게 포함되어 있습니다.

[Dortania의 OpenCore Install Guide에 있는 'Legality of Hackintoshing' 문서 조각](https://dortania.github.io/OpenCore-Install-Guide/why-oc.html#legality-of-hackintoshing)을 검토해 보세요.

Gabriel Somlo도 QEMU/KVM 환경에서 macOS를 실행하는 것과 관련된 법적 측면에 대해 [몇 가지 생각](http://www.contrib.andrew.cmu.edu/~somlo/OSXKVM/)을 공유하고 있습니다.

또한 ['Announcing Amazon EC2 Mac instances for macOS' 아티클](https://aws.amazon.com/about-aws/whats-new/2020/11/announcing-amazon-ec2-mac-instances-for-macos/)도 흥미로우실 수 있습니다.

참고: Apple EULA를 이해하고 수락(또는 거부)할 책임은 본인에게 있습니다.

참고: 이는 법률 자문이 아니므로, 직접 적절한 평가를 내리시고 우려 사항이 있는 경우 변호사와 상담하시기 바랍니다 (문구 출처: Dortania)

### 동기

저의 목표는 Apple의 폐쇄적인 생태계에 (너무 깊게) '발을 들이지' 않고도 macOS 기반 교육 작업, 빌드 및 테스트, 커널 디버깅, 리버싱, macOS 보안 연구를 쉽고 재현 가능한 방식으로 수행할 수 있도록 하는 것입니다.

이러한 `Virtual Hackintosh` 시스템은 실제 물리적인 macOS 시스템을 대체하기 위한 것이 아닙니다.

개인적으로 이 저장소는 Apple 생태계에서 '탈출'하는 방법이 되어 주었습니다. 덕분에 `Canon CanoScan LiDE 120` 스캐너와 `Brother HL-2250DN` 레이저  프린터의 상호 운용성을 테스트하고 비교할 수 있었습니다. 이제 이 기기들은 최신 버전의 Ubuntu에서 꽤 괜찮게 작동합니다 (만세 자유 소프트웨어). 또한 아주 오래전에, 저는 (당시) 새것이었던 `MacBook Pro (Retina, 15-inch, Late 2013)`를 완전히 포맷하고 그곳에 Xubuntu를 설치해야만 했습니다. `OS X` 커널이 계속해서 다운되었기 때문입니다!

비하인드 스토리: 전생에 저는 캐나다의 (가난한) 학생이었고, Apple은 [Apple Keychain 크래킹 작업](https://github.com/openwall/john/blob/bleeding-jumbo/src/keychain_fmt_plug.c)을 필요 이상으로 훨씬 더 어렵게 만들었습니다. 이것이 제가 Hackintosh 시스템에 관심을 갖게 된 계기입니다.

OSX-KVM

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README