Fluxheim/Documentation/Sites statiques

Sites statiques

Servez HTML, CSS, images et téléchargements directement depuis le disque. C'est le mode Fluxheim le plus simple.

Quand l'utiliser

Utilisez l'hébergement statique pour la documentation, les pages produit, les téléchargements et les sites qui n'ont pas besoin de code applicatif à chaque requête.

  • ETag et les requêtes conditionnelles réduisent le trafic répété.
  • Les byte ranges fonctionnent pour les gros fichiers.
  • Les dotfiles doivent rester refusés dans les racines publiques.

Exemple de site statique

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

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

Options principales

OptionUtilisez-le quand
rootVous voulez une racine de systeme de fichiers bornee pour les fichiers publics.
index_filesUn repertoire doit se resoudre vers un fichier d'index.
deny_dotfilesLes fichiers caches ne doivent jamais devenir publics par accident.
directory_listingVous publiez volontairement des index de fichiers de type depot.

Exemple de listing de depot

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

Français