SSH-yhteys webhotelliisi — näin yhdistät

SSH antaa teille komentorivikuoren webhotelliinne, jotta voitte hallita tiedostojanne, WordPress-asennustanne ja projektejanne suoraan palvelimella — ilman FTP:n tai hallintapaneelin kautta kiertämistä. Tämä opas käy läpi, miten yhdistätte ja mitä työkaluja on käytettävissä.

SSH:n käyttöönotto

SSH-yhteys tapahtuu webhotelliinne liitetyn shell-tilin kautta. Jos teillä ei ole vielä shell-tiliä, luokaa sellainen hallintapaneelin kohdasta Shell-käyttäjät tai ottakaa yhteyttä tukeen. Valitsette itse käyttäjänimen ja salasanan (ja voitte lisätä SSH-avaimen).

Palvelinosoitteen löytäminen

Webhotellinne sijaitsee yhdellä Adminorin webhotellipalvelimista, ja palvelinosoite vaihtelee eri palvelinten välillä. Käyttäkää aina juuri oman palvelimenne osoitetta — sen löydätte jollakin seuraavista tavoista:

• Hallintapaneelista, webhotellinne tai shell-käyttäjänne kohdalta (palvelimen tai hostnamen kenttä).
• Tervetuloviestistä, jonka saitte tilin luomisen yhteydessä.
• Epävarma? Ottakaa yhteyttä tukeen, niin annamme teille oikean osoitteen.

Alla olevissa esimerkeissä käytetään paikkamerkkiä oma-palvelin.xh.se — korvatkaa se todellisella palvelinosoitteellanne. (Voitte yhdistää myös oman verkkotunnuksenne kautta, jos se osoittaa webhotelliin, mutta palvelimen hostname on aina turvallinen valinta.)

Yhdistäminen

Linux/macOS- tai Windows-koneella (PowerShell/Terminal):

ssh [email protected]

SSH-avaimella (suositeltavaa):

ssh -i ~/.ssh/oma_avain [email protected]

Samat tiedot toimivat SFTP:lle ja scp:lle, jos haluatte vain siirtää tiedostoja:

sftp [email protected]
scp lokalfil.zip [email protected]:web/

Ympäristönne

Kirjauduttuanne sisään päädytte omaan kotihakemistoonne eristetyssä ympäristössä (chroot-jail). Se tarkoittaa:

• Näette vain omat tiedostonne, ette muiden asiakkaiden tai järjestelmän tiedostoja.
• Verkkotiedostonne sijaitsevat kansiossa web/ (se on julkinen webroot-hakemistonne).
• Käytössänne on myös private/ (verkon ulkopuolisille tiedostoille, esim. konfiguraatio) ja tmp/.
• Ette ole root ettekä voi asentaa järjestelmäpaketteja, mutta yleisimmät kehittäjätyökalut ovat jo valmiina (katso alla).

cd web        # siirry webroot-hakemistoosi
ls -la        # listaa tiedostot

Tarkka hakemistorakenne voi vaihdella hieman eri webhotellipalvelinten välillä. Jos olette epävarma webroot-hakemistonne sijainnista, ajakaa pwd heti sisäänkirjautumisen jälkeen ja ls nähdäksenne kansionne — tai kysykää tuelta.

Käytettävissä olevat työkalut

Seuraavat työkalut ovat yleensä esiasennettuina ympäristössänne. Valikoima voi vaihdella hieman palvelinten välillä — ajakaa which <työkalu> nähdäksenne, onko työkalu käytettävissä, esimerkiksi which git.

• Editorit: nano, vim, joe
• Versionhallinta: git, tig
• PHP / WordPress: wp (WP-CLI), composer, php
• Tiedostot ja siirto: rsync, curl, wget, zip, unzip, scp, sftp
• Terminaali: tmux (useita istuntoja / säilytä istunto katkaisun jälkeen)

Yleisiä tehtäviä

WordPress ja WP-CLI

WP-CLI:tä ajetaan WordPress-hakemistostanne (yleensä web/):

cd web
wp core version
wp plugin list
wp plugin update --all
wp search-replace 'http://gammal.se' 'https://ny.se' --dry-run
wp db export backup.sql

Tietokantayhteys: WP-CLI lukee tietokantatietonne tiedostosta wp-config.php. WordPress-asennuksissamme käytetään arvoa DB_HOST = '127.0.0.1', joka toimii suoraan. Jos wp-config.php-tiedostossanne on sen sijaan DB_HOST = 'localhost' eikä WP-CLI tavoita tietokantaa, muuttakaa rivi arvoon 127.0.0.1, niin se toimii.

Composer

cd web
composer install
composer require monolog/monolog
composer update

Composer hakee paketit osoitteesta packagist.org ja toimii suoraan ympäristössänne.

Git-julkaisu

cd web
git clone https://github.com/dittkonto/dittprojekt.git .
git pull            # hae viimeisimmät muutokset

Pakkaaminen / purkaminen ja synkronointi

unzip arkiv.zip
zip -r backup.zip web/
rsync -av web/ private/backup-web/

tmux (säilytä istunto)

tmux              # käynnistä istunto
# (katkaise yhteys painamalla Ctrl-b ja sitten d)
tmux attach       # yhdistä uudelleen myöhemmin

Rajoitukset

Ympäristö on tarkoituksellisesti rajattu turvallisuussyistä:

• Ei root/sudo eikä järjestelmäpakettien asennuksia.
• Ei omia palveluita/daemoneita tai portteja kuuntelevia prosesseja. Älkää käyttäkö kuorta pitkäikäisten palvelinten ajamiseen.
• Ajastetut tehtävät (cron) hallitaan hallintapaneelissa, ei kuoren kautta.
• tmux toimii tavalliseen käyttöön; edistyneet interaktiiviset toiminnot voivat olla rajoitettuja jail-ympäristössä.
• Pääsette käsiksi vain omiin tiedostoihinne ja omaan tietokantaanne.

Jos tarvitsette täyden hallinnan — root-oikeudet, omat palvelut, vapaasti valittavat järjestelmäpaketit — VPS on oikea tuote jaetun webhotellin sijaan.

Tuki

Jos jokin ei toimi odotetusti tai teiltä puuttuu jokin työkalu, ottakaa yhteyttä tukeen, niin autamme teitä.