AI-agendi (Claude Code, Codex) ühendamine oma veebimajutusega

Tehisaruagendid nagu Claude, OpenAI Codex ja Google'i Antigravity oskavad sinu eest faile hallata, koodi kirjutada, veebilehti (sh WordPressi) hooldada ja muudatusi serverisse üles laadida. Kõik Virtuaal.com veebimajutuse paketid (Standard, Äri ja Pro) sisaldavad SSH-ligipääsu ja cPaneli API-t, mille kaudu saab agendi oma veebimajutusega ühendada. See juhend näitab, kuidas seda lihtsalt ja turvaliselt teha.

Kõige tähtsam: kus agent "elab"

Tehisaruagent on tarkvara, mis töötab väljaspool sinu veebimajutust ja ühendub sinna vajadusel — täpselt nii, nagu sina ise ühendud. Sinu veebimajutus on see, mida agent haldab, mitte koht, kus agent töötab. Agendil on kaks head kodu:

• Sinu enda arvutis (soovitatav, lihtsaim). Agent töötab sinu arvutis ja ühendub serveriga siis, kui annad talle ülesande. Sobib igapäevaseks tööks.
• Eraldi virtuaalserveris (VPS). Kui soovid agenti, mis töötab pidevalt või automaatselt ka siis, kui sinu arvuti on välja lülitatud, paigalda see eraldi VPS-i. Selleks on meil eraldi lahendus aiserver.ee.

Mõlemal juhul ühendub agent sinu veebimajutuse kontoga väljastpoolt — SSH kaudu (failid, kood, veebilehed) ja cPaneli API kaudu (e-post, andmebaasid, DNS). Agent saab hallata kõike, milleks sinu kontol on õigused.

Vali endale sobiv tööriist

Sa ei pea olema arvutiekspert. Lihtsaim viis on kasutada graafilist rakendust, kus agent on juba sees:

