# macOS sunucu sorunlarını giderme: erişim, uyku, anahtar zinciri ve Xcode

> Uzak Mac'teki olağan sorunları düzeltin: masaüstüne bağlanamama, uyuyan Mac, SSH üzerinden codesign errSecInternalComponent, eksik simülatör ve dolu disk.

Zorluk: Orta

Uzak bir Mac, uzun bir kablosu olan normal bir Mac'tir. Bir şey ters gittiğinde neden genellikle birkaç şeyden biridir. Belirtinizi aşağıda bulun.

## Başlamadan önce

- Mac'inizin bağlantı yöntemlerini bilin: her HyperDC Mac için **HyperDC Web Console**; Intel macOS VPS ve VDS için **VMRC**; Apple Silicon macOS VPS ve Mac dedicated sunucular için **Apple Remote Desktop** ve **HyperDC Remote Connect**. Bkz. [macOS sunucuda ilk adımlar](/guides/macos-server-first-steps).
- Konumunuzdaki bakım veya arızalar için müşteri panelinde **Destek › Sunucu/Ağ Durumu** sayfasına bakın.

## Masaüstüne ulaşamıyorum

**Önce HyperDC Web Console'u deneyin.** Müşteri panelinde hizmetinizi açın ve Web Console'u başlatın.

- **Web Console masaüstünü gösteriyor:** Mac çalışıyor. Sorun diğer yönteminizde veya sizinle Mac arasındaki ağda. Apple Remote Desktop için `3283` ve `5900` portlarının sizin tarafınızda engelli olmadığını ve **Remote Management**'ın açık olduğunu kontrol edin; bkz. [Apple Remote Desktop](/guides/connect-to-mac-apple-remote-desktop).
- **Web Console giriş penceresini gösteriyor:** Mac yeniden başladı. Oturum açın; Docker Desktop gibi oturum gerektiren uygulamalar oturum açtıktan sonra yeniden başlar.
- **Web Console siyah ekran gösteriyor:** ekran uykuda. Konsol penceresinde fareyi oynatın veya bir tuşa basın. Siyah kalırsa bağlantıyı kesip yeniden bağlanın.
- **Web Console da bağlanmıyor:** hizmet adınız ve sorunun başladığı saatle bir destek talebi açın.

## Mac uyku moduna geçiyor

Mac uyuduğunda derlemeler durur ve bağlantılar kopar. Terminal'de:

```bash
pmset -g
sudo pmset -a sleep 0
```

Mac dedicated sunucularda **System Settings › Energy** ayarlarını da kontrol edin; bkz. [Mac dedicated sunucuyu kurma](/guides/mac-dedicated-server-setup).

## codesign SSH veya CI'da başarısız oluyor

**Belirti:** `codesign` veya `xcodebuild archive` masaüstünde çalışıyor ama SSH üzerinden veya bir CI işinde `errSecInternalComponent` ile başarısız oluyor.

**Neden:** giriş anahtar zinciri o oturumda kilitli. macOS onu SSH için değil, masaüstünde oturum açıldığında açar.

**Çözüm:** anahtar zincirini imzalama adımıyla **aynı** kabuk oturumunda veya komut zincirinde açın:

```bash
security unlock-keychain ~/Library/Keychains/login.keychain-db && xcodebuild -scheme MyApp archive
```

CI'da anahtar zinciri şifresini CI sisteminin gizli bilgi deposunda tutun ve çalışma anında `security unlock-keychain -p` komutuna verin; asla betiklere yazmayın. İmzalama hâlâ başarısız oluyorsa yinelenen veya süresi dolmuş kimliklere bakın:

```bash
security find-identity -v -p codesigning
```

## Bir simülatör çalışma zamanı eksik

**Belirti:** Xcode veya `xcodebuild test` uygun bir hedef ya da simülatör çalışma zamanı olmadığını bildiriyor.

**Çözüm:** kurulu olanları listeleyin, ardından platformu Xcode'un komut satırı aracıyla indirin:

```bash
xcrun simctl list runtimes
xcodebuild -downloadPlatform iOS
```

Her çalışma zamanı birkaç gigabayt yer kaplar; önce `df -h /` ile kontrol edin.

## Xcode kurulmuyor veya açılmıyor

macOS sürümü o Xcode için çok eski. Apple'ın Xcode sistem gereksinimlerine bakın, ardından macOS'u güncelleyin veya sürümünüzü destekleyen bir Xcode seçin; Xcode sürümleriyle macOS sürümlerinin ilişkisi için bkz. [macOS VPS ve VDS](/guides/macos-vps).

## Disk dolu

```bash
df -h /
xcrun simctl delete unavailable
du -sh ~/Library/Developer/Xcode/DerivedData
```

Eski DerivedData klasörlerini, yüklediğiniz arşivleri ve artık gerekmeyen Xcode sürümlerini silin. Sipariş formundan disk alanı ekleyebilir veya daha büyük bir pakete geçebilirsiniz.

## SSH: Connection refused

**Remote Login** kapalı. Web Console üzerinden **System Settings › General › Sharing** altında açın ve yeniden bağlanın.

## macOS güncellemeleri başarısız oluyor veya yarıda kalıyor

Boş alanı ve güncelleme listesini kontrol edin:

```bash
softwareupdate --list
```

Çalışan iş yokken `sudo softwareupdate --install --all --restart` ile kurun. Sanal bir Mac'te **ana** bir macOS yükseltmesinden önce, yeni sürümün paketiniz için desteklendiğini doğrulayabilmemiz için bize sorun.

## Sonraki adımlar

- Bir derleme makinesi hazırlayın: [iOS CI için macOS sunucu](/guides/macos-server-for-ios-ci).
- Mac dedicated sunucular: [Mac dedicated sunucuyu kurma](/guides/mac-dedicated-server-setup).

## Sık sorulan sorular

### Bir bağlantı başarısız olduğunda hangisini denemeliyim?

Tarayıcınızdaki HyperDC Web Console her HyperDC Mac'te çalışır. Masaüstünü gösteriyorsa Mac sağlamdır; sorun diğer bağlantı yönteminde veya aradaki ağdadır.

### codesign masaüstünde çalışıyor ama SSH'de neden çalışmıyor?

macOS giriş anahtar zincirinizi masaüstünde oturum açtığınızda açar. Bir SSH oturumu bunu yapmaz; bu yüzden siz o oturumda anahtar zincirini açana kadar codesign imza anahtarını kullanamaz.

### Apple Silicon macOS VPS'te Apple hesabımla oturum açabilir miyim?

Apple silicon'da macOS 15 ve sonrası, macOS 15 veya sonrasıyla oluşturulmuş sanal makinelerde Apple hesabıyla oturum açmayı destekler. İş akışınız buna bağlıysa kurulumu doğrulayabilmemiz için bize bildirin.

### Hızla disk alanı nasıl açarım?

Kullanılamayan simülatörleri xcrun simctl delete unavailable ile, eski DerivedData klasörlerini ve artık kullanmadığınız Xcode sürümlerini silin. Sonucu df -h / ile kontrol edin.

---

Kaynak: <https://hyperdc.com/tr/guides/products/macos-server-troubleshooting>\
Son güncelleme: 2026-10-15