Web spravovaný AI agentem – návod pro vás i pro vašeho asistenta

← Nápověda k hostingu

Web u nás může za vás upravovat váš AI asistent (Claude, ChatGPT a podobní), který umí pracovat se soubory a příkazovým řádkem. Vy mu řeknete, co chcete změnit, on web upraví a nahraje. Tato stránka má dvě části: pro vás a pro vašeho agenta. Tu druhou mu můžete rovnou dát přečíst, nebo mu pošlete odkaz na itrady.cz/llms.txt.

Pro vás: jak to funguje

  • Agent dostane stejné přístupy jako člověk: server, uživatele a heslo pro SFTP (údaje máte v našem e-mailu). Heslo zadávejte jen tam, kde ho agent opravdu potřebuje k nahrávání, a nesdílejte konverzace, ve kterých je.
  • U běžných tarifů je web statický: HTML, CSS, JavaScript a obrázky. Agent tedy může web postavit a měnit, jak chce, ale na serveru nespustí žádný program (PHP, databázi, Node). Díky tomu je web rychlý a nedá se „hacknout“ přes starý plugin.
  • Tarif „Pro AI agenta“ navíc spouští PHP a má vlastní databázi. Agent tak může postavit i web, který něco umí, třeba ukládá přihlášky nebo rezervace. Za kód a data takové aplikace ale odpovídáte vy, viz oddíl o tarifu níže.
  • Kontaktní formulář u běžných tarifů zapneme na požádání, napište nám. Agent ho pak jen vloží do stránky podle návodu k formuláři.
  • Držte si vlastní kopii webu. U webu nahrávaného přes SFTP máte kopii vždy ve složce, ze které nahráváte (nebo v repozitáři agenta).
  • Kdyby se něco pokazilo, napište nám.

Pro vašeho agenta: pravidla serveru

Server:      sftp.itrady.cz
Port:        22
Protokol:    SFTP (bez shellu; ForceCommand internal-sftp)
Uživatel:    web_<slug>  (přesně podle e-mailu klienta)
Kořen webu:  /web  (po přihlášení je tam rovnou; výš nevidí)
Úvodní str.: /web/index.html  (u tarifu „Pro AI agenta“ i index.php, viz níže)
Otisk:       ED25519 SHA256:22nvqPGbVOc/7S6GGcJ1m3/QcRfd2NcSm+I/SDZeIg0

Co funguje: sftp (vč. put -r), scp -r jen s OpenSSH 9 a novějším (jede přes SFTP; ověř ssh -V). Co nefunguje: rsync, ssh s příkazy, jakýkoli shell. Účet má jen SFTP.

Obsah webu:

  • Běžné tarify: jen statické soubory: .html, .css, .js, obrázky (.jpg, .png, .webp, .svg), .pdf, písma. PHP, CGI ani serverové skripty se nespustí (jedinou výjimkou je formulář, jehož serverovou část zapínáme my).
  • Tarif „Pro AI agenta“: navíc PHP 8.4 a databáze MariaDB, pravidla viz oddíl o tarifu níže.
  • HTTPS a certifikát řeší server automaticky. Neřeš ho.
  • Mezipaměť (hlavička Cache-Control): HTML 5 minut, /assets/ 1 den, /_astro/ 1 rok (jen weby z našeho systému), ostatní soubory podle Last-Modified/ETag. Má-li být změna CSS/JS/obrázku vidět hned, změň název souboru (např. styl.20261001.css).
  • Vlastní 404: stačí 404.html v kořeni webu (server ji používá automaticky).
  • .htaccess v omezeném rozsahu: funguje Redirect, RewriteRule, ErrorDocument, Header, AddType, DirectoryIndex. Nefunguje: hesla (AuthType/Require), php_value, spouštění skriptů, Options +ExecCGI/+FollowSymLinks. Soubory .ht*, .git, .env, .user.ini server nikdy nevydá. Na přesměrování a 404 nic dalšího nepotřebuješ.
  • Kontaktní formulář (běžné tarify): <form method="post" action="/odeslat.php"> přesně podle /napoveda/formular/ (povinná pole jmeno, email, zprava, souhlas; past web; cas vyplněný JavaScriptem; návrat zpet). Vlastní pole NEpojmenovávej web, cas ani zpet. odeslat.php nenahrávej, dodává ho server. Formulář u webu zapíná ITRADY na požádání majitele. Když /odeslat.php vrací 403/404, ještě zapnutý není.

