> 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 Modelo 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.