Kun sivu ei enää lataudu normaalisti, korjaus alkaa usein siitä, että pääset käsiksi webhotellin tiedostoihin ilman WordPressin hallintapaneelia. Lue esimerkki WordPress White Screen of Death.
Käytännössä meillä on kaksi yleistä reittiä. Niin kutsuttu SSH-yhteys ja FTP-yhteys. SSH-yhteys sopii silloin, kun haluat työskennellä komentorivillä ja käyttää apuna tekoälytyökalua, kuten Claude Codea tai Codexia. FTP-yhteys taas sopii silloin, kun haluat selata tiedostoja graafisesti esimerkiksi FileZillalla ja tehdä yksittäisiä siirtoja hallitusti.
Miksi tiedostoyhteyttä tarvitaan WSoD-tilanteessa
White Screen of Death tarkoittaa yleensä sitä, että WordPressin PHP-koodi pysähtyy virheeseen ennen kuin hallintapaneeli tai sivun teema ehtii latautua. Kun asiat ovat oikein pahasti solmussa, et pääse edes kirjautumaan WordPressin hallintapuolelle. Webhotellin tiedostonhallinta antaa vaihtoehtoisen reitin tarkistaa ja muokata esimerkiksi lisäosat, teeman tiedostot, virhelokit ja viimeksi muuttuneet tiedostot. Tavoitteena ei ole muuttaa esimerkiksi koodia vaan tarkistaa, mikä osa WordPRessissä aiheuttaa virhetilanteen. Yleensä virhetilanne aiheutuu komannnen osapuolen lisäosasta tai teemasta, joka jostai syystä ei ole enää yhteensopiva WordPressin kanssa. Webhotellin tiedostonhalinasta voimme poistaa väliaikaisesti käytöstä esimerkiksi lisäosia ja sitä kautta katsoa, mikä ongelman on aiheuttanut.
Vaihtoehto 1: SSH-yhteys ja tekoäly apuna
SSH-yhteys avaa webhotellin tiedostoihin komentorivin kautta. Tämä on tehokas tapa silloin, kun haluat tekoälyn avulla analysoida ja korjata virhetilanteita. Voit lukea virhelokeja, poistaa lisäosia käytöstä sekä tutkia jopa koodia. Lisäksi voit nimetä lisäosakansion väliaikaisesti uudelleen ja näin postaa kaiki lisäosat väliaikaisesti käytöstä. SSH:n kanssa tulee kuintenkin olla huolellinen sillä asiat saattavat helposti mennä enemmän solmuun jos ei tiedä mitä on tekemässä. Voit uodostaa SSH yhteyden esimerkiksi OpenAI Codexin tai Anthropicin Claude Coden avulla. Tekoälytyökalut auttavat suunnittelussa, toteutuksessa ja tulosten tulkinnassa.
OpenAI:n Codex CLI (Command Line Interface) on paikallisesti terminaalissa ajettavana koodausagenttina, joka voi lukea, analysoida ja muuttaa koodia sekä suorittaa erilaisia tehtäviä valitussa hakemistossa. CLI voi olla hiukan epämukava käyttökokemukseltaan ja voit käyttää SSH myös OpenAI:n Codex-työpöytäsoveluuksen avulla.
Anthropicin Claude Codesta on myös saatavilla sekä CLI että oma työpöytäohjelma, joka lukee koodipohjaa, muokkaa tiedostoja ja ajaa komentoja webhotelliympäristössä.
Käytännön työjärjestys SSH:n kanssa:
- Luo SSH public avaimet ja selvitä webhotellin SSH-yhteyden osoite.
- Avaa SSH-yhteys webhotellin antamilla tunnuksilla Claude codella tai Codexilla
- Siirry WordPress-asennuksen juurihakemistoon, jossa näkyvät esimerkiksi
wp-content, wp-admin ja wp-includes.
- Kuvaa ongelma ja pyydä tekoälyltä ensin tutkimussuunnitelma, ei suoraan korjauskomentoja.
- Älä anna tekoälylle salasanoja, SSH-avaimia, tietokantatunnuksia tai muita salaisuuksia.
- Kopioi virheilmoitus tai komennon tuloste tekoälylle vasta sen jälkeen, kun olet tarkistanut ettei mukana ole tunnuksia.
Hyvä ensimmäinen pyyntö voisi olla: “WordPress näyttää valkoista ruutua. Minulla on SSH-yhteys webhotelliin. Laadi turvallinen tutkimusuunnitelma, jossa en poista tiedostoja ja jossa jokainen muutos on palautettavissa. Lisöksi laadi selkeä tehtävälista asioista, joilla saamme ongelman korjattua.”
Vaihtoehto 2: FTP FileZillalla
Jos komentorivi tuntuu vieraalta, graafinen tiedostonsiirto-ohjelma on usein helpompi aloituskohta. FileZilla on tunnettu FTP-ohjelma, ja sen virallinen sivusto esittelee sen FTP-ratkaisuna. Käytännössä webhotelleissa kannattaa suosia salattua yhteyttä, kuten SFTP:tä tai FTPS:ää, jos palveluntarjoaja tarjoaa sen.
FileZillan kaltaisessa ohjelmassa tarvitset yleensä palvelimen osoitteen, käyttäjätunnuksen, salasanan tai avaimen, portin sekä tiedon käytettävästä yhteystavasta. SFTP käyttää tyypillisesti SSH-yhteyttä, kun taas perinteinen FTP on vanhempi tiedostonsiirtotapa. Jos et ole varma oikeasta vaihtoehdosta, tarkista webhotellin ohje tai hallintapaneeli. Voit pyytää apua ja ohjeita myös tekoälyltä. Jos webhotelli ei ole tuttu, kannattaa tekoälylle laittaa kuvakaappauksia parempia ohjeita varten.
SFTP/FTP-ohjelma sopii erityisesti näihin tehtäviin:
- lataa yksittäinen tiedosto omalle koneelle ennen muutosta
- palauta aiempi versio tiedostosta takaisin palvelimelle
- nimeä ongelmallinen lisäosakansio väliaikaisesti uudelleen
- tarkista, onko jokin tiedosto muuttunut juuri ennen virheen alkamista
- siirrä virheloki omalle koneelle luettavaksi
Vaihtoehto 3: Webhotellin oma tiedostonhallinta
Jos et halua käyttää SSH-yhteyttä tai erillistä SFTP/FTP-ohjelmaa, webhotellin hallintapaneelin oma tiedostonhallinta voi riittää nopeaan korjaukseen. Se sopii esimerkiksi tilanteeseen, jossa haluat avata WordPressin tiedostot selaimessa ja nimetä ongelmallisen lisäosakansion väliaikaisesti uudelleen.
Katso tarkempi vaiheittainen ohje Miten korjaat: WordPress White Screen of Death-artikkelin kohdasta Ohjeet SnartSmartin webhotellia varten.
Mitä tietoja tarvitset ennen yhteyden muodostamista
Ennen kuin aloitat, kerää FTP:n yhteystiedot yhteen paikkaan, mutta älä kopioi niitä tekoälylle. Tarvitset yleensä palvelimen osoitteen, käyttäjätunnuksen, portin, yhteystavan ja kirjautumistavan. SSH-yhteydessä kirjautuminen voi perustua salasanaan tai SSH-avaimeen. SFTP/FTP-ohjelmassa samat tiedot asetetaan yleensä Site Manager -tyyppiseen näkymään.
Jos webhotelli tarjoaa erillisen tiedostohallinnan hallintapaneelissa, se voi riittää kiireellisessä tilanteessa. SSH ja SFTP ovat silti parempia silloin, kun haluat tehdä työn järjestelmällisesti, tallentaa varmuuskopion ja tarvittaessa pyytää tekoälyltä apua komentojen tai virhelokien tulkintaan.
Jos webhotellin SSH- ja FTP-yhteydet ovat sinulle uusi asia, voit pyyttä tekoälyltä ohjeita. Voit sanoa esimerkiksi Anthropicin Claude codelle: “Haluan muodostaa SSH yhteyden SnartSmartin webhotelliin ja selivittää, miksi WordPress sivuni ei toimi. Voitko neuvoa minua vaihe vaiheelta miten saan muodostettua SSH- yhteyden tekoälyn avullaa. Laitan sinulle tarvittaessa kuvakaappauksia webhotellinasetuksista. Mistä aloitan?”
Turvallinen työjärjestys ennen muutoksia
Riippumatta siitä, käytätkö SSH:ta vai SFTP:tä, aloita varovasti. Älä poista tiedostoja ensimmäisenä toimenpiteenä. Älä myöskään korvaa kokonaista WordPress-asennusta, jos et tiedä tarkasti mitä olet tekemässä.
- Tee varmuuskopio tietokannasta ja tiedostoista, jos hallintapaneeli tai webhotelli sen mahdollistaa.
- Jos muokkaat yksittäistä tiedostoa, lataa ensin kopio omalle koneelle.
- Tee yksi muutos kerrallaan ja testaa sivu muutoksen jälkeen.
- Kirjaa ylös mitä muutit, jotta muutos voidaan perua.
- Jos virhe liittyy lisäosaan, kokeile ensin lisäosakansion uudelleennimeämistä poistamisen sijaan.
Mitä pyydät tekoälyltä, kun yhteys on auki
Tekoälystä on eniten hyötyä, kun annat sille rajatun tehtävän ja pyydät ensin selitystä. Pyydä sitä kertomaan, mitä komento tekee ennen kuin ajat sen. Tämä on erityisen tärkeää palvelimella, jossa väärä komento voi rikkoa sivuston lisää.
Turvallisia pyyntöjä ovat esimerkiksi: “Selitä tämä PHP-virhe suomeksi”, “Mitä tiedostoa tämä virhe koskee?”, “Mikä on vähiten riskialtis tapa poistaa tämä lisäosa käytöstä tiedostotasolla?” ja “Tarkista nämä komennot ennen kuin ajan ne palvelimella.”
Anthropicin dokumentaatiossa Claude Code käyttää oletuksena tiukkoja lukuoikeuksia ja pyytää lisätoimiin lupaa. Asetuksissa voidaan myös määrittää sallittuja ja estettyjä työkaluja sekä estää herkkien tiedostojen lukemista. Sama periaate kannattaa omaksua riippumatta käytetystä tekoälytyökalusta: anna vain tarvittava tieto, tarkista ehdotukset ja pidä salaisuudet työkalun ulkopuolella.
Lähteet ja jatkolukeminen
