Fluxheim/Documentos/Sites estáticos

Sites estáticos

Sirva HTML, CSS, imagens e transferências diretamente do disco. Este é o modo Fluxheim mais simples.

Quando usar

Use static hosting para documentação, páginas de produto, transferências e sites que não precisam de código de aplicação em cada request.

  • ETag e requests condicionais reduzem tráfego repetido.
  • Byte ranges funcionam para ficheiros maiores.
  • Dotfiles devem continuar negados em public roots.

Exemplo de site estático

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

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

Opções principais

OpçãoUse quando
rootQuer um filesystem root limitado para ficheiros públicos.
index_filesUm diretório deve resolver para um index file.
deny_dotfilesHidden files nunca devem tornar-se públicos por acidente.
directory_listingPublica intencionalmente índices de ficheiros estilo repositório.

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

Português