Docs · Ohje

Vianetsintä

Todelliset virheet joita ihmiset kohtaavat, ja komento joka kertoo kumpaa etsit.

Aloita tästä:

1vm doctor          # host, entitlements, library, engines
1vm capabilities    # what this specific Mac can and cannot do
1vm logs <vm>       # guest serial and host lifecycle logs

logs hyväksyy --source guest|host|all, --lines N ja --follow. Useimmat "se vain kaatui" -kysymykset vastataan viimeisillä vieraskoneen sarjariveillä.

Jokainen kone epäonnistuu käynnistyksessä

Lähes aina allekirjoitus. Sovelluksella on oltava virtualisointioikeus, joten binääri joka on siirretty paketista ulos tai jolta allekirjoitus on poistettu ei voi käynnistää mitään. Asenna uudelleen alkuperäisestä sovelluksesta sen sijaan että kopioit palasia ympäriinsä. 1vm doctor raportoi oikeustilan suoraan.

Kone sanoo olevansa käynnissä mutta näyttöä ei ole

Tarkista 1vm logs <vm> --source guest. Kone jonka virtuaali-CPU:t ovat olemassa raportoidaan käynnissä olevaksi vaikka firmware ei olisi päässyt vieraskoneeseen asti — joten "running" plus musta ruutu tarkoittaa yleensä käynnistysvirhettä moottorin yläpuolella, ei puuttuvaa ikkunaa.

Windowsille fallback Virtualization.framework -moottorilla musta Setup- ruutu on odotettu, kunnes näyttöajuri sitoutuu. Käytä 1VM-moottoria sen sijaan, missä ramfb valaisee Setupin ilman ajuria.

x86 ISO ei käynnisty

Se ei voi. Molemmat moottorit ajavat vieraskonekoodia natiivisti Apple siliconilla, joten vieraskoneen on oltava ARM64. Emulaatiopolkuja tai muunnosta ei ole — tarvitset ARM64- version käyttöjärjestelmästä. Tämä on yleisin yllätys, ja siihen Omarchy-opas selittää täydellisesti.

Windowsilla ei ole verkkoa

Asenna virtio-win NetKVM-ajuri. Windowsilla on valmiit ajurit NVMe:lle ja xHCI:lle, minkä vuoksi levy ja näppäimistö toimivat heti, mutta ei virtio-netille. Liitä ajuri-ISO luontiaikana --drivers:lla.

Vieraskone loppui muisti kesken asennuksen

Asennusohjelmat ovat muistin huippukohta, ei käynnissä oleva järjestelmä. Anna koneelle enemmän ja yritä uudelleen:

1vm stop dev --force
1vm set dev memory 8GiB
1vm start dev

Jos Mac itse on paineen alla, 1VMTool skaalaa profiilin alas ja kertoo sen sijaan että ylikommitoisi hiljaa.

Näppäimistö on jumissa vieraskoneessa

Napauta vapautussäveltä — konsolin tilapalkki näyttää mikä yhdistelmä on aktiivinen kyseisessä ikkunassa. Se on konfiguroitavissa:

1vm get dev input.releaseChord

Asetusta ei voi muuttaa

Laitteistomuutokset käynnissä olevalla koneella evätään, ellei asetus erikseen tue sitä. Pysäytä kone, muuta, käynnistä. Asetukset validoidaan asettaessasi, joten virhe nimeää todellisen ongelman eikä kaadu seuraavalla käynnistyksellä.

Skripti jää odottamaan tai kilpailee

Käytä 1vm wait-ready <vm> unen sijaan. "Running" tarkoittaa että kone suorittaa; "ready" tarkoittaa että vieraskone on tavoitettavissa SSH:n tai guest agentin kautta. Väli niiden välillä on missä epävakaat skriptit elävät.

Paluu toimivaan tilaan

1vm discard-session dev --force   # undo everything since this boot
1vm snapshot restore dev clean    # go to a named snapshot
1vm reset dev --force             # back to the clean state

Jos ohitit tilannevedoksen ottamisen, tämä on hetki aloittaa: se maksaa mitään, ja siinä on koko pointti.