---
title: "Laboratório: o seu próprio servidor web com um só comando"
domain: cloud-computing
level: foundations
duration: "30 min"
cost: "gratuito"
environment: "o próprio computador (Windows, macOS ou Linux) com Python 3 e um navegador web; não é necessária conta nem Internet"
lang: pt
source_hash: bac99256c88f
---

# Laboratório: o seu próprio servidor web com um só comando

## Objetivo
Transformar o próprio computador num pequeno servidor web, abrir a sua página num navegador e ver o servidor registar cada pedido que recebe. Verá com os seus próprios olhos o pedido e a resposta da lição.

## Objetivos
- Executar um pequeno servidor web no próprio computador e abri-lo num navegador.
- Ler uma linha de registo de um servidor e dizer o que significa cada parte.
- Explicar o que é um `404` e ver um a acontecer.

## Pré-requisitos
- [A lição deste módulo](lesson.pt.md).
- Saber abrir um terminal e mover-se entre pastas ([módulo 02](../02-terminal-basics/README.pt.md)).
- **Python 3**. Verifique escrevendo `python3 --version` (macOS e Linux) ou `python --version` (Windows) num terminal. Deverá apresentar algo como `Python 3.12.3`; qualquer versão 3.x serve.
- Um navegador web e um editor de texto simples (Bloco de Notas, TextEdit em modo de texto simples, gedit, VS Code…).

> [!WARNING]
> O servidor que se inicia só é acessível a partir do **próprio computador**, graças a `--bind 127.0.0.1`. Não retire essa opção e pare o servidor (Passo 5) quando terminar. O Windows pode perguntar se permite que o Python atravesse a firewall; com esta opção, pode escolher **cancelar** ou **negar** sem risco.

