> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/docs-pt/productos/servers-1/how-to/how-to-deploy-a-3cx-template.md).

# Como implementar um template 3CX num servidor da Plenit

3CX é uma plataforma de comunicações unificadas e central telefónica (PBX) baseada em Debian. Na Plenit, implantas a partir do **Marketplace**, o que agiliza a provisão inicial e deixa a configuração web do 3CX pronta para ser concluída depois.

> #### 👍 O que obténs
>
> Um servidor com 3CX implementado a partir do Marketplace e o seu assistente de configuração web acessível pela porta 5015.

### Antes de começar

* Iniciar sessão na plataforma Plenit.
* Ter uma subscrição de **Servidores** disponível.
* Decidir que IP pública usarás para publicar a porta **5015** durante a configuração inicial.

> #### 📘 Duas coisas depois da implementação
>
> Quando o servidor estiver criado, abre a sua **consola** para ativar o acesso remoto à administração web e publica a **porta 5015** no Firewall. Vês isso no Passo 2.

### Passo 1. Implementa o modelo 3CX

Entra na subscrição de **Servidores** e clica **Novo servidor** para abrir o assistente. A partir daí:

1. Seleciona a **localização** e clica **Seguinte**.
2. Escolhe o **tamanho** (CPU e RAM) e clica em **Seguinte**.
3. Abre o separador **Marketplace**, clica na imagem de **3CX**, seleciona o **idioma** e clica **Seguinte**.
4. Escolhe o **tamanho de Disco** e clica **Seguinte**.
5. Configura a **Rede** e clica **Seguinte**.
6. No Ecrã final, cria uma etiqueta e uma chave SSH se precisares, marca **Abrir a porta SSH para aceder ao serviço** só se fores administrar por terminal, atribui um **nome** e clica **Criar Servidor**.

> #### 📘 Dimensiona de acordo com o teu ambiente
>
> A recomendação mínima para 3CX é 1 CPU com 2 cores e 2 GB de RAM. Atribui mais recursos se o ambiente assim o exigir.

Quando começa a implementação, verás o servidor no estado **A carregar** e uma notificação de criação. Ao terminar, podes continuar com a configuração inicial do 3CX.

{/\* 📸 CAPTURA 1 · aba Marketplace com a imagem de 3CX e o seletor de idioma \*/}

![Seleção de 3CX e do seu idioma no Marketplace](https://REEMPLAZA-URL/servidores-howto-3cx-01.png)

### Passo 2. Prepara o sistema 3CX

> #### 🚧 Primeiro a consola, depois a porta
>
> A porta 5015 não serve de nada até ativares o acesso web a partir da consola. Faz este passo antes de abrir o Firewall.

Volta à interface da Plenit e abre a **consola** do servidor. Seleciona a opção **1** para ativar o acesso remoto à administração web inicial. A consola indicar-te-á que deves abrir a porta **5015** para aceder à aplicação.

{/\* 📸 CAPTURA 2 · consola do servidor com a opção 1 para ativar o acesso web \*/}

![Consola de 3CX com a opção para ativar a configuração web](https://REEMPLAZA-URL/servidores-howto-3cx-02.png)

Depois, na parte inferior da configuração do servidor, clica em **Nova regra de entrada** e cria uma regra **NAT** (redirecionamento entre a IP pública e a IP privada do servidor) para publicar a porta 5015:

* **Selecionar Rede**: normalmente, deixa-a como está.
* **Origens**: um IP ou intervalo de origem, ou **Qualquer IP** para permitir qualquer Rede.
* **Protocolo**: deixa o valor que o modelo mostra.
* **IP público**: o IP público pelo qual a ligação é atendida.
* **IP privado**: o IP interno do servidor 3CX.
* **Porta privada**: **5015**.

Clica **Continuar** e verifica que a regra aparece na lista do Firewall.

{/\* 📸 CAPTURA 3 · Nova regra de entrada (NAT) a publicar a porta 5015 \*/}

![Criação da regra NAT para a porta 5015 do 3CX](https://REEMPLAZA-URL/servidores-howto-3cx-03.png)

> 👍 Reduz a exposição do acesso inicial
>
> A 5015 é a porta de acesso à administração da tua central telefónica. Sempre que puderes:
>
> * Usa **Origens** com um IP ou intervalo específico em vez de **Qualquer IP**.
> * Abre a porta 5015 apenas durante a configuração inicial e remove ou restringe a regra ao terminar.
> * Assinala **Abrir a porta SSH** e usa chave SSH apenas se realmente fores administrar por terminal.

### Validação

Abre no navegador `http://IP_Publica:5015`, substituindo `IP_Pública` pela IP pública da regra. Se carregar, verás o Ecrã **Configura a tua instalação do 3CX**, com as opções de carregar uma nova configuração ou restaurar uma Cópia de segurança, e já podes continuar com o assistente web.

Para o confirmar a partir da consola:

```bash
curl -I http://<IP-PÚBLICA>:5015
```

### Se algo não encaixa

| Sintoma                              | Causa provável                       | O que fazer                                                  |
| ------------------------------------ | ------------------------------------ | ------------------------------------------------------------ |
| `http://IP:5015` não responde        | Não ativaste o acesso web na consola | Abre a consola e escolhe a opção **1**                       |
| Continua sem abrir                   | A regra não publica bem a 5015       | Verifica se a regra existe e que o **Porta privada** é 5015  |
| Liga-te a outra máquina ou não chega | IPs mal atribuídos na regra          | Confirma que **IP público** e **IP privado** são as corretas |
| Responde aos outros, mas a ti não    | `Origens` deixa-te fora              | Certifica-te de que a tua IP está no intervalo permitido     |

<br>

### Conclusão

Com isto, tens o 3CX implementado a partir do Marketplace e o seu assistente web pronto na porta 5015. A chave do processo são dois gestos pela ordem certa: ativar o acesso web a partir da consola e, só depois, publicar a porta. E, como se trata de uma central telefónica, fecha ou restringe essa 5015 assim que terminares a configuração inicial: não convém deixar a administração aberta à Internet mais tempo do que o necessário.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.plenit.com/docs-pt/productos/servers-1/how-to/how-to-deploy-a-3cx-template.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.