Questa guida illustra come creare un repository GIT sia sul tuo Hosting Web che sul tuo Server Cloud Infomaniak.

Introduzione

• GIT e GitHub sono disponibili per impostazione predefinita su entrambe le piattaforme menzionate.

Creazione del repository GIT

Configurazione sul server:

• il repository GIT si trova in /git_depot
• il sito è situato nella cartella /web/[progetto] (sul tuo server FTP)

Comandi da inserire:

cd
mkdir git_depot
cd git_depot/
git init --bare [projet].git
cd [projet].git
git update-server-info

Invio del repository locale sul server

Da eseguire sulla postazione locale:

git init
git remote add origin ssh://user@[xxxxx].ftp.infomaniak.com:/home/clients/[123456789]/git_depot/[projet].git
git status
git add .
git commit -a -m "init"
git push --set-upstream origin master
git push

Clonazione del sito nella directory del server

Da eseguire sul server:

cd
cd web
rm -r [projet]/
git clone /home/clients/[123465789]/git_depot/[projet].git [projet]/

Arrivate su questa pagina perché avete una redirezione web sul vostro dominio che è configurata in modo errato. Infomaniak non è in grado di identificare il percorso corretto di questa redirezione, quindi siete stati reindirizzati a questa pagina per aiutarvi a correggere questa situazione.

Verifica della zona DNS

Per ripristinare il funzionamento della vostra redirezione, è necessario, in primo luogo, eliminare le tracce di una vecchia redirezione configurata in modo errato:

1. Accedete alla vostra zona DNS.
2. Eliminate le voci interessate (vedi l'elenco qui sotto) che corrispondono alla vostra redirezione.
3. Cliccate sull'icona ⋮ a destra della voce DNS e selezionate Elimina:
   
   • Probabilmente non troverete tutte le voci citate nell'elenco, è del tutto normale.
   • Ogni aggiunta/modifica può richiedere fino a 48 ore per propagarsi.
4. Ricreate la redirezione web.

Elenco delle voci da verificare e da eliminare

Le voci DNS possono essere di tipo:

• A e che puntano su xx.xx.xx.xx (solo numeri)
• AAAA e che puntano su un IP xxxx:xxxx:x:x::x (numeri e lettere)
• TXT la cui stringa assomiglia a “(numero)|(URL)”
  • ad esempio 1|infomaniak.com se la vostra redirezione punta su infomaniak.com
• TXT la cui stringa assomiglia a “(lettera)|(testo)”
  • ad esempio t|Text, d|Text o k|Text

Questa guida dettaglia i porta aperte disponibili per i siti Node.js (solo) ospitati da Infomaniak.

Porte aperte in uscita

Web

• HTTP (tcp/80)
• HTTP alternativo (tcp/8080)
• HTTPS (tcp/443)
• Dati FTP (tcp/20)
• Controllo FTP (tcp/21)

Posta elettronica

• POP3 (tcp/110)
• IMAP (tcp/143)
• Invio SMTP (+ STARTTLS) (tcp/587)
• SMTPS (tcp/465)
• IMAPS (tcp/993)
• POP3S (tcp/995)

DB

• MySQL (tcp/3306)
• MongoDB (tcp/27017)
• PostgreSQL (tcp/5432)
• Redis (tcp/6379)
• Redis TLS (tcp/6380)
• ElasticSearch (tcp/9200)

Varie

• SSH (tcp/22)
• Trasferimento pacchetti Git (tcp/9418)

Porte aperte in entrata

• HTTP (tcp/80)
• HTTPS (tcp/443)
• SSH (tcp/22)

Questa guida spiega come risolvere un problema di installazione di certificato SSL (Let's Encrypt o Sectigo) se si utilizza Cloudflare con regole di sicurezza rigorose, come il filtraggio per paese o indirizzi IP.

Adattare le impostazioni SSL / geoblocking

Quando viene richiesto un certificato SSL tramite Infomaniak (Let's Encrypt gratuito o Sectigo), l'autorità di certificazione deve verificare che siate effettivamente proprietari del dominio. Questa verifica può essere effettuata tramite HTTP (tramite file speciali posizionati sul vostro sito), DNS o e-mail:

• Let's Encrypt utilizza /.well-known/acme-challenge/.
• Sectigo utilizza generalmente /.well-known/pki-validation/ (o DNS / e-mail a seconda dell'opzione scelta).

Se queste verifiche falliscono (ad esempio perché Cloudflare blocca l'accesso), il certificato non può essere rilasciato o rinnovato. Tuttavia, Let's Encrypt non verifica più solo da un unico luogo. Da un certo tempo (e ancora di più da marzo 2024), effettua le sue verifiche da diversi paesi contemporaneamente – inclusi nuovi come la Svezia o Singapore. Risultato: se uno di questi paesi è bloccato dalle vostre impostazioni Cloudflare, la richiesta di certificato può fallire, anche se tutto il resto è configurato correttamente.

Ancora peggio: anche se si tenta di fare un'eccezione solo per l'indirizzo della sfida (.well-known/acme-challenge), questo non funziona sempre con alcune regole Cloudflare. Infatti, le regole di blocco per paese o IP vengono applicate prima di qualsiasi eccezione basata sui percorsi URL.

Regolare la modalità SSL/TLS

In Cloudflare, utilizzate la modalità Full o Full (strict). Queste modalità tollerano temporaneamente un certificato scaduto o auto-firmato, fino a quando la validazione non viene completata:

Autorizzare i percorsi di validazione

Evitate le "IP Access Rules" bloccanti e preferite delle "Custom Rules" che autorizzano senza restrizioni i percorsi:

• /.well-known/acme-challenge/ (Let's Encrypt)
• /.well-known/pki-validation/ (Sectigo)

Disattivare temporaneamente il geoblocking

Se necessario, disattivate temporaneamente il blocco geografico o IP per il tempo della validazione, quindi riattivate le vostre protezioni dopo l'emissione o il rinnovo del certificato.

Infomaniak offre diverse soluzioni Site Creator, gratuite o a pagamento, adatte a diverse esigenze. È fondamentale comprendere bene le condizioni relative a ciascun tipo di offerta prima di effettuare la scelta.

Comprendere le diverse offerte Site Creator

Site Creator è disponibile…

• … ovvero gratuitamente con ogni piano di hosting web a pagamento esistente (aggiungine uno se necessario):
  
  • In questo caso, è possibile creare un solo Site Creator per ogni piano di hosting web Infomaniak.
  • Per gestire più siti creati con Site Creator all'interno della stessa Organizzazione, è quindi necessario disporre di più piani di hosting web.
• … ovvero in modo indipendente (standalone, disponibile in 3 versioni) e, in questo caso, non richiede alcuna altra offerta specifica:
  
  1. Site Creator Free
  2. Site Creator Lite
  3. Site Creator Pro

1. Site Creator Free

Questa offerta è pensata come una soluzione di prova e di scoperta ed è completamente gratuita. È rivolta agli utenti che desiderano familiarizzare con lo strumento o pubblicare una pagina web estremamente semplice:

• Consente di creare una sola pagina web e offre uno spazio su disco limitato (5 GB).
• Questa offerta non consente il collegamento a un nome di dominio personalizzato (che avrà la forma *.infomaniak.site) e prevede la visualizzazione obbligatoria del messaggio pubblicitario di Infomaniak.
• Non sono inclusi importanti moduli aggiuntivi, come la gestione completa di un blog, l'utilizzo dell'Intelligenza Artificiale per la generazione di testo o la funzione "Mappa del sito".

2. Site Creator Lite

Il piano Lite è l'offerta a pagamento di base di Infomaniak. È ideale per la creazione di un sito vetrina o di un semplice blog personale, poiché elimina le principali limitazioni della versione gratuita e sblocca i moduli necessari per un sito completo:

• Consente la creazione di un sito più completo con un limite di 6 pagine web e uno spazio su disco più ampio (15 GB).
• Include l'offerta di un nome di dominio per un anno e, aspetto fondamentale, la rimozione di qualsiasi messaggio pubblicitario di Infomaniak dal sito.
• A differenza dell'offerta Free, il piano Lite sblocca l'accesso a importanti funzionalità per la navigazione e l'organizzazione, in particolare il modulo di creazione e gestione di un blog e il modulo Mappa del sito.

3. Site Creator Pro

L'offerta Pro è la formula premium di Site Creator. È dedicata esclusivamente ai progetti più ambiziosi, come il lancio di un negozio online completo, grazie alla rimozione di tutte le restrizioni sui contenuti e all'integrazione di strumenti di commercio e analisi avanzati:

• Elimina qualsiasi limitazione sui contenuti, offrendo pagine web illimitate e un ampio spazio su disco di 50 GB.
• È l'unica offerta che include la gestione completa dell'e-commerce (ordini, inventario, sconti) e consente l'integrazione dei gateway di pagamento essenziali (Stripe, PayPal, Mollie) per un'attività commerciale online.
• Il piano Pro è l'unico che offre l'accesso a strumenti di analisi e monitoraggio delle prestazioni esterni, fondamentali, come Google Analytics, Hotjar e strumenti come Google reCaptcha.

Impegno relativo alle offerte a pagamento

A differenza di altri prodotti Infomaniak, alcune offerte di Site Creator includono un nome di dominio gratuito. Queste offerte richiedono un impegno fermo per una durata minima di 12 mesi, senza possibilità di rimborso, nemmeno parziale, anche se:

• si decide di interrompere l'utilizzo di Site Creator prima della fine del primo anno,
• si annullano i prodotti,
• si chiude l'account utente o l'Organizzazione.

Evoluzione delle offerte e conservazione del sito

È possibile passare da un'offerta gratuita a un'offerta a pagamento più completa:

1. Clicca qui per accedere alla gestione del tuo sito su Infomaniak Manager (hai bisogno di aiuto?).
2. Clicca sul menu delle azioni ⋮ a destra del sito interessato nella tabella che viene visualizzata.
3. Clicca su Modifica offerta:
   

È anche possibile passare a un'offerta superiore (ad esempio, da Lite a Pro).

Se desideri mantenere attivo il tuo sito, devi assolutamente rinnovare la stessa offerta a pagamento. Non è possibile passare a una versione gratuita di Site Creator, anche se:

• non utilizzi nessuno dei moduli a pagamento,
• il tuo sito contiene solo una pagina.

Cosa fare se desideri tornare all'offerta gratuita?

In questo caso, devi:

• annullare il tuo sito attuale dopo aver copiato manualmente tutte le informazioni che desideri conservare,
• attivare una nuova offerta Site Creator gratuita,
• ricreare il tuo sito incollando i contenuti recuperati dal sito precedente.

Questa guida permette di risolvere un problema sul CMS Prestashop e più precisamente con il suo modulo “Ricerca a faccette” ("Faceted search") che permette la gestione di filtri nelle pagine categorie di prodotti.

Il problema

Questo modulo di ricerca specifico di Prestashop crea una cache nel database per accelerare la ricerca, tuttavia la tabella corrispondente non viene mai pulita, il che crea problemi per l'infrastruttura di hosting.

Prima soluzione

La prima soluzione consiste nel disattivare la memorizzazione della cache proposta.

Per fare questo:

1. Nel pannello di amministrazione di PrestaShop, vai su Moduli → Gestore di moduli.
2. Seleziona Moduli e usa il campo di ricerca per trovare “facet”.
3. Clicca su Configura accanto al modulo ottenuto come risultato:
   
4. Disattiva il pulsante in questione:
   

Seconda soluzione

La seconda soluzione consiste nel creare un cronjob che permette di pulire la tabella, ad esempio ogni sera:

1. Dai parametri del modulo, copia l'URL esistente sul pulsante Clear cache:
   

Poi, dal Manager Infomaniak, crea un webcron (prendi visione di questa altra guida a riguardo) per eseguire l'URL copiata al punto 1 sopra, ad esempio 1 volta al giorno e per notte.

Questa guida riguarda il modulo WordPress "Infomaniak Connect for OpenID", che consente agli utenti di accedere al tuo sito WordPress (sia esso ospitato da Infomaniak o meno) utilizzando le proprie credenziali Infomaniak.

Introduzione

• Consentire l'accesso tramite un account Infomaniak sul tuo sito WordPress permette ai tuoi visitatori di commentare, iscriversi a corsi o accedere a qualsiasi contenuto riservato ai membri con un solo clic, senza dover creare un nuovo account.
• Questo fa risparmiare tempo agli utenti e rappresenta un metodo più sicuro per te, in quanto non devi gestire password aggiuntive.
• Il funzionamento di questo modulo esterno è identico alle opzioni "Accedi con Google", "Accedi con Facebook" o “Accedi con Apple”; utilizza i protocolli standard OAuth2 e OpenID Connect per consentire l'autenticazione singola (SSO).

A. Creare un'applicazione con Auth Infomaniak

Per farlo:

1. Clicca qui per accedere alla gestione del tuo prodotto Auth nel Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca sul pulsante per Creare una nuova applicazione:
   
3. Scegli il tipo “Web Front-End”.
4. Assegna un nome alla tua applicazione.
5. Nel campo URL, indica il nome di dominio corrispondente al tuo sito WordPress, a cui aggiungi /openid-connect-authorize (consulta la documentazione su GitHub, se necessario).
6. Fai clic sul pulsante per completare la creazione dell'app:
   
7. Annota con cura le 2 informazioni ottenute al termine della configurazione della tua applicazione OAuth2:
   

B. Configurare l'estensione WordPress

Per farlo:

1. Cerca l'estensione Infomaniak Connect for OpenID sulla piattaforma delle estensioni WordPress dal tuo sito.
2. Installa e attiva l'estensione:
   
3. Configura l'estensione dal menu Impostazioni:
   
4. Gli unici campi da compilare sono ID cliente e chiave segreta del cliente, che provengono dalle informazioni ottenute nel punto A sopra:
   
5. Non dimenticare di salvare le modifiche apportate alle impostazioni dell'estensione.
6. È stato aggiunto un pulsante aggiuntivo per l'accesso tramite ID Infomaniak, ora visibile nella pagina di accesso per gli utenti /wp-admin (/wp-login.php):
   

Questa guida riguarda il modulo Typo3 "t3ext-infomaniak-auth" che permette agli utenti di accedere al tuo sito Typo3 (che sia ospitato da Infomaniak o meno) utilizzando le loro credenziali Infomaniak.

Premessa

• Autorizzare la connessione tramite un account Infomaniak sul tuo sito Typo3 permette ai tuoi visitatori di commentare, iscriversi a corsi o accedere a qualsiasi contenuto riservato ai membri in un solo clic, senza dover creare un nuovo account.
• È un risparmio di tempo per loro e un metodo più sicuro per te, poiché non devi gestire ulteriori password.
• Il funzionamento di questo modulo esterno è identico alle opzioniAccedi con Google", "Accedi con Facebook" o "Accedi con Apple"; utilizza i protocolli standard OAuth2 e OpenID Connectper consentire l'autenticazione unica (SSO).

A. Creare un'applicazione con Auth Infomaniak

Per fare ciò:

1. Clicca qui per accedere alla gestione del tuo prodotto Auth sul Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca sul pulsante per Creare una nuova applicazione: 
   
3. Scegli il tipo "Web Front-End".
4. Dai un nome alla tua applicazione.
5. Nel campo URL, indica il nome di dominio corrispondente al tuo sito Typo3 dopo il quale aggiungi /openid-connect-authorize (consulta la documentazione github se necessario).
6. Clicca sul pulsante per completare la creazione dell'app:
   
7. Annota attentamente le 2 informazioni ottenute durante la finalizzazione della tua applicazione OAuth2:
   

B. Configurare l'estensione Typo3

In SSH, distribuisci se necessario Composer per poter recuperare le estensioni t3ext-infomaniak-auth. Per fare ciò:

• Il comando SSH per l'installazione dell'estensione è qui:
  • https://packagist.org/packages/infomaniak/t3ext-infomaniak-auth 

Successivamente, su Typo3:

1. Accedi alla tua interfaccia di amministrazione Typo3.
   • Verifica se necessario che l'estensione Infomaniak sia attivata:
     
2. Clicca su Impostazioni nel menu laterale sinistro.
3. Clicca su Configura le estensioni:
   
4. Clicca sulla freccia ‍ a destra di typo3-openid-main per sviluppare la scheda client.
5. I soli campi da compilare sono clientID e clientSecret e provengono dalle informazioni ottenute al punto A sopra.
6. Non dimenticare di salvare le modifiche apportate alle impostazioni dell'estensione:
   
7. Un pulsante aggiuntivo, per una connessione tramite identificativo Infomaniak, è ora visibile sulla tua pagina di accesso destinata agli utenti:
   

Questa guida riguarda il modulo Drupal "Infomaniak_Connect" che permette agli utenti di connettersi al tuo sito Drupal (che sia ospitato da Infomaniak o meno) utilizzando le loro credenziali Infomaniak.

Premessa

• Autorizzare la connessione tramite un account Infomaniak sul tuo sito Drupal permette ai tuoi visitatori di commentare, iscriversi a corsi o accedere a qualsiasi contenuto riservato ai membri in un solo clic, senza dover creare un nuovo account.
• È un risparmio di tempo per loro e un metodo più sicuro per te, poiché non devi gestire ulteriori password.
• Il funzionamento di questo modulo esterno è identico alle opzioniAccedi con Google", "Accedi con Facebook" o "Accedi con Apple"; utilizza i protocolli standard OAuth2 e OpenID Connectper consentire l'autenticazione unica (SSO).

A. Creare un'applicazione con Auth Infomaniak

Per fare ciò:

1. Clicca qui per accedere alla gestione del tuo prodotto Auth sul Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca sul pulsante per Creare una nuova applicazione:
   
3. Scegli il tipo "Web Front-End".
4. Assegna un nome alla tua applicazione.
5. Nel campo URL, indicare il nome di dominio corrispondente al proprio sito Drupal dopo il quale si aggiunge /openid-connect-authorize (consultare la documentazione github se necessario).
6. Cliccare sul pulsante per completare la creazione dell'app:
   
7. Annotare con cura le 2 informazioni ottenute al termine della configurazione della propria applicazione OAuth2:
   

B. Configurare l'estensione Drupal

In SSH, distribuire se necessario Composer per poter recuperare le estensioni openid_connect e infomaniak_connect. Per fare ciò:

• È necessario modificare il file composer.json poiché la versione di openid_connect non è ancora considerata stabile. Aggiungere:

• "minimum-stability": "dev",
  "prefer-stable": true

• I comandi SSH per l'installazione delle 2 estensioni sono qui:
  • https://www.drupal.org/project/openid_connect
  • https://www.drupal.org/project/infomaniak_connect

Successivamente, su Drupal:

1. Cercare il modulo Infomaniak tra i moduli preinstallati.
2. Selezionarlo.
3. Cliccare sul pulsante Installa:
   
4. L'installazione delle dipendenze verrà effettuata:
   
5. In Configurazione, cliccare per configurare la connessione OpenID:
   
6. Cliccare sul pulsante modifica:
   
7. I soli campi da compilare sono Client ID e Client Secret e provengono dalle informazioni ottenute al punto A sopra:
    
8. Non dimenticare di salvare le modifiche apportate alle impostazioni dell'estensione.
9. Nella scheda Impostazioni, è possibile scegliere il tipo di visualizzazione per la propria pagina di accesso; non dimenticare di salvare:
   
10. Un pulsante aggiuntivo, per un accesso tramite identificativo Infomaniak, è ora visibile sulla propria pagina di accesso destinata agli utenti:
     

Questa guida spiega perché è importante utilizzare una versione recente di Node.js per la tua applicazione e come selezionare una versione più recente con un sito Node.js ospitato sull'infrastruttura Infomaniak.

Premessa

• Node.js = nome ufficiale del linguaggio/ambiente.
• NodeJS = nome "tecnico" o semplificato in alcuni contesti (spesso per motivi pratici, non c'è una vera differenza tecnica).

È pericolosa una versione obsoleta di Node.js?

Quando si utilizza una versione di Node.js che si avvicina alla fine del suo supporto, viene visualizzato un messaggio di avviso nel pannello di controllo del sito interessato.

Il runtime Node.js si evolve regolarmente : ogni nuova versione apporta miglioramenti delle prestazioni, della sicurezza e del supporto delle funzionalità recenti. Utilizzare una versione che non è più aggiornata ti espone a rischi di sicurezza e a problemi di funzionamento con altri componenti. Le persone malintenzionate potrebbero sfruttare le vulnerabilità note in queste versioni per compromettere la tua applicazione. È quindi fortemente consigliato utilizzare una versione recente e ufficialmente supportata.

Tre situazioni sono possibili:

• Versione completamente supportata : nessuna azione necessaria
• Versione con supporto di sicurezza solo : è consigliato passare a una versione più recente
• Versione obsoleta : è fortemente consigliato aggiornare a una versione più recente

Utilizzare una versione più recente di Node.js

Le versioni più recenti di Node.js offrono prestazioni migliori e un comportamento più stabile per le tue applicazioni moderne.

Prima di modificare la versione utilizzata

• Se la tua applicazione utilizza un framework o una libreria specifica (Next.js, Express, ecc.), verifica il corretto supporto della versione target di Node.js.
• Se il tuo codice è stato sviluppato su misura, consulta la documentazione ufficiale di Node.js per identificare i cambiamenti apportati (API deprecate, gestione dei moduli, ecc.).

E se si verifica un problema?

Se la tua applicazione non funziona correttamente dopo aver cambiato la versione di Node.js, puoi tornare a una versione precedente (se è ancora supportata) tramite la scheda Impostazioni avanzate del sito interessato.

Questa guida spiega come regolare la configurazione di un sito Node.js ospitato sull'infrastruttura Infomaniak. Imparerai ad adattare il comportamento della tua applicazione in base alla sua evoluzione, alle sue dipendenze o alle tue preferenze tecniche.

Prerequisiti

• Installare un sito Node.js sul tuo hosting.
• Testare le modifiche in locale prima di applicarle in produzione.
• Verificare che i tuoi script (start, build) siano definiti correttamente nel file package.json.
• Se modifichi la struttura del tuo progetto, ricorda di regolare la cartella di esecuzione e i comandi associati.
• Importante: la porta di ascolto definita nel Manager deve corrispondere a quella utilizzata nel codice dell'applicazione.

Accedere alla configurazione

Ogni sito dispone di un pannello di controllo dedicato per controllare l'applicazione (avvia, arresta, riavvia), consultare i log di esecuzione, gestire le versioni di Node.js e attivare i certificati SSL:

1. Clicca qui per accedere alla gestione del tuo sito sul Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome assegnato al sito interessato:
   
3. Clicca su Gestisci i parametri avanzati:
   
4. Clicca sulla scheda Node.js per accedere alle impostazioni:
   

Comandi e automatizzazione

Cartella di esecuzione

La cartella di esecuzione indica la posizione sul server in cui verranno eseguiti i comandi di costruzione (build) e di avvio. Deve puntare alla directory principale della tua applicazione, dove si trova il file package.json.

./          // Root directory
./app       // Subfolder named app
./backend   // Subfolder named backend

Comando di costruzione (Build)

Se la tua applicazione richiede una fase di preparazione (installazione delle dipendenze, compilazione TypeScript, minificazione), specifica qui il comando da eseguire. Questo è il metodo consigliato per distribuire i tuoi aggiornamenti.

A differenza di un'esecuzione manuale tramite SSH, questa interfaccia utilizza un ambiente con prestazioni potenziate per garantire una costruzione rapida senza influire sulle risorse del tuo sito in produzione. Puoi concatenare più compiti (come un git pull seguito da un build) e monitorare l'avanzamento e i log del processo in tempo reale direttamente dal Manager.

# Example: install dependencies and build
npm install && npm run build

# Example: update code and build with yarn
git pull && yarn install && yarn build

Nota: Se il tuo progetto è già compilato o non richiede alcuna fase intermedia, questo campo può rimanere vuoto.

Comando di avvio

Questo comando avvia il tuo server. Deve essere identico a quello utilizzato nel tuo ambiente di sviluppo locale per avviare il punto di ingresso dell'applicazione.

# Option 1: Direct file launch
node index.js

# Option 2: Using npm script
npm start

# Option 3: Using yarn script
yarn start

Porta di ascolto

La tua applicazione deve ascoltare obbligatoriamente sulla porta dinamica assegnata dal Manager. Questa porta viene trasmessa al tuo codice tramite la variabile d'ambiente PORT.

// Use the port provided by the environment
const port = process.env.PORT || 8080;

app.listen(port, () => {
  console.log(`Application started on port ${port}`);
});

Versione di Node.js

Puoi selezionare la versione desiderata di Node.js nelle impostazioni. È consigliabile privilegiare una versione stabile (LTS) per garantire la sicurezza e la longevità del tuo progetto.

Applica e valida le modifiche

Una volta salvate le tue modifiche nel Manager, devi riavviare la tua applicazione dal pannello di controllo affinché i nuovi parametri (nuova versione di Node, nuova porta o nuovo comando di build) vengano presi in considerazione.

In caso di difficoltà all'avvio, puoi consultare la console di esecuzione o fare riferimento a questa altra guida per la risoluzione dei problemi.

Questa guida vi aiuta a diagnosticare rapidamente l'origine di un problema se il vostro sito Node.js, ospitato sull'infrastruttura Infomaniak, non funziona come previsto.

Verificare lo stato dell'applicazione

Dal dashboard del vostro sito Node.js, potete consultare lo stato attuale dell'applicazione:

• Attivo: la vostra applicazione funziona normalmente.
• In corso di riavvio: l'applicazione si sta riavviando, attendete alcuni istanti.
• Arrestata o In errore: c'è un problema.

In caso di errore o di arresto:

• Cliccate su "Avvia" o "Riavvia" l'applicazione.
• Consultate immediatamente la console di esecuzione per identificare eventuali errori tecnici.

Leggere la console di esecuzione

La console visualizza i messaggi di errore generati durante l'avvio della vostra applicazione. Ecco gli errori frequenti:

• Comando di avvio errato: verificate di utilizzare la sintassi corretta (esempio: npm start, node app.js, ecc.).
• Errore nel codice sorgente: potrebbe trattarsi di un'eccezione non gestita, di un modulo mancante o di una porta definita in modo errato.

Verificare i parametri dell'applicazione

Nella sezione Parametri avanzati del sito, assicuratevi che tutte le impostazioni siano corrette:

• Cartella di esecuzione: cartella in cui vengono eseguiti i comandi build e start.
• Comando di costruzione (opzionale): ad esempio npm run build se la vostra app ne richiede uno.
• Comando di avvio: ad esempio node index.js, npm start, ecc.
• Porta di ascolto: la porta su cui l'applicazione attende le richieste (ad esempio 8080, 3000, ecc.).
  • La porta configurata nella vostra applicazione deve corrispondere a quella definita nel Manager.
• Versione di Node.js: assicuratevi che sia compatibile con il vostro codice.

Infomaniak mette a disposizione i gestori di pacchetti NPM e Yarn. È possibile scegliere quello che corrisponde al proprio progetto nell'assistente di configurazione.

Ancora bloccato?

Il sito rimane inaccessibile?

• La tua applicazione potrebbe essere in modalità manutenzione.
• La porta di ascolto dell'applicazione potrebbe essere errata o bloccata.
• L'applicazione non restituisce una risposta HTTP corretta (ad esempio, non è presente res.send() o res.end() nel server).

Hai utilizzato un metodo di installazione avanzato?

Se hai importato il tuo codice tramite Git, ZIP, SSH o SFTP, assicurati che:

• Il codice sia stato correttamente decompresso o clonato nella cartella giusta.
• I file essenziali (package.json, server.js, index.js, ecc.) siano presenti.
• Le dipendenze siano correttamente installate (node_modules presente dopo npm install o yarn install).

Se il problema persiste dopo tutti questi controlli:

• Prova a creare un nuovo sito con il metodo semplice per testare con un esempio funzionante.
• Confronta la tua configurazione con quella dell'esempio fornito.
• Consulta la documentazione ufficiale di Node.js per errori specifici.
• In caso di necessità, contatta il supporto Infomaniak con una copia dei log visualizzati nella console.

I siti Node.js proposti da Infomaniak permettono di eseguire applicazioni Node.js in un ambiente flessibile, pronto all'uso, senza dover gestire un'infrastruttura server.

Premessa

• Offrendo la flessibilità di un server senza la complessità della sua amministrazione, questo tipo di hosting è particolarmente adatto ai progetti API REST, per distribuire il CMS Ghost, n8n, Strapi o framework come Express.js, NestJS o ancora socket.io, next.js, strumenti aziendali o prototipi per:
  • sviluppatori che desiderano distribuire applicazioni Node.js senza gestire l'infrastruttura.
  • webmaster che cercano di sperimentare o formarsi a Node.js.
  • agenzie e freelance che lavorano su più progetti clienti.
  • studenti, insegnanti e scuole che necessitano di un ambiente semplice per testare il codice.
• I gestori di pacchetti NPM e Yarn sono supportati.
• Se installi Node.js su un hosting Web all'interno di un Server Cloud, il tuo sito non funzionerà con le risorse garantite del Server Cloud gestito.
  • Consulta questa altra guida per utilizzare Fast Installer e distribuire NVM.
• Node.js = nome ufficiale del linguaggio/ambiente; NodeJS = nome "tecnico" o semplificato in alcuni contesti (spesso per motivi pratici, non c'è una vera differenza tecnica).

Creare un sito Node.js

Per accedere a un piano di hosting Web e aggiungere un sito Node.js:

1. Clicca qui per accedere alla gestione dei tuoi hosting nel Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito all'hosting interessato:
   
3. Clicca sul pulsante blu Aggiungi:
   
4. Scegli un progetto con tecnologie avanzate.
5. Clicca su Avanti:
   
6. Scegli Node.js.
7. Seleziona un'altra versione se necessario.
8. Clicca su Avanti:
   
9. Scegli il tipo di dominio da assegnare a questo nuovo sito:
   1. un nome di dominio già acquisito
   2. un sottodominio creato a partire da un nome di dominio già acquisito
   3. un nome di dominio ancora disponibile e da ordinare
10. Inserisci il nome di dominio o il sottodominio.
11. Scegli le eventuali opzioni avanzate.
12. Clicca su Avanti:
    
13. Scegli una delle due opzioni disponibili:
    
    1. Metodo rapido:
       • Un progetto di esempio preconfigurato viene installato automaticamente.
       • Questa opzione è ideale per scoprire Node.js o avviare rapidamente una base funzionale.
    2. Metodo personalizzato:
       • Il codice sorgente può essere importato tramite Git, archivio ZIP, SSH o SFTP.
       • Definisci tu stesso gli script, i punti di ingresso, la porta di ascolto e i comandi di build necessari.
14. È tutto pronto, il sito è pronto:
    

Ogni sito ha un pannello di controllo dedicato per gestire l'applicazione (start, stop, restart), visualizzare la console di esecuzione, gestire le versioni di Node.js, configurare i domini e attivare i certificati SSL:

Per approfondire la configurazione del tuo sito Node.js, consulta questa altra guida.

Questa guida spiega come importare dati esterni (file, cartelle, ecc.) nel tuo kDrive utilizzando il protocollo WebDAV fornito dal tuo hosting Cloud.

Premessa

• Consulta questa altra guida se stai cercando informazioni per copiare dati specifici da un kDrive a un altro quando il tuo utente ha accesso ai 2 kDrive interessati.

Importare dati esterni tramite WebDAV

Prerequisiti

• Possedere un'offerta kDrive o kSuite
• Avere i permessi sufficienti all'interno di kDrive o kSuite.
• Non cambiare la password fino a quando l'importazione non è completata!

Per accedere allo strumento di importazione, dove i dati devono essere importati:

1. Clicca qui per accedere all'app Web kDrive Infomaniak (servizio online ksuite.infomaniak.com/kdrive).
2. Clicca sull'icona Impostazioni ‍ in alto a destra.
3. Verifica o seleziona il kDrive interessato nel menu a discesa del menu laterale sinistro.
4. Clicca su Generale nel menu laterale sinistro.
5. Clicca su Importa dati esterni:
   
6. Clicca il pulsante blu Avvia:
   
7. Clicca su WebDAV.
8. Completa le informazioni richieste in base alla fonte (in particolare l'indirizzo WebDAV in tuo possesso - ottenuto dalla fonte).
9. Scegli il kDrive di destinazione e la posizione desiderata per accogliere i dati importati.
10. Clicca su Avvia:
    

Questa guida dettaglia le regole specifiche da rispettare durante la creazione di una password utente con mysqli_connect() che contiene il carattere “dollaro” $ sulle piattaforme Infomaniak.

Premessa

• Se durante l'utilizzo di mysqli_connect(), ricevi il messaggio di errore "Accesso negato per l'utente" e la tua password del database contiene un segno $, il problema potrebbe essere legato al funzionamento delle stringhe in PHP.
• Il problema può verificarsi anche con gli script di messaggistica.

Regole da rispettare

Quando viene utilizzato il carattere speciale $ in una password utente e questo è seguito da qualsiasi altro carattere diverso da un numero, il nome della variabile non è valido e la sostituzione non avviene correttamente.

Ecco alcune soluzioni per correggere questo problema:

• Inserisci la password tra virgolette semplici: '$******'
• Assicurati che un numero segua direttamente il dollaro: "$2*****"
• Usa un anti-slash per "scappare" il dollaro nella password: "\$****"

Questa guida spiega quali sono le differenze tra un Dominio (o sito principale), un Sottodominio e un Alias.

Premessa

• Sebbene siano collegati, questi tre elementi (Dominio, Sottodominio e Alias) hanno funzioni e finalità diverse.
• Possono influenzare un Hosting Web tramite il suo nome di dominio, o anche la messaggistica poiché è del tutto possibile avere indirizzi email su un sottodominio, ad esempio.

Cos'è un Dominio?

Il dominio o nome di dominio è la porta d'accesso principale al tuo sito Web. È da qui che i tuoi utenti accederanno al tuo contenuto. È questo dominio principale che definisce ciò che apparirà nella barra degli indirizzi dei browser dei tuoi utenti.

Prerequisiti

• Possedere un dominio.
• Possedere un hosting Web Infomaniak.

Consulta la guida Creare un nuovo sito sul tuo hosting Web.

Cos'è un Sottodominio?

Il Sottodominio è rappresentato da una parola aggiuntiva che si trova prima del tuo nome di dominio principale. Questo è molto utile in diversi casi, ad esempio:

• può servire a visualizzare contenuti "esclusivi" o mirati, ad esempio, andando su faq.infomaniak.com si accede alla base di conoscenza dove si trovano tutte le guide
• può anche servire (temporaneamente o definitivamente) durante la creazione di un nuovo sito o il rifacimento di un sito esistente, creando ad esempio new.domain.xyz quando il sito principale era fino ad allora domain.xyz

Prerequisiti

• Possedere almeno un dominio.
• Possedere un hosting Web Infomaniak.

Consulta la guida Aggiungere un sottodominio al tuo hosting Web.

Cos'è un Alias?

Un Alias o Dominio Alias è un secondo nome di dominio che punta direttamente al tuo sito principale, condividono le stesse pagine Web. L'alias è un'altra porta di accesso al tuo sito Web. Ad esempio, il sito principale della Confederazione elvetica è www.ch.ch e www.suisse.ch è il suo alias.

Prerequisiti

• Possedere più nomi di dominio.
• Possedere un hosting Web Infomaniak.

Consulta la guida Aggiungere un alias al tuo hosting Web.

L'equivalente esiste anche per un Servizio Mail.

L'interesse di un Alias è quello di permettervi di aumentare la visibilità del vostro sito presso il vostro target, proponendogli più punti di accesso.

Questa guida dettaglia gli intervalli di indirizzi IP pubblici utilizzati da Infomaniak; ciò facilita in particolare la configurazione dei sistemi di sicurezza (firewall, filtraggio, whitelisting).

Premessa

• Gli indirizzi sono indicati nel formato CIDR (esempio: 192.0.2.0/24), che raggruppa più indirizzi consecutivi.
• Il formato dell'elenco include gli intervalli IP (range) utilizzati dai seguenti prodotti:
  • kuite: tutti i prodotti kSuite
  • vps: tutti i VPS
  • public-cloud: tutto il Public Cloud
  • all: include tutti gli IP della rete Infomaniak

Intervalli di indirizzi IPv4 e IPv6

Il link al file JSON che elenca gli IP è:

https://prefixes.infomaniak.com/json

Questa guida riguarda le applicazioni OAuth2 per connetterti ai tuoi servizi esterni tramite il tuo identificativo di accesso Infomaniak.

Gestire le app OAuth2 Infomaniak

Per fare questo:

1. Clicca qui per accedere alla gestione del tuo prodotto su Infomaniak Manager (hai bisogno di aiuto?).
2. Clicca il pulsante blu Crea una nuova applicazione:
   
3. Scegli il tipo adeguato in base alle tue esigenze e al progetto attuale.
4. Dai un nome all'applicazione.
5. Inserisci l'URL dell'applicazione in base alle informazioni tecniche a tua disposizione.
6. Clicca sul pulsante per creare l'applicazione:
   
7. Copia le informazioni (Client ID, Client secret) in un luogo sicuro - non saranno più accessibili dopo questo:
   

Questa guida spiega come rimuovere un sito da un Hosting Web.

Introduzione

• Una volta rimosso, il sito non sarà più visibile su Internet all'URL precedente.
• La quota di siti disponibili sul tuo hosting riacquisterà uno spazio libero.

Rimuovere un sito da un hosting Web a pagamento

Per accedere agli Hosting Web e rimuovere un sito:

1. Clicca qui per accedere alla gestione del tuo hosting su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome assegnato all'hosting in questione:
   
3. Clicca sul menu delle azioni ⋮ a destra del sito in questione nella tabella che viene visualizzata.
4. Clicca su Rimuovi il sito:
   

Dissociare un sito da un hosting Starter gratuito

Un hosting Starter (pagina Web di base) contiene un solo sito, che è associato al nome di dominio stesso. Pertanto, non è possibile, come per le offerte a pagamento, gestire più siti o rimuovere un sito per aggiungerne un altro.

È necessario quindi cancellare direttamente l'hosting Starter:

• Questo cancellerà solo il tuo prodotto di hosting Web Starter, ovvero la parte relativa al tuo sito Web, senza influire su altri prodotti, come la posta elettronica o il nome di dominio.
• Dovrete confermare la richiesta di disdetta tramite e-mail, altrimenti nessun dato verrà eliminato.
• Una conferma di disdetta verrà inviata agli altri amministratori dell'Organizzazione, se presenti.
• I backup verranno eliminati in modo definitivo al momento della disdetta, rendendo impossibile qualsiasi ripristino.

Per disdire:

1. Clicca qui per accedere alla gestione del tuo hosting su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca sul menu azioni ⋮ situato a destra dell'hosting interessato.
3. Seleziona l'opzione Disdici:
   
4. Segui la procedura fino alla fine.