## Arquitetura
![Tudo acontece no seu computador. Um navegador com o endereço http://127.0.0.1:8000 envia um pedido, seta 1, a um servidor web do Python iniciado com python3 -m http.server 8000 --bind 127.0.0.1. O servidor lê index.html da pasta ~/my-website e devolve-o como resposta, seta 2. No terminal aparece uma linha de registo por cada pedido, por exemplo GET barra com estado 200 e GET barra x com estado 404. Uma nota diz que 127.0.0.1 significa este computador, pelo que mais ninguém consegue chegar ao servidor.](../../../assets/diagrams/webserver-lab-architecture.pt.svg)

*Figura 1. O navegador é o cliente, o programa Python é o servidor e o terminal mostra uma linha por cada pedido.*

## Passos

### Passo 1 — Criar uma pasta com uma página web (8 min)
Um servidor web precisa de ficheiros para servir. Cria-se uma pasta chamada `my-website` e coloca-se nela uma página.

No terminal, crie a pasta e entre nela:

```bash
mkdir ~/my-website
cd ~/my-website
```

No Windows PowerShell, as mesmas duas linhas funcionam tal como estão.

`mkdir` cria uma pasta, `~` é a pasta pessoal e `cd` entra nela. Agora abra o editor de texto e crie, dentro desta pasta, um ficheiro chamado **`index.html`** com exatamente este conteúdo:

```html
<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <title>O meu primeiro sítio web</title>
  </head>
  <body>
    <h1>Olá a partir do meu próprio servidor!</h1>
    <p>Esta página é um ficheiro no meu computador.</p>
  </body>
</html>
```

Isto é HTML. `<h1>` marca um título grande e `<p>` um parágrafo. O texto de `<title>` aparece no separador do navegador. Guarde o ficheiro, certificando-se de que o nome é `index.html` e não `index.html.txt` (o Windows oculta as extensões por predefinição; no Bloco de Notas, "Guardar como tipo" tem de ser "Todos os ficheiros").

Verifique se o ficheiro lá está:

```bash
ls
```

No Windows PowerShell, `ls` também funciona.

Resultado esperado:
```text
index.html
```

Porquê `index.html`? Quando alguém pede `/` a um servidor web, o servidor procura um ficheiro com este nome. É a página inicial predefinida.

### Passo 2 — Iniciar o servidor (5 min)
Ainda em `~/my-website`, execute:

```bash
python3 -m http.server 8000 --bind 127.0.0.1
```

No Windows, use `python` em vez de `python3` (ou `py`, se `python` não for encontrado).

Resultado esperado:
```text
Serving HTTP on 127.0.0.1 port 8000 (http://127.0.0.1:8000/) ...
```

Linha a linha, o comando significa:

- `python3 -m http.server` executa um pequeno servidor web que vem com o Python. Serve os ficheiros da pasta em que se está.
- `8000` é a **porta**, o número da porta (a lição explicou as portas).
- `--bind 127.0.0.1` faz com que escute apenas em `127.0.0.1`, o endereço que significa sempre "este computador".

O terminal parece agora "preso": não aparece nenhum prompt novo. É normal. O servidor está em execução à espera de pedidos, e esta janela de terminal é onde ele reporta. Deixe-a aberta.

> [!NOTE]
> Se aparecer `OSError: [Errno 98] Address already in use` (no Windows, uma mensagem sobre o endereço estar em uso), outro programa já utiliza a porta 8000. Escolha outra porta, por exemplo `8001`, e utilize-a em todos os sítios onde este laboratório diz 8000.

### Passo 3 — Visitar a página e ler o registo (8 min)
Abra o navegador web e escreva este endereço na barra de endereços:

```text
http://127.0.0.1:8000
```

Deverá ver uma página com o título grande "Olá a partir do meu próprio servidor!" e o separador intitulado "O meu primeiro sítio web". Acabou de usar o computador como cliente (o navegador) e como servidor (o Python) ao mesmo tempo.

Agora olhe para o terminal. Apareceram linhas novas. A data e a hora no ecrã serão diferentes, e o navegador pode mostrar também uma segunda linha para `/favicon.ico`, o pequeno ícone do separador que pede sempre:

```text
127.0.0.1 - - [07/Nov/2026 21:48:34] "GET / HTTP/1.1" 200 -
```

Leia-a da esquerda para a direita:

| Parte | Significado |
|---|---|
| `127.0.0.1` | Quem pediu: o endereço do cliente. Aqui é o próprio computador. |
| `- -` | Dois campos que os servidores podem preencher com dados de início de sessão. Aqui não são usados. |
| `[07/Nov/2026 21:48:34]` | Quando o pedido chegou. O seu mostrará a data e a hora atuais. |
| `"GET / HTTP/1.1"` | O pedido: o método `GET` ("envia-me isto"), o caminho `/` (a página inicial) e a versão do HTTP. |
| `200` | O código de estado: OK, o servidor encontrou o ficheiro e enviou-o. |
| `-` | O tamanho da resposta, que este servidor simples deixa vazio. |

Pense nisto antes de abrir a resposta: nunca escreveu `index.html` no endereço, então porque é que o servidor o enviou?

<details>
<summary>Mostrar a resposta</summary>

O caminho no pedido era apenas `/`. Um servidor web responde a `/` com a página predefinida da pasta, que se chama `index.html`. Também poderia escrever `http://127.0.0.1:8000/index.html` e obter a mesma página. Recarregue esse endereço e veja o registo: aparece uma nova linha `GET /index.html`.

</details>

### Passo 4 — Alterar a página e depois pedir uma página que não existe (6 min)
O servidor não guarda a página em memória: lê o ficheiro de cada vez. Assim, pode alterar-se a página sem reiniciar nada.

Abra `index.html` no editor, altere o texto dentro de `<p>…</p>` para algo novo, por exemplo `Acabei de editar esta página!`, e guarde. Volte ao navegador e **recarregue-o** (F5, ou Cmd+R num Mac). O texto novo aparece. No terminal apareceu uma nova linha `GET / ... 200`.

Agora peça um ficheiro que não existe. Na barra de endereços, escreva:

```text
http://127.0.0.1:8000/about.html
```

O navegador mostra uma página de erro, "Error response: Error code: 404, Message: File not found". Veja o terminal:

```text
127.0.0.1 - - [07/Nov/2026 21:48:34] code 404, message File not found
127.0.0.1 - - [07/Nov/2026 21:48:34] "GET /about.html HTTP/1.1" 404 -
```

O que mudou em relação à primeira linha de registo, e um 404 significa que o servidor está avariado?

<details>
<summary>Mostrar a resposta</summary>

O caminho é agora `/about.html` e o código de estado é `404` em vez de `200`. Um 404 **não** significa que o servidor esteja avariado: o servidor está a funcionar perfeitamente e respondeu, dizendo "não tenho nenhum ficheiro nesse caminho". Neste caso, o ficheiro não existe em `~/my-website`. Como desafio, pode criar `about.html` e recarregar; o 404 passa a 200.

</details>

### Passo 5 — Parar o servidor (3 min)
Vá ao terminal onde o servidor está a ser executado e prima **Ctrl+C** (mantenha premida a tecla Ctrl e prima C).

Resultado esperado:
```text

Keyboard interrupt received, exiting.
```

O prompt regressa. Agora vá ao navegador e recarregue a página: mostra um erro como "Não é possível ligar" ou "Não é possível aceder a este sítio". Já ninguém escuta na porta 8000, pelo que o pedido não obtém qualquer resposta. É diferente de um 404, em que o servidor responde.

## Verificação
O laboratório está concluído se:

- O navegador mostrou a página "Olá a partir do meu próprio servidor!" em `http://127.0.0.1:8000` enquanto o servidor esteve em execução.
- O terminal mostrou uma linha de registo terminada em `200` para ela e uma linha terminada em `404` para a página em falta.
- Depois de Ctrl+C, o navegador já não conseguiu ligar-se.

## Resolução de problemas
| Sintoma | Causa provável | Solução |
|---|---|---|
| `python3: command not found` | O Python não está instalado, ou no Windows chama-se `python` | Instale o Python 3 a partir de python.org e, no Windows, escreva `python` ou `py` em vez de `python3` |
| `Address already in use` | Outro programa usa a porta 8000, ou o servidor já está em execução noutro terminal | Pare o outro, ou use outra porta como `8001` no comando e no endereço |
| O navegador mostra "Directory listing for /" ou um 404 para `/` | O servidor foi iniciado na pasta errada, ou o ficheiro não se chama `index.html` | Prima Ctrl+C, execute `cd ~/my-website`, verifique com `ls` que `index.html` aparece listado e volte a iniciar |
| As alterações não aparecem | A página está em cache ou o ficheiro não foi guardado | Guarde o ficheiro e force o recarregamento (Ctrl+F5, ou Cmd+Shift+R num Mac) |
| `index.html.txt` na listagem | O editor acrescentou `.txt` | Guarde de novo como "Todos os ficheiros" com o nome `index.html` |

## Desafio (opcional)
1. Acrescente uma segunda página, `about.html`, com o seu nome num título, e ligue-a a partir de `index.html` com `<a href="about.html">Sobre</a>`. Clique na ligação e encontre a linha correspondente no registo.
2. Pare o servidor e inicie-o na porta 9000. Que endereço tem agora de escrever no navegador?

## Limpeza
O laboratório criou uma pasta e mais nada. Certifique-se de que o servidor está parado (Ctrl+C) e depois remova a pasta.

No macOS ou Linux:

```bash
cd ~
rm -r ~/my-website
```

No Windows PowerShell:

```text
cd ~
Remove-Item -Recurse ~/my-website
```

## O que aprendeu
- Qualquer computador se torna um servidor quando executa um programa que responde a pedidos; o seu fê-lo com um só comando.
- Um pedido tem um método e um caminho, e a resposta de um servidor começa com um código de estado: `200` para sucesso, `404` para "aqui não há nada".
- O servidor lê ficheiros de uma pasta, e `index.html` é a página predefinida de uma pasta.
- Associar a `127.0.0.1` mantém um servidor de teste privado para o próprio computador, e Ctrl+C pára-o.