• Claude'i rakendus — Anthropicu töölauarakendus (macOS ja Windows). Selle Code-vahekaart on mõeldud just failide ja koodi haldamiseks: graafiline kasutajaliides, sisseehitatud failiredaktor, terminali kasutama ei pea. Vaata Claude Desktopi juhendit.
• AI-toega koodiredaktorid — Cursor, Windsurf või VS Code (koos tehisaru-laiendusega). Need oskavad ühenduda serveriga SSH kaudu (nt VS Code'i "Remote-SSH"), nii saad faile otse redigeerida ja paluda agendil muudatusi teha.
• Käsurida (edasijõudnutele) — kui eelistad terminali, on olemas ka käsureaagendid: Claude Code, OpenAI Codex CLI ja Google'i Antigravity CLI. Vaata käsurea juhiseid allolevast edasijõudnute osast.

Soovitus: tavakasutajale on graafiline rakendus (Claude'i rakendus, Cursor või Windsurf) kõige mugavam ja projektide haldamiseks ka kõige otstarbekam. Käsurida on alati olemas, kuid igapäevaseks tööks pole see vajalik.

Kiire algus

Eeldused

• SSH-ligipääs on cPanelis aktiveeritud ja sul on SSH-võtmepaar olemas. Kui ei ole, vaata juhendit SSH/SFTP ligipääsu loomine.
• Tehisaruteenuse tasuline tellimus või API-võti. Tasuta paketid agenti üldjuhul ei sisalda.
• Valitud tööriist (Claude'i rakendus, Cursor, Windsurf või käsureaagent) on sinu arvutisse paigaldatud.

Samm 1 — Ühenda tööriist serveriga

Virtuaali serveriga ühendutakse oma domeeninime kaudu pordil 38307 (mitte tavapärasel pordil 22). Vajalikud andmed:

• Aadress (Host): sinudomeen.ee
• Kasutaja (User): sinu cPaneli kasutajanimi
• Port: 38307
• Võti: sinu privaatvõti

Graafilises rakenduses (nt VS Code Remote-SSH) sisesta need ühenduse seadetesse. Käsureal saad need salvestada faili ~/.ssh/config:

Host minuserver
    HostName sinudomeen.ee
    User kasutajanimi
    Port 38307
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes

Pärast seda saad ühenduda lihtsalt nimega minuserver.

Samm 2 — Anna agendile esimene ülesanne

Kui ühendus on loodud, võid agendil paluda serveriga suhelda. Näiteks:

Ühendu serveriga "minuserver" ja näita, mis failid on kaustas public_html.

Agent loeb tulemust ja teeb sellest kokkuvõtte. Sa näed iga toimingut, mille agent teha soovib, ja saad selle kinnitada või tagasi lükata. Nii säilib sul kontroll toimuva üle.

Praktilised näited — mida agendil paluda

Mõned reaalsed ülesanded, mida tehisaruagent sinu eest teha saab. Sõnasta agendile soov tavakeeles — ülejäänu teeb tema.

WordPressi leht

• "Leia ja paranda PHP-viga, mis rikub minu kontaktivormi."
• "Tuvasta, milline plugin põhjustab valge ekraani, ja lahenda konflikt."
• "Puhasta häkitud lehelt pahavara ja tugevda seejärel turvalisust."
• "Kiirenda aeglast lehte: optimeeri pildid WebP-vormingusse, korrasta andmebaas, seadista vahemälu."
• "Uuenda korraga 20 blogipostitust — asenda vana telefoninumber ja paranda katkised lingid."
• "Lülita sisse ja seadista LiteSpeed Cache (LSCache), et leht laadiks kiiremini."

Eritellimuslik (custom) veebileht

• "Paranda viga, kus broneerimisvorm saadetakse ära, aga e-kirja ei tule."
• "Lisa minu PHP-lehele küpsistega nõustumise riba ja uus kontaktivorm."
• "Refaktoori minu aeglane PHP-kood nii, et lehed laadiksid kiiremini."
• "Uuenda lehe vananenud JS- ja PHP-sõltuvused ning testi, et midagi ei läinud katki."
• "Vii minu viimased Git-muudatused turvaliselt avalikku kausta public_html."

Uue lehe või lahenduse loomine

• "Ehita lihtne ettevõtte maandumisleht ja pane see minu domeenile üles."
• "Tee minu brošüüri sisust kiire staatiline veebileht ja avalda see."
• "Loo väike andmebaasipõhine rakendus (PHP + MySQL), näiteks broneerimis- või päringuvorm."
• "Seadista „tulekul“-leht, kuni päris lehte ehitan."

Majutuse ja cPaneli haldus

• "Loo need e-posti kontod, lisa edasisuunamised ja määra postkasti mahud."
• "Seadista igaöine ajastatud töö (cron), mis varundab MySQL-andmebaasi ja teatab tõrkest e-posti teel."
• "Loo uus MySQL-andmebaas ja impordi sinna see .sql-fail."
• "Analüüsi minu vea- ja ligipääsulogisid ning ütle, miks leht annab 500-viga."
• "Muuda lehe PHP-versiooni .htaccess-faili kaudu (cPaneli „Select PHP Version“ on graafiline liides)."
• "Seadista lehe koopia alamdomeenile, et saaksin muudatusi enne avaldamist testida."

Seotud Virtuaal.com-i juhendid

Agent saab tugineda meie oma juhenditele — palu tal vajalik läbi vaadata ja samme järgida:

• WordPressi kiirendamine: LiteSpeed (LSCache) moodul, LSCache'i eelseaded, aeglase halduspaneeli kiirendamine, andmebaasi optimeerimine
• PHP-versioon ja seaded: PHP versiooni ja seadistuste muutmine, PHP 500 vead, PHP-mälulimiidid
• Turvalisus ja pahavara: pahavara eemaldamine, kui leht on häkitud, Imunify
• Jõudlus ja ressursid: X-Ray jõudlustuvastus, 503 Resource Limit, Redise vahemälu
• Andmebaas: andmebaasi loomine, suure andmebaasi import
• Automatiseerimine ja arendus: ajastatud tööd (cron), Giti kasutamine, Node.js-i rakendus
• E-post ja DNS: e-posti konto loomine, TXT-kirje (DNS-tsooni redaktor), Let's Encrypti SSL

Edasijõudnutele

Järgnev osa on tehnilisem ja eeldab terminali ning cPaneli baasoskusi.

Käsureaagendi paigaldus

Kui eelistad terminali, paigalda agent oma arvutisse:

• Claude Code (Anthropic): npm install -g @anthropic-ai/claude-code, käivita käsuga claude.
• OpenAI Codex CLI: npm install -g @openai/codex, logi sisse käsuga codex login.
• Google'i Antigravity CLI: Google'i tööriist (asendas varasema Gemini CLI). Paigalda Antigravity ja logi oma Google'i kontoga sisse.

Mida agent sinu veebimajutusega teha saab

Agent saab teha kõiki kasutajataseme toiminguid — kõike, mida sa ise cPanelis või SSH kaudu teha saad. Allolev tabel võtab võimalused kokku.

cPanel API-token ja UAPI

Selleks, et agent saaks cPaneli funktsioone (e-post, andmebaasid, DNS) hallata ilma parooli kasutamata, loo eraldi API-token:

1. Logi cPanelisse ja ava jaotises Turvalisus valik Halda API-tunnuseid.
2. Vajuta Loo, anna tokenile nimi (nt ai-agent) ja salvesta.
3. Kopeeri token kohe — seda näidatakse ainult üks kord.

Tähtis: hoia tokenit nagu parooli. Token annab ligipääsu sinu cPaneli kontole. Ära salvesta seda koodi sisse ega avalikku kohta.

Tokeniga saab cPaneli funktsioone kasutada kahel viisil. Kaugpäringuna pordil 2083:

curl -H 'Authorization: cpanel KASUTAJA:TOKEN' \
  'https://sinudomeen.ee:2083/execute/Email/add_pop?email=info&password=PAROOL&domain=sinudomeen.ee"a=1024'

Või SSH kaudu serveris oleva uapi käsuga:

ssh minuserver "uapi Email add_pop email=info password=PAROOL domain=sinudomeen.ee quota=1024"

Mõned kasulikud UAPI-funktsioonid, mida agendile mainida:

• E-post: Email::add_pop, Email::list_pops, Email::passwd_pop
• Andmebaas: Mysql::create_database, Mysql::create_user, Mysql::set_privileges_on_database
• DNS: DNS::add_zone_record (nt TXT-kirje SSL-sertifikaadi valideerimiseks)

NB: cPaneli API-token annab ligipääsu ainult sinu konto funktsioonidele. OS- ja serveritaseme muudatusi sellega teha ei saa — see on jagatud veebimajutuse loomulik piir.

Miks agenti ei tasu käivitada jagatud veebimajutuses endas

Jagatud veebimajutus on piiratud keskkond: see on mõeldud veebilehtede teenindamiseks, mitte pidevalt töötavate programmide jaoks, ja OS-tasandi muudatusi seal teha ei saa. Seetõttu:

• Veebimajutuses kehtivad protsessi- ja mälupiirangud. Agent, mis käivitab korraga palju alamprotsesse, võib saada vea "fork: Resource temporarily unavailable".
• Pidevalt ehk 24/7 töötavat agenti ei saa seal usaldusväärselt töös hoida.
• Server on agendile sihtmärk, mida hallata — agendi enda kodu on sinu arvuti või VPS.

Kui vajad agenti, mis töötab pidevalt, või soovid täielikku kontrolli serveri üle (root-ligipääs, OS-tasandi muudatused), kasuta eraldi virtuaalserverit (VPS) — vaata aiserver.ee.

Turvalisus — anna agendile ainult vajalik

Tehisaruagent teeb toiminguid sinu nimel, seetõttu rakenda vähima privileegi põhimõtet:

• Loo agendile eraldi SSH-võti, mitte ära kasuta oma igapäevast võtit. Nii saad agendi ligipääsu vajadusel kohe tühistada.
• Piira võtit failis authorized_keys. Saad lubada ühenduse ainult kindlalt IP-aadressilt (from="...") ja keelata pordiedastuse (no-port-forwarding).
• Loo agendile eraldi cPaneli API-token ja kustuta see, kui seda enam ei vaja.
• Ära salvesta võtmeid ega tokeneid koodihoidlasse (nt Git) ega jaga neid kolmandate osapooltega.
• Kontrolli iga toimingut, mille agent teha soovib, enne kinnitamist.

Tõrkeotsing

• Ühendus ei õnnestu: kontrolli, et kasutad porti 38307 ja et SSH on cPanelis aktiveeritud.
• Agendi autentimine ebaõnnestub: kontrolli, et tellimus on aktiivne ja API-võti õige. Vale keskkonnamuutuja (nt ANTHROPIC_API_KEY) võib tellimusepõhise sisselogimise tühistada.
• "fork: Resource temporarily unavailable": jõudsid jagatud veebimajutuse protsessipiiranguni — see on märk, et agent tuleks viia oma arvutisse või VPS-i.

Kokkuvõte — millal mida kasutada

• Igapäevane töö (failid, kood, WordPress, üleslaadimine): agent sinu arvutis (Claude'i rakendus, Cursor või Windsurf) + SSH-ühendus veebimajutusega. Lihtne ja turvaline.
• cPaneli haldus (e-post, andmebaas, DNS): cPanel API-token + UAPI.
• Pidev või automaatne töö ja täielik kontroll serveri üle: agent eraldi VPS-is — vaata aiserver.ee.

Küsimuste korral võta ühendust meie klienditoega — aitame hea meelega.