Documentazione

Guida alla pubblicazione

Una guida pratica per pubblicare siti statici, preparare build di framework, connettere domini e aggiornare progetti su DeployPages.

Pubblicazione ReactEsportazione Next.jsRicerca DNSControllo SSLGeneratore meta tag

Avvio rapido

Pubblicare significa trasformare i file locali del sito in un URL che le persone possono aprire. DeployPages è pensato per output statici, quindi la prima pubblicazione può partire da una cartella invece che da una configurazione server.

Opzione 1: pubblicazione tramite trascinamento

Il percorso più veloce per progetti statici. Se il sito è già HTML, CSS, JavaScript o una cartella build completata, puoi caricarlo direttamente.

Adatto per

Pagine di destinazione, siti personali, curriculum, prototipi, documentazione statica e altri output frontend nativi del browser.
  • 1
    Preparare la cartella del progetto

    La cartella da pubblicare dovrebbe includere un file index.html nella radice, più eventuali stili, script o asset immagine da cui dipende la pagina.

    Esempio di struttura delle cartelle
    mio-sito/├── index.html├── styles.css├── script.js└── images/    ├── logo.png    └── hero.jpg

    Errore comune

    Se index.html manca o è sepolto all'interno di una sottocartella, il sito non verrà risolto correttamente dopo il caricamento.
  • 2
    Apri l'area di caricamento

    Utilizza l'area di caricamento su DeployPages. Puoi pubblicare prima un progetto temporaneo, quindi accedere in seguito se desideri mantenerlo.

  • 3
    Carica la cartella

    Trascina l'intera cartella nell'area di caricamento o sceglila dal selettore file. Per i framework, carica la cartella di output della build invece dell'albero sorgente.

  • 4
    Apri l'URL generato

    Una volta completato il caricamento, DeployPages restituisce un URL online che puoi usare subito per testare o condividere.

Opzione 2: flusso CLI

Utile quando la stessa build viene pubblicata più volte e la pubblicazione appartiene a uno script, un job CI o una checklist di rilascio.

Usalo quando il progetto è diventato ripetibile

Il trascinamento della selezione è preferibile per le anteprime una tantum. Un flusso CLI ha senso quando un team ha bisogno che la stessa cartella di output venga pubblicata ogni volta nello stesso modo.

Installa CLI

Usa il tuo package manager preferito per installare la CLI a livello globale.

npm install -g @deploypages/cli

Autenticati

Esegui il comando login e completa il passaggio di autorizzazione basato sul browser.

deploypages login

Pubblica la cartella corrente

Esegui il comando deploy dalla directory di output della build.

deploypages deploy

Guida alla build dei framework

I framework moderni necessitano di un passaggio build prima del caricamento. L'obiettivo è sempre lo stesso: generare semplici file statici che il browser possa aprire direttamente.

Cosa significa "build"

Una build converte i file sorgente del framework in HTML, CSS, JavaScript e asset pubblicabili.

React / Vue / Vite

Command:npm run build
Output:dist/

Carica la cartella dist stessa, non la root del progetto.

Esportazione statica Next.js

Command:npm run build
Output:out/

Imposta output: 'export' in next.config.js prima della build.

Semplice HTML

Command:Nessun passaggio build richiesto
Output:La tua cartella esistente

Mantieni semplicemente index.html alla radice.

Hugo/Hexo

Command:hugo oppure hexo generate
Output:public/

Carica la cartella public generata.

Esempio di esportazione Next.js

next.config.js
/** @type {import('next').NextConfig} */const nextConfig = {  output: 'export',  images: { unoptimized: true },};
module.exports = nextConfig;

Limiti di esportazione statici

Funzionalità renderizzate dal server come route API, server-side props e middleware non sono disponibili in una build esportata staticamente.

Domini personalizzati

DeployPages può collegare il tuo dominio dopo la prima pubblicazione, così il progetto può passare da un link temporaneo a un indirizzo di produzione con il tuo brand.

Cosa conta come dominio?

Qualsiasi dominio che gestisci tramite un registrar può funzionare, purché tu possa modificare i suoi record DNS.

Passaggio 1: aggiungi il dominio nella console

Vai alle impostazioni del progetto, apri la scheda domini e aggiungi il nome host a cui desideri connetterti.

Passaggio 2: configurare DNS

DeployPages fornirà i target DNS necessari per verificare la proprietà e instradare il traffico.

Passaggio 3: attendi la verifica

Una volta propagato DNS, lo stato del dominio diventa integro e il provisioning di HTTPS può essere completato.

TipoHostValoreScopo
CNAMEwwwcname.deploypages.siteIndirizza il traffico verso la piattaforma
TXT_deploypages-challengedeploypages-verify=...Verifica la proprietà del dominio

Scelta del record host

  • Utilizza www quando ti connetti a www.example.com.
  • Utilizza @ quando colleghi il dominio root example.com.
  • Utilizza un'etichetta di sottodominio come blog quando colleghi blog.example.com.

Aggiornamento di un sito

Stesso flusso, nuova versione

L'aggiornamento di un progetto usa la stessa logica della prima pubblicazione: genera l'ultimo output, caricalo e lascia che la piattaforma sostituisca la versione online.
  • 1
    Modifica i file di origine

    Modifica testi, stili, media o asset in locale.

  • 2
    Ricostruisci quando necessario

    Se il progetto usa un framework, genera prima una nuova directory di output della build.

  • 3
    Apri la console del progetto

    Torna alla pagina del progetto in DeployPages.

  • 4
    Carica la nuova versione

    Sostituisci la build precedente con la cartella più recente. La cronologia di pubblicazione mantiene tracciabile la versione più nuova.

Una volta completato il caricamento, la nuova build diventa attiva e le versioni precedenti restano disponibili per ripristinare una versione precedente.

Domande frequenti

I non sviluppatori possono utilizzare DeployPages?
Sì. Se il sito è già esportato come file statico, è sufficiente la pubblicazione tramite trascinamento.
Perché vedo un 404 dopo la pubblicazione?
Il motivo più comune è un file index.html mancante o nel posto sbagliato. Assicurati che il punto di ingresso pubblicabile sia nella radice della cartella caricata.
Cosa succede se i percorsi React o Vue si interrompono durante l'aggiornamento?
DeployPages supporta il fallback SPA per configurazioni frontend statiche comuni, ma la build deve comunque essere esportata correttamente.
Posso caricare video o risorse più grandi?
Sì, ma le prestazioni sono migliori quando i media di grandi dimensioni vengono ottimizzati o ospitati attraverso il giusto canale di pubblicazione specializzato.
Posso proteggere con password un sito?
Sì sui piani che includono la protezione tramite password. Usalo per anteprime, documenti interni o lanci graduali.
Vai a Esplora