---
title: Módulos
description: Todos os módulos do NexCMP com o estado padrão, o que adicionam, a infraestrutura necessária e onde ativá-los; incluindo os add-on lidos na inicialização.
url: https://nexcmp.com/pt/docs/infrastructure/modules/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Módulos {#modules}

> **Onde no admin:** System › Admin › License & updates (`/license`), no card **Module**.

## O que faz {#what-it-does}

Um módulo é um serviço ou recurso que você pode ativar ou desativar por completo. Um módulo que está **desativado** fica oculto no menu administrativo e os clientes não podem comprá-lo; suas rotas de API respondem com `404 module_disabled` quando o módulo for um complemento. Ativar um módulo apenas expõe o recurso: a infraestrutura por trás dele ainda precisa estar conectada (consulte a última coluna).

## Requisitos {#requirements}

| Item | Requisito |
|---|---|
| Conta | Um administrador com acesso de gravação. A equipe somente leitura pode ver as chaves, mas não alterá-las. |
| Infraestrutura | Consulte a tabela: cada módulo lista o que precisa. |
| Depende de | Alguns módulos precisam de outros (o DDoS Shield precisa de DDoS & BGP). |

## Preparar a infraestrutura {#prepare-the-infrastructure}

Não é obrigatório para a chave em si. Conecte a infraestrutura de cada módulo conforme descrito na página vinculada na tabela.

## Conectar no NexCMP {#connect-in-nexcmp}

1. Abra **System › Admin › License & updates** e role até o card **Module**. Ele informa que os módulos desativados ficam ocultos no menu administrativo e não podem ser adquiridos pelos clientes.
2. Use a chave de um módulo. A página confirma **Saved: reloading menu** e é recarregada, fazendo com que o menu mude imediatamente.

