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

AI-agendi (Claude Code, Codex, Antigravity) ühendad oma Virtuaal.com-i veebimajutusega väljastpoolt: agent töötab Sinu arvutis või eraldi VPS-is ja ühendub serveriga SSH kaudu pordil 38307. cPaneli funktsioone (e-post, andmebaasid, DNS) haldab agent API-tokeniga. SSH-ligipääs ja cPaneli API on olemas kõigis pakettides: Standard, Äri ja Pro.

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. See juhend näitab, kuidas agent lihtsalt ja turvaliselt ühendada.

Kus agent töötab?

Tehisaruagent on tarkvara, mis töötab väljaspool Sinu veebimajutust ja ühendub sinna vajadusel - täpselt nii, nagu Sa 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 kahel viisil:

• SSH kaudu: failid, kood, veebilehed.
• cPaneli API kaudu: e-post, andmebaasid, DNS.

Agent saab hallata kõike, milleks Sinu kontol on õigused.

Millise tööriista valida?

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

Kuidas agent veebimajutusega ühendada?

Kiire algus on kahesammuline. Enne alustamist vaata, et eeldused (kast üleval) on täidetud.

Samm 1 - Ühenda tööriist serveriga

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

1. Graafilises rakenduses (nt VS Code Remote-SSH) sisesta need andmed ühenduse seadetesse.

2. Käsureal saad need salvestada faili ~/.ssh/config:

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

3. 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.

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."
• "Refaktoreeri minu aeglane PHP-kood nii, et lehed laadiksid kiiremini."
• "Uuenda lehe vananenud JS- ja PHP-sõltuvused ning kontrolli, 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-vea."
• "Muuda lehe PHP-versiooni .htaccess-faili kaudu (cPaneli „Vali PHP versioon“ on graafiline liides)."
• "Seadista lehe koopia alamdomeenile, et saaksin muudatusi enne avaldamist testida."

Millised Virtuaal.com-i juhendid aitavad agenti?

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, Viga 503, 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.

Kuidas paigaldada käsureaagent?

Kui eelistad terminali, paigalda agent oma arvutisse:

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.

Kuidas luua cPaneli API-token?

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

cPanelTurvalisusHalda API-tokeneid

1. Logi cPanelisse ja ava jaotises Turvalisus valik Halda API-tokeneid.

2. Vajuta Loo, anna tokenile nimi (nt ai-agent) ja salvesta.

3. Kopeeri token kohe - seda näidatakse ainult üks kord.

Kuidas tokeniga cPaneli funktsioone kasutada (UAPI)?

Tokeniga saab cPaneli funktsioone kasutada kahel viisil.

1. 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&quota=1024'

2. 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:

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.

Kuidas anda agendile ainult vajalik ligipääs?

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

• Loo agendile eraldi SSH-võti, ä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.

Mida teha, kui midagi ei tööta?

Kokkuvõte - millal mida kasutada?

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