> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor Web

> Ajusta o Apache, o servidor web de todos os sites: o formato do registro de acessos, o modo de atender as conexões, as portas e as diretivas que valem para todos os domínios.

**Caminho no painel:** menu da esquerda > Configuração > cartão **Sistema** >
**Servidor Web**

| Campo | Vem com |
| - | - |
| **Formato do registro** | o formato abaixo, terminado em `%I %O` |
| **Módulo de multiprocessamento (MPM)** | **mpm\_event** |
| **Porta HTTP** e **Porta HTTPS** | `80` e `443` |
| **Diretivas globais do servidor web** | vazio |

As mudanças valem no minuto seguinte. O painel responde *"As configurações foram
atualizadas. As alterações terão efeito em alguns instantes."*

## Formato do registro

![Campo Formato do registro com o formato padrão, e o Módulo de multiprocessamento em mpm\_event](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/sistema-servidor-web.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=3b183d606afe065a57e328ce585b1411)

É a linha que diz o que o Apache grava a cada acesso. A referência dos códigos está
no link **aqui**, da própria tela, que abre a documentação do Apache.

O formato padrão, para escrever de volta se for preciso:

```
%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O
```

| O que foi salvo | Resultado |
| - | - |
| formato sem `%I %O` no fim | recusado: *"O formato do registro deve terminar com os parâmetros %I %O."* |
| aspas sem a barra invertida, como `"%r"` | **aceito pelo painel e recusado pelo Apache** |
| o que o botão **Padrão** preenche | **aceito pelo painel e recusado pelo Apache**, ver abaixo |

**As aspas precisam da barra invertida antes**, como `\"%r\"`: sem ela, a linha da
configuração do Apache fica quebrada.

> [!WARNING]
>
> **O botão Padrão do Formato do registro preenche um valor que quebra o Apache**
>
> ![O campo Formato do registro depois do botão Padrão, com códigos de página da web no lugar das aspas e do sinal de maior](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/sistema-servidor-web-padrao.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=d68b5db2a719fba06ffb0efa419d3371)
>
> Em vez de `\"` e `%>s`, o botão escreve `\&quot;` e `%&gt;s`, que são os
> códigos de página da web para as aspas e o sinal de maior. O painel aceita e
> salva. No minuto seguinte o Apache recusa a configuração nova.
>
> Os botões **Padrão** das portas funcionam: preenchem `80` e `443`.
>
> Para voltar ao padrão, **copie o formato do bloco acima** para o campo e salve.

### Quando o Apache recusa a configuração

Medido com o formato quebrado pelo botão **Padrão**:

* **Status do Sistema** > **Registro de Eventos** ganha uma linha *Crítico* com
  *"Web server (Apache) reported syntax errors."*, o número da linha e o motivo,
  como *"Unrecognized LogFormat directive %&"*
* **os sites continuam no ar**, com a configuração de antes
* **a lista de domínios continua com tudo verde** na coluna **S**: nenhum domínio
  mostra o triângulo de erro

Salvar o formato certo resolve no minuto seguinte, e a configuração volta a passar
no teste do Apache.

## Módulo de multiprocessamento (MPM)

É o modo como o Apache distribui as conexões entre os processos. A tela explica:
**mpm\_event** e **mpm\_worker** são confiáveis, com o **mpm\_event** mais rápido, e o
**mpm\_prefork** serve a programa antigo que precise dele.

**Trocar o MPM reinicia o Apache por completo** no minuto seguinte. Medido de
mpm\_event para mpm\_worker e de volta: nas duas vezes o Apache recomeçou, e os sites
responderam normalmente logo depois.

## Portas do servidor web

![Portas HTTP e HTTPS com o botão Padrão, e o editor de Diretivas globais do servidor web](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/sistema-servidor-web-portas.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=e1f99c19f58b410e81f16185973e065a)

As portas em que o Apache atende. A tela avisa que valor errado pode deixar **o
painel e todos os domínios** fora do ar.

| O que foi salvo | Resultado |
| - | - |
| Porta HTTP `81` | recusado: *"Porta inválida."* |

Fora das padrão, a porta precisa ficar entre **1024** e **65535**, como diz a tela.

## Diretivas globais do servidor web

O que se escreve aqui entra na configuração de **cada domínio** do servidor.

**Conferido:** com `Header set X-KB-Teste "1"` salvo, o site de um domínio de
cliente passou a responder com esse cabeçalho no minuto seguinte, e **o próprio
painel não**. Apagar a diretiva e salvar tirou o cabeçalho.

A tela avisa que diretiva com sintaxe errada impede o Apache de reiniciar.

Para uma diretiva que vale só para um domínio, o lugar é a aba **Configurações do
Apache** do domínio, em [Editar um domínio](/keyhelp-admin/editar-dominio).

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Linha *Crítico* com *"Web server (Apache) reported syntax errors."* depois de salvar esta tela** | formato do registro quebrado, pelo botão **Padrão** ou por aspas sem barra | escrever o formato do bloco acima e salvar |
| Mudei esta tela e nada mudou nos sites, e a lista de domínios está verde | o Apache recusou a configuração nova | procurar a linha *Crítico* no [Registro de Eventos](/keyhelp-admin/registro-de-eventos) |
| *"Porta inválida."* | a porta está fora do intervalo aceito | usar `80` e `443`, ou uma porta entre 1024 e 65535 |
| *"O formato do registro deve terminar com os parâmetros %I %O."* | o formato não termina com `%I %O` | acrescentar ` %I %O` no fim |
| Um cabeçalho ou regra aparece em todos os sites | há uma diretiva global | conferir **Diretivas globais do servidor web** |

## Ver também

* [Registros do servidor web](/keyhelp-admin/registros-do-servidor-web), a tela que lê o registro de acessos
* [Editar um domínio](/keyhelp-admin/editar-dominio), a aba **Configurações do Apache**, com as diretivas de um domínio só
* [Hora do Sistema](/keyhelp-admin/hora-do-sistema), cujo fuso o Apache só adota depois de reiniciar


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.