---
title: Moduli
description: Tutti i moduli NexCMP con stato predefinito, funzioni aggiunte, requisiti di infrastruttura e attivazione, inclusi i moduli add-on caricati all'avvio.
url: https://nexcmp.com/it/docs/infrastructure/modules/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Moduli {#modules}

> **Dove nel pannello di amministrazione:** System › Admin › License & updates (`/license`), la scheda **Module**.

## Descrizione {#what-it-does}

Un modulo è un servizio o una funzionalità che puoi attivare o disattivare interamente. Un modulo **spento** è nascosto dal menu di amministrazione e i clienti non possono acquistarlo; le sue rotte API restituiscono `404 module_disabled` dove il modulo è un componente aggiuntivo. L'attivazione di un modulo espone solo la funzionalità: l'infrastruttura sottostante deve comunque essere collegata (vedi l'ultima colonna).

## Requisiti {#requirements}

| Elemento | Requisito |
|---|---|
| Account | Un amministratore con accesso in scrittura. Il personale di sola visualizzazione può vedere gli interruttori ma non modificarli. |
| Infrastruttura | Vedi la tabella: ogni modulo elenca ciò di cui ha bisogno. |
| Dipende da | Alcuni moduli ne richiedono altri (DDoS Shield richiede DDoS & BGP). |

## Prepara l'infrastruttura {#prepare-the-infrastructure}

Non richiesto per l'interruttore in sé. Collega l'infrastruttura di ciascun modulo come descritto nella pagina collegata nella tabella.

## Collega in NexCMP {#connect-in-nexcmp}

1. Apri **System › Admin › License & updates** e scorri fino alla scheda **Module**. Viene indicato che i moduli disabilitati sono nascosti dal menu di amministrazione e non possono essere acquistati dai clienti.
2. Usa l'interruttore di un modulo. La pagina conferma **Saved: reloading menu** e si ricarica, così il menu cambia immediatamente.

![La scheda Module in License & updates con un interruttore per ciascun modulo](https://nexcmp.com/it/docs/images/infrastructure/modules-01-license-modules.webp)

### I moduli {#the-modules}

| Modulo (come mostrato) | Predefinito | Cosa aggiunge | Necessità | Pagina |
|---|---|---|---|---|
| **Virtual Machines** | sempre attivo | Catalogo VM, ordini, console, snapshot | CloudStack o Proxmox VE | [CloudStack](https://nexcmp.com/it/docs/infrastructure/cloudstack/), [Proxmox VE](https://nexcmp.com/it/docs/infrastructure/proxmox/) |
| **Bandwidth** | **on** | Quote, componenti aggiuntivi, avvisi e azioni di superamento soglia per VM, Kubernetes e S3 | Nulla di extra (statistiche VM CloudStack) | [Bandwidth](https://nexcmp.com/it/docs/catalog/bandwidth/) |
| **OS & ISO Images** | disattivo | I clienti registrano le proprie immagini OS e ISO, fatturate al GB | CloudStack; accesso a Internet per la relativa VM di storage secondario | [Requirements](https://nexcmp.com/it/docs/infrastructure/requirements/) |
| **Kubernetes** | disattivo | Cluster Kubernetes (CKS) | CloudStack con CKS abilitato | [Kubernetes e Private Cloud](https://nexcmp.com/it/docs/infrastructure/kubernetes-and-private-cloud/) |
| **Private Cloud** | disattivo | VPC con piani a banda dedicata | CloudStack VPC e offerte di rete | [Kubernetes e Private Cloud](https://nexcmp.com/it/docs/infrastructure/kubernetes-and-private-cloud/) |
| **Object Storage** | disattivo | Account S3 su Ceph RGW, con tariffazione a consumo | Ceph RGW e una zona con servizio S3 | [S3](https://nexcmp.com/it/docs/infrastructure/s3/) |
| **VPN** | disattivo | VPN sui tuoi nodi | Nodi con `cmp-agent` in esecuzione | [Nodi VPN e proxy](https://nexcmp.com/it/docs/infrastructure/vpn-proxy-nodes/) |
| **IPv6 Proxy** | disattivo | Proxy IPv6 sui tuoi nodi | Nodi proxy con un prefisso IPv6 | [Nodi VPN e proxy](https://nexcmp.com/it/docs/infrastructure/vpn-proxy-nodes/) |
| **Bare Metal** | disattivo | Server Dell tramite iDRAC: ordini, installazione OS, console, alimentazione | iDRAC 9 su rete di gestione | [Dedicated servers](https://nexcmp.com/it/docs/infrastructure/dedicated/) |
| **AI Models** | disattivo | Un gateway per vendere l'accesso ai modelli IA: un'unica chiave per più modelli, prezzi per modello, limiti di consumo, log e fatturazione su wallet | Sorgenti di modelli fornite da te: API compatibile con OpenAI o Anthropic con chiave propria | [AI Models](https://nexcmp.com/it/docs/infrastructure/ai-models/) |
| **AI** | disattivo | AI Chat (supporto automatizzato) e AI Agent (gestione VM in linguaggio naturale) | Un provider compatibile con OpenAI | [AI providers](https://nexcmp.com/it/docs/ai/ai-providers/) |
| **DDoS Shield** | disattivo | Protezione IP per i clienti; richiede DDoS & BGP, quindi l'opzione resta disabilitata senza di essa | L'add-on DDoS & BGP | sotto |
| **DDoS & BGP** | off, **add-on** | Console router edge: BGP, RTBH, XDP, sessioni e traffico edge | Un host edge con demoni root | sotto |

### Funzione dei singoli interruttori {#which-switch-does-what}

- **Bare Metal** prevede due livelli. L'interruttore del modulo mostra il menu admin e le API. La vendita ai clienti è un interruttore separato con conferma digitata in **Services › Dedicated Server**, e qualsiasi operazione di scrittura su un iDRAC resta bloccata finché non attivi **live ops** in **Infrastructure › Bare Metal › Safety**. Vedi [Dedicated servers](https://nexcmp.com/it/docs/infrastructure/dedicated/).
- Per **Kubernetes**, **Private Cloud**, **VPN**, **IPv6 Proxy** e **Images**, l'interruttore del modulo e quello di vendita nella pagina del servizio controllano la medesima impostazione.
- Anche **AI** richiede un provider configurato in **System › Settings › AI provider**.
- **AI Models** prevede due livelli. L'interruttore del modulo mostra il menu admin e le API. La vendita ai clienti è un interruttore separato nella parte superiore delle pagine AI Models, disattivato per impostazione predefinita. Vedi [AI Models](https://nexcmp.com/it/docs/infrastructure/ai-models/).

### Moduli caricati all'avvio {#modules-read-at-start-up}

Tre funzionalità non corrispondono a normali interruttori. Vengono lette **una sola volta all'avvio dei servizi** e richiedono un'infrastruttura non inclusa nell'installazione standard.

| Funzionalità | Impostazione | Stato | Requisiti |
|---|---|---|---|
| DDoS & BGP | `module_ddos` | Mostrato come **Add-on package** quando disattivato, **Installed** quando attivato. Non è presente alcun interruttore nella console. | Demoni per edge router (BGP, RTBH, XDP, statistiche di flusso) eseguiti come root. Il pannello viene eseguito come utente non privilegiato e non può eseguirli. |
| IA | `module_ai` | Un normale interruttore. Le route si aggiornano immediatamente; i job in background di AI Chat (analisi dei ticket, risposte pianificate) si avviano al riavvio successivo dei servizi. La console indica che è consigliato un riavvio. | Il provider AI. |
| Terminale Web SSH | `feature_ssh_web` | Disattivato per impostazione predefinita, nessun interruttore nella console | Un servizio proxy SSH separato e la relativa route. Senza di esso, la scheda Console del portale mostra solo VNC. L'**AI Agent non ne ha bisogno**: esegue i comandi tramite una connessione SSH stabilita direttamente dal pannello. |

Dopo aver modificato un'impostazione di avvio, riavvia i servizi: `sudo systemctl restart nexcmp nexcmp-vmd`.

## Verifica {#verify}

1. La voce di menu del modulo compare (o scompare) dopo il ricaricamento.
2. Per un modulo rivolto ai clienti, il portale mostra la nuova voce di menu per gli utenti autenticati. Un modulo disattivato non mostra nulla oppure "coming soon".

## Limiti e note {#limits-and-notes}

- Disattivare un modulo non elimina nulla. Le macchine virtuali, i cluster, gli account S3 e gli abbonamenti in esecuzione continuano a funzionare e a essere fatturati; i clienti non possono semplicemente crearne di nuovi.
- Le pagine delle quote elencano solo i servizi i cui moduli sono attivi.

## Troubleshooting {#troubleshooting}

| Sintomo | Causa | Soluzione |
|---|---|---|
| La voce di menu non è comparsa | La pagina non è stata ricaricata | Ricarica la console di amministrazione. |
| L'interruttore DDoS Shield è disattivato | DDoS & BGP non è installato | DDoS Shield richiede il componente aggiuntivo DDoS & BGP. |
| "This module is an add-on package and cannot be switched here" (HTTP 409 o 422) | Tu (o uno script) hai tentato di attivare DDoS & BGP | Si tratta di un pacchetto aggiuntivo; non è presente alcun interruttore. |
| "DDoS Shield richiede il componente aggiuntivo DDoS & BGP" | Lo stesso, per DDoS Shield | Installa prima il componente aggiuntivo. |
| Una rotta di modulo restituisce 404 `module_disabled` | Il modulo è disattivato | Attiva il modulo. |
| AI Chat risponde ma l'indagine sul ticket non si avvia mai | Il modulo AI è stato attivato senza un riavvio | `sudo systemctl restart nexcmp nexcmp-vmd`. |
| Il personale di sola lettura non può salvare | Il loro ruolo è di sola lettura | Usa un account amministratore. |