![O card Module em License & updates com uma chave para cada módulo](https://nexcmp.com/pt/docs/images/infrastructure/modules-01-license-modules.webp)

### Os módulos {#the-modules}

| Módulo (conforme exibido) | Padrão | O que adiciona | Necessita | Página |
|---|---|---|---|---|
| **Virtual Machines** | sempre ativado | Catálogo de VMs, pedidos, console, snapshots | CloudStack ou Proxmox VE | [CloudStack](https://nexcmp.com/pt/docs/infrastructure/cloudstack/), [Proxmox VE](https://nexcmp.com/pt/docs/infrastructure/proxmox/) |
| **Bandwidth** | **ativado** | Cotas, complementos, alertas e ações de excedente para VMs, Kubernetes e S3 | Nada extra (estatísticas de VM do CloudStack) | [Bandwidth](https://nexcmp.com/pt/docs/catalog/bandwidth/) |
| **OS & ISO Images** | desativado | Os clientes registram suas próprias imagens de SO e ISOs, cobradas por GB | CloudStack; acesso à Internet para sua VM de armazenamento secundário | [Requisitos](https://nexcmp.com/pt/docs/infrastructure/requirements/) |
| **Kubernetes** | desativado | Clusters Kubernetes (CKS) | CloudStack com CKS habilitado | [Kubernetes e Private Cloud](https://nexcmp.com/pt/docs/infrastructure/kubernetes-and-private-cloud/) |
| **Private Cloud** | desativado | VPC com planos de largura de banda dedicada | VPC do CloudStack e ofertas de rede | [Kubernetes e Private Cloud](https://nexcmp.com/pt/docs/infrastructure/kubernetes-and-private-cloud/) |
| **Object Storage** | desativado | Contas S3 em Ceph RGW, pague pelo uso | Ceph RGW e uma zona com o serviço S3 | [S3](https://nexcmp.com/pt/docs/infrastructure/s3/) |
| **VPN** | desativado | VPN em seus próprios nós | Nós executando o `cmp-agent` | [Nós de VPN e proxy](https://nexcmp.com/pt/docs/infrastructure/vpn-proxy-nodes/) |
| **IPv6 Proxy** | desativado | Proxy IPv6 em seus próprios nós | Nós de proxy com um prefixo IPv6 | [Nós de VPN e proxy](https://nexcmp.com/pt/docs/infrastructure/vpn-proxy-nodes/) |
| **Bare Metal** | desativado | Servidores Dell via iDRAC: pedidos, instalação de SO, console, energia | iDRAC 9 em uma rede de gerenciamento | [Dedicated servers](https://nexcmp.com/pt/docs/infrastructure/dedicated/) |
| **AI Models** | desativado | Um gateway que vende acesso a modelos de IA: uma única chave para vários modelos, preços por modelo, limites de uso, logs e faturamento via carteira | Fontes de modelos fornecidas por você: uma API compatível com OpenAI ou Anthropic com sua própria chave | [AI Models](https://nexcmp.com/pt/docs/infrastructure/ai-models/) |
| **AI** | desativado | AI Chat (suporte automatizado) e AI Agent (administração de VM em linguagem natural) | Um provedor compatível com OpenAI | [AI providers](https://nexcmp.com/pt/docs/ai/ai-providers/) |
| **DDoS Shield** | desativado | Proteção de IP para clientes; precisa de DDoS & BGP, portanto o botão permanece desativado sem eles | O add-on DDoS & BGP | abaixo |
| **DDoS & BGP** | desligado, **add-on** | Console do roteador de borda: BGP, RTBH, XDP, sessões e tráfego de borda | Um host de borda com daemons root | abaixo |

### O que cada botão faz {#which-switch-does-what}

- O **Bare Metal** tem duas camadas. O botão do módulo exibe o menu de administração e a API. A venda para clientes é um botão separado com uma confirmação digitada em **Services › Dedicated Server**, e toda gravação no iDRAC é bloqueada até que você ative o **live ops** em **Infrastructure › Bare Metal › Safety**. Consulte [Dedicated servers](https://nexcmp.com/pt/docs/infrastructure/dedicated/).
- Para **Kubernetes**, **Private Cloud**, **VPN**, **IPv6 Proxy** e **Images**, o botão do módulo e o botão de vendas na página do serviço controlam a mesma configuração.
- O **AI** também precisa de um provedor configurado em **System › Settings › AI provider**.
- O **AI Models** tem duas camadas. O switch do módulo exibe o menu de administração e a API. A venda para clientes é controlada por um switch de venda separado no topo das páginas do AI Models, desativado por padrão. Consulte [AI Models](https://nexcmp.com/pt/docs/infrastructure/ai-models/).

### Módulos lidos na inicialização {#modules-read-at-start-up}

Três recursos não são botões comuns. Eles são lidos **uma vez quando os serviços iniciam** e exigem uma infraestrutura que a instalação padrão não inclui.

| Recurso | Configuração | Estado | O que é necessário |
|---|---|---|---|
| DDoS & BGP | `module_ddos` | Exibido como **Add-on package** quando desligado, **Installed** quando ligado. Não há botão no console. | Daemons do roteador de borda (BGP, RTBH, XDP, estatísticas de fluxo) executados como root. O painel é executado como um usuário sem privilégios e não pode executá-los. |
| IA | `module_ai` | Um botão normal. As rotas entram em vigor imediatamente; as tarefas em segundo plano do AI Chat (investigação de tickets, respostas agendadas) começam na próxima reinicialização dos serviços. O console indica que a reinicialização é recomendada. | O provedor de AI. |
| Terminal SSH web | `feature_ssh_web` | Desligado por padrão, sem botão no console | Um serviço de proxy SSH separado e sua rota. Sem ele, a aba Console do portal exibe apenas VNC. O **AI Agent não precisa dele**: ele executa comandos por meio de uma conexão SSH que o próprio painel estabelece. |

Após uma alteração em uma configuração de inicialização, reinicie os serviços: `sudo systemctl restart nexcmp nexcmp-vmd`.

## Verificar {#verify}

1. O item de menu do módulo aparece (ou desaparece) após a recarga.
2. Para um módulo voltado ao cliente, o portal exibe o novo item de menu para um cliente conectado. Um módulo desativado não exibe nada ou "coming soon".

## Limites e observações {#limits-and-notes}

- Desativar um módulo não exclui nada. VMs, clusters, contas S3 e assinaturas em execução continuam funcionando e sendo cobrados; os clientes apenas não conseguem criar novos.
- As páginas de cotas listam apenas os serviços cujos módulos estão ativados.

## Resolução de problemas {#troubleshooting}

| Sintoma | Causa | Correção |
|---|---|---|
| A entrada do menu não apareceu | A página não foi recarregada | Recarregue o console administrativo. |
| O interruptor do DDoS Shield está desativado | O DDoS & BGP não está instalado | O DDoS Shield precisa do add-on DDoS & BGP. |
| "This module is an add-on package and cannot be switched here" (HTTP 409 ou 422) | Você (ou um script) tentou alternar o DDoS & BGP | É um pacote add-on; não há opção de alternar. |
| "O DDoS Shield precisa do add-on DDoS & BGP" | O mesmo para o DDoS Shield | Instale o add-on primeiro. |
| Uma rota de módulo responde com 404 `module_disabled` | O módulo está desativado | Ative o módulo. |
| O AI Chat responde, mas a investigação do ticket nunca começa | O módulo de IA foi ativado sem uma reinicialização | `sudo systemctl restart nexcmp nexcmp-vmd`. |
| Equipe com acesso somente leitura não pode salvar | A função deles é somente leitura | Use uma conta de administrador. |