---
title: Statico
description: Hosting statických webů (Astro Starlight, Next.js, Docusaurus, Vitepress, čisté HTML)
---

## Úvod

**Statico** hostuje statické weby: složku s HTML, CSS, JavaScriptem a obrázky. Složku vyrobí váš build nástroj, jeden příkaz ji nasadí a web je online s TLS a adresou zdarma.

<ul style="display:flex;flex-wrap:wrap;gap:.6rem 1.4rem;list-style:none;padding:0;margin:1.2rem 0">
<li style="display:flex;align-items:center;gap:.5rem;margin:0"><span aria-hidden="true" style="width:22px;height:22px;display:inline-block;background:currentColor;-webkit-mask:url(/img/logos/astro.svg) center/contain no-repeat;mask:url(/img/logos/astro.svg) center/contain no-repeat"></span>Astro Starlight</li>
<li style="display:flex;align-items:center;gap:.5rem;margin:0"><span aria-hidden="true" style="width:22px;height:22px;display:inline-block;background:currentColor;-webkit-mask:url(/img/logos/nextdotjs.svg) center/contain no-repeat;mask:url(/img/logos/nextdotjs.svg) center/contain no-repeat"></span>Export z Next.js</li>
<li style="display:flex;align-items:center;gap:.5rem;margin:0"><span aria-hidden="true" style="width:22px;height:22px;display:inline-block;background:currentColor;-webkit-mask:url(/img/logos/docusaurus.svg) center/contain no-repeat;mask:url(/img/logos/docusaurus.svg) center/contain no-repeat"></span>Docusaurus</li>
<li style="display:flex;align-items:center;gap:.5rem;margin:0"><span aria-hidden="true" style="width:22px;height:22px;display:inline-block;background:currentColor;-webkit-mask:url(/img/logos/vitepress.svg) center/contain no-repeat;mask:url(/img/logos/vitepress.svg) center/contain no-repeat"></span>VitePress</li>
<li style="display:flex;align-items:center;gap:.5rem;margin:0"><span aria-hidden="true" style="width:22px;height:22px;display:inline-block;background:currentColor;-webkit-mask:url(/img/logos/vite.svg) center/contain no-repeat;mask:url(/img/logos/vite.svg) center/contain no-repeat"></span>Vite (React, Vue, Svelte)</li>
<li style="display:flex;align-items:center;gap:.5rem;margin:0"><span aria-hidden="true" style="width:22px;height:22px;display:inline-block;background:currentColor;-webkit-mask:url(/img/logos/html5.svg) center/contain no-repeat;mask:url(/img/logos/html5.svg) center/contain no-repeat"></span>Čisté HTML</li>
</ul>


## Vlastnosti

- **Bez výpadku.** Stará verze odpovídá, dokud není nová kompletní. Nasazení, které selže, nic nezmění.
- **Rychlý upload.** Posílají se jen změněné soubory, malé pohromadě v archivech.
- **Hezké adresy a přesměrování.** `about.html` je i `/about/` a soubor `_redirects` nastavuje přesměrování.
- **Veřejný, nebo privátní.** Ve výchozím stavu veřejný. Privátní web vyžaduje [API token](/cs/docs/apikeys/).

## Nasazení MPA

MPA (vícestránková aplikace) je výchozí: web se stránkou pro každou cestu, například Astro Starlight, Docusaurus, VitePress nebo export z Next.js. Nepotřebuje žádné další volby. Nasazuje se z [CLI](/cs/docs/cli/), takže to zapadne do jakékoli CI pipeline, příkazem nebo konfiguračním souborem.

### Příkazem

Web sestavte a nasaďte složku:

```bash
npm run build
futrou statico deploy --include ./dist
```

První spuštění web vytvoří a pojmenuje podle aktuální složky (nebo zadejte název). Další spuštění pošlou jen změny a když se nic nezměnilo, neudělají nic. Příkaz vypíše, kde je web živý.

`./dist` dá soubory složky do kořene webu. Přidejte `--dry-run`, abyste nejdřív viděli, co se změní.

### Přes futrou.yml

Dejte web ke svému kódu. `futrou deploy` jednou spustí instalační příkaz, při každém spuštění build a výsledek nahraje:

```yaml
# futrou.yml
workspace: acme
project: website
installCommand: npm ci          # jednou na zařízení
buildCommand: npx astro build   # před každým nasazením

statico:
  docs:
    include:
      ./dist: true
      ./dist/**/*.map: false
```

```bash
futrou deploy
```

V CI použijte `futrou deploy -y` a secret `FUTROU_API_TOKEN`.

## Nasazení SPA

SPA (single page aplikace) odpovídá na každou cestu souborem `index.html` a přebírá ji router v prohlížeči, jako aplikace v Reactu, Vue nebo Svelte sestavené Vite. Potřebuje dvě další volby: záložní soubor a jeho stav.

```bash
futrou statico deploy --include ./dist --fallback-file /index.html --fallback-status 200
```

Nebo ve `futrou.yml`:

```yaml
statico:
  app:
    include:
      ./dist: true
    fallbackFile: /index.html
    fallbackStatus: 200
```

Záložní soubor se hledá po složkách, takže aplikace se složkou pro každý jazyk dostane vlastní `index.html` pro každý.

## Výběr souborů

Include je soubor, složka nebo glob (`*`, `**`, `{a,b}`), relativně k místu spuštění, nebo absolutní cesta. Includy se spouští **popořadě**, takže můžete složku zahrnout a pak z ní něco vynechat:

| Volba | Význam |
| --- | --- |
| `--include ./dist` | Soubory z `./dist` v kořeni. |
| `--include ./dist:docs` | Tytéž soubory pod `docs/`. |
| `--include ./robots.txt:seo/robots.txt` | Jeden soubor, přesunutý. |
| `--exclude './dist/**/*.map'` | Vynechá source mapy. |

Skryté soubory a složky (například `.env` a `.git`) a soubory `.map` se při nalezení ve složce nebo globem nikdy nenahrávají, takže tajemství nemůže odejít omylem. Chcete-li je zahrnout, uveďte je výslovně, třeba `--include ./dist/.well-known`. Váš konfigurační soubor se také nikdy nenahrává.

## Přesměrování

Dejte do kořene webu soubor `_redirects` s jedním pravidlem na řádek:

```text
/old-page   /new-page   301
/blog/*     /news/:splat
```

Stav je výchozně `302`, `:name` odpovídá jednomu segmentu cesty a `*` zbytku (v cíli `:splat`). Vyhrává první odpovídající pravidlo.

## Jak se soubory servírují

Pro každý požadavek Statico hledá přesný soubor, pak `index.html` složky, pak nejbližší `404.html` (hledá se od požadované složky nahoru, takže fungují vícejazyčné weby). Přijímají se jen `GET` a `HEAD`.

| Soubory | `Cache-Control` |
| --- | --- |
| Stránky (`.html` a cesty bez přípony) | `no-cache` |
| Assety (kód, obrázky, fonty, audio, video, dokumenty) | `public, max-age=31536000, immutable` |
| Vše ostatní | `public, max-age=0, must-revalidate` |

Dávejte assetům názvy s hashem (většina build nástrojů to dělá), aby nové nasazení mělo nové URL.

## Vlastní domény

Každý web funguje na své adrese `statico-xxx.futrou.cloud`. Pro vlastní doménu vytvořte ve stejném projektu [HTTP proxy](/cs/docs/proxy/#http) s webem jako cílem. Viz [Proxy](/cs/docs/proxy/).

## Limity

Velikost webu, počet souborů a další limity najdete na stránce [Limity](/cs/docs/limits/#statico).

## Šablony

Hotové projekty s `futrou.yml` najdete v repozitáři se šablonami:

[https://github.com/futrou/futrou-templates](https://github.com/futrou/futrou-templates)