Postup, který doporučujeme:

  1. Stáhni si aktuální obsah /web do pracovní složky (sftp: get -r /web) a pracuj na kopii.
  2. Změny ověř lokálně (otevři index.html v prohlížeči, zkontroluj odkazy).
  3. Nahraj jen změněné soubory (put), u nových složek put -r.
  4. Nic nemaž hromadně. Když je potřeba smazat, smaž konkrétní soubory.
  5. Ověř výsledek na živém webu (HTTPS) a u nových assetů použij nový název souboru.

Statistiky návštěvnosti: https://<doména>/webstats/, přihlášení HTTP Basic: uživatel = název domény (např. vasedomena.cz), heslo je jiné než k SFTP (majitel ho má na jednorázovém odkazu). Strojově čitelná verze (JSON) se připravuje, zatím jen HTML přehled.

Místo na disku: technické kvóty nejsou, platí rozumné užívání (fair use). Obrovské soubory (videa, archivy) patří jinam, třeba na YouTube.

Tarif „Pro AI agenta“: PHP a databáze

Tarif „Pro AI agenta“ se od ostatních liší tím, že web nemusí být jen statický: server u něj spouští PHP a web má vlastní databázi. Běžné tarify zůstávají statické. Který tarif web má, poznáte z uvítacího e-mailu: u tarifu „Pro AI agenta“ v něm je oddíl DATABÁZE s údaji pro připojení.

Pro vás: za server odpovídáme my, za kód a data aplikace vy. Proto agentovi zadejte hlavně tři věci: administrace musí být za heslem, vstupy z formulářů musí být ošetřené a ukládat se má jen to, co web opravdu potřebuje. Export databáze (dump) vám na požádání pošleme. Agent může do aplikace přidat i vlastní export dat, třeba CSV v administraci.

Pro agenta:

PHP:         8.4, vlastní izolovaný proces webu
Databáze:    MariaDB 11.8 (kompatibilní s MySQL)
Host:        localhost (unixový socket)
Uživatel:    web_<slug>  (stejný jako pro SFTP)
Heslo:       žádné – server ověřuje systémový účet webu
Název DB:    podle uvítacího e-mailu (oddíl DATABÁZE)
Zvenku:      do databáze se připojit nedá

Připojení z PHP (PDO):

$db = new PDO('mysql:host=localhost;dbname=<databáze z e-mailu>;charset=utf8mb4', '<uživatel webu>', '');

NEpoužívej 127.0.0.1, databáze neposlouchá na síti. Připojuj se přes localhost.

  • Heslo k databázi do kódu nepiš, žádné není. Ve webu tak nezůstane nic, co by šlo ukrást.
  • Tabulky založ instalačním PHP skriptem: nahraj ho, jednou spusť a hned ho smaž. Import hotového dumpu (SQL) udělá ITRADY na požádání majitele.
  • Dotazy jen připravené (prepare a parametry). SQL nikdy neskládej z textu, který poslal návštěvník.
  • Úvodní stránka je index.php nebo index.html. Když jsou ve složce oba, má přednost index.php.
  • Administraci chraň přihlášením v aplikaci. AuthType a Require v .htaccess nefungují (server vrátí chybu 500). Redirect, RewriteRule a ErrorDocument fungují.
  • Ukládej jen nutná data, u osobních údajů dvojnásob.
  • E-maily z aplikace posílej PHP funkcí mail(). Funguje až po zapnutí na požádání majitele, k tomu pošleme pár záznamů do DNS. Odesílá se z webform@<doména>, nejvýš 30 za hodinu a 100 za den. Kód žádné heslo nepotřebuje.
  • Pravidelné úlohy zapíná ITRADY na požádání majitele.
  • Kontaktní formulář zpracuj vlastním PHP. Sdílený /odeslat.php u tohoto tarifu není.
  • Nefunguje: shell, trvale běžící programy (Node.js, servery v Pythonu), přístup k jiným webům. Node.js používej jen u sebe na build a na server nahraj výsledek.

Co agent nedostane (a proč)

  • Žádný shell ani trvale běžící programy na serveru, a to ani u tarifu „Pro AI agenta“: server hostuje desítky webů a ty musí zůstat v bezpečí.
  • Žádný přístup k poště ani DNS: to nastavujeme my na požádání.
  • Heslo nikdy nepošleme agentovi ani do chatu. Dostává ho jen majitel webu přes jednorázový odkaz.