Fluxheim/Documentació/Llocs estàtics

Llocs estàtics

Serveix HTML, CSS, imatges i baixades directament des del disc. Aquest és el mode més senzill de Fluxheim.

Quan usar-ho

Usa hosting estàtic per a documentació, pàgines de producte, baixades i llocs que no necessiten codi d'aplicació en cada request.

  • ETag i requests condicionals redueixen el trànsit repetit.
  • Byte ranges funcionen per a fitxers grans.
  • Els dotfiles han de continuar denegats en roots públics.

Exemple de lloc estàtic

[[vhosts]]
name = "docs"
hosts = ["docs.example.com"]

[vhosts.web]
root = "/srv/docs"
index_files = ["index.html"]
deny_dotfiles = true

Opcions principales

OpcióUsa-ho quan
rootVols un filesystem root acotat per a fitxers públics.
index_filesUn directori ha de resolver a un index file.
deny_dotfilesEls hidden files nunca han de farse públics per accidente.
directory_listingPubliques intencionadament índexs de fitxers estil repositori.

Exemple de repository listing

[[vhosts.routes]]
name = "repo"
path_prefix = "/repo/"

[vhosts.routes.web]
root = "/srv/repository/public"
index_files = ["index.html"]

[vhosts.routes.web.directory_listing]
enabled = true
exact_size = false

Directory listings stay private-cache by default, skip symlink entries, and still prefer index files when they exist.

Català