Square CloudSquare Cloud

Variabili d’ambiente fuori dal tuo codice

Conserva token, password e stringhe di connessione nelle impostazioni di ogni applicazione. I valori restano nascosti sullo schermo, un .env entra con un solo incolla e un riavvio applica la modifica senza un nuovo upload.

Fino a 256 variabili per applicazione, in tutti i piani. Anche dalla CLI e dall’API.

Come funziona

Le variabili appartengono all’applicazione, non ai file che carichi. Cambiane una e il prossimo avvio la usa.

  1. 01

    Aggiungi o incolla

    Scrivi una chiave e il suo valore, incolla righe KEY=valore in un campo chiave o importa un file .env.

  2. 02

    Salva

    Un solo salvataggio invia l’intera lista. I valori che la shell taglierebbe o espanderebbe partono tra virgolette.

  3. 03

    Riavvia

    Subito dopo il salvataggio, la dashboard ti propone il riavvio. L’applicazione parte con i nuovi valori, senza un nuovo upload.

I segreti restano nascosti sullo schermo

L’editor nelle impostazioni della tua applicazione nasconde ogni valore finché non lo chiedi e tiene vicine le chiavi correlate.

Valori nascosti

I valori appaiono come puntini. Mostrane uno con l’occhio, copialo senza mostrarlo o fai clic per modificarlo.

  • Ogni modifica si conferma o si annulla a parte
  • Tieni premuto Shift per rimuovere una riga con un clic

Raggruppate per prefisso

Le chiavi con lo stesso prefisso, come DB_HOST e DB_USER, sono elencate insieme, in ordine alfabetico.

  • Ricerca per chiave oltre le 15 variabili
  • Un avviso compare quando restano pochi posti

Predefinite di Square Cloud

HOST, PORT e SQUARECLOUD_APP_ID arrivano con ogni applicazione, in sola lettura e con una nota su a cosa serve ciascuna.

  • HOST 0.0.0.0 e PORT 80 per l’HTTP
  • L’ID dell’applicazione, per il tuo codice
  • Fino a 256 variabili per applicazione
  • Chiavi fino a 1.024 caratteri, valori fino a 4.096
  • In un workspace, solo gli amministratori aprono l’editor
  • Incluso in tutti i piani

Porta il .env che hai già

Importa un file .env e controllalo prima che cambi qualcosa: chiavi nuove, chiavi che verrebbero sostituite e righe che non possono entrare, ognuna con il numero di riga e il motivo.

Incolla righe intere

Incolla più righe KEY=valore in un campo chiave e ognuna diventa una riga. Una chiave che hai già prende il valore incollato.

  • Commenti e prefisso export sono supportati
  • Incollare in una riga compilata mantiene quella variabile

Impostale durante il deploy

Anche il modulo di deploy accetta variabili e, quando il progetto ha un .env.example, ti propone quelle chiavi da compilare.

  • Legge anche .env.sample, .env.template e .env.dist
  • Lascia HOST e PORT a Square Cloud

Esporta o copia

Scarica tutte le variabili come file di testo KEY=VALUE, oppure copiale tutte, per portarle in un’altra applicazione.

  • I valori escono tra virgolette, pronti da caricare
  • Le righe senza chiave restano fuori

I valori arrivano al codice come li hai scritti

La tua applicazione carica le variabili tramite una shell, dove uno spazio, un $ o un ; può troncare o cambiare un valore. L’editor mette questi valori tra virgolette per te.

  • Virgolette dove servono

    Un valore con spazi o caratteri come $, &, ;, | o ) va tra virgolette singole quando lo confermi, lo importi o salvi.

  • Virgolette rischiose rifiutate

    Le virgolette doppie attorno a un valore con $ lascerebbero alla shell la possibilità di espanderlo, quindi l’editor ti chiede di toglierle o di usare quelle singole.

  • Chiavi sempre valide

    Gli spazi in una chiave diventano trattini bassi, e una chiave non può ripetersi. In un import, la chiave deve iniziare con una lettera o _.

Dal terminale e dall’API

Le stesse variabili sono raggiungibili dalla CLI, dalla GitHub Action, dall’estensione VS Code e dall’API REST.

CLI di Square Cloud
squarecloud app env set DB_HOST=10.0.0.4 "GREETING=hi there"squarecloud app env set --from-file .envsquarecloud app env list

Dalla versione 3.1.1, la CLI mette tra virgolette i valori con spazi o simboli. Scopri tutto quello che fa la CLI.

API REST
curl -X POST "https://api.squarecloud.app/v2/apps/$APP_ID/envs" \  -H "Authorization: $SQUARECLOUD_API_KEY" \  -H "Content-Type: application/json" \  -d '{"envs": {"NODE_ENV": "production", "LOG_LEVEL": "info"}}'curl -X POST "https://api.squarecloud.app/v2/apps/$APP_ID/restart" \  -H "Authorization: $SQUARECLOUD_API_KEY"

Invia i valori come la shell deve leggerli, tra virgolette singole se hanno spazi o simboli. Un riavvio li applica.

  • GET
    /v2/apps/{appId}/envs

    Elenca le variabili d’ambiente dell’applicazione.

  • POST
    /v2/apps/{appId}/envs

    Aggiunge variabili o modifica quelle esistenti. Le altre restano come sono.

  • PUT
    /v2/apps/{appId}/envs

    Sostituisce tutte le variabili con quelle che invii.

  • DELETE
    /v2/apps/{appId}/envs

    Rimuove le variabili che indichi.

  • Le chiavi API possono essere limitate a envs:read o envs:write e a una sola applicazione.
Riferimento API

Domande sulle variabili d’ambiente

Cosa sono le variabili d’ambiente su Square Cloud?

Sono coppie chiave-valore salvate nelle impostazioni della tua applicazione e caricate all’avvio. Tengono token, password e stringhe di connessione fuori dal tuo codice e dai file che carichi. Ogni applicazione ha la sua lista, fino a 256 variabili.

Devo rifare il deploy dopo aver cambiato una variabile?

No. Salva la modifica e riavvia l’applicazione: parte con i nuovi valori, senza un nuovo upload. Fino al riavvio, il processo attuale mantiene i valori con cui è partito.

Quali variabili fornisce Square Cloud?

HOST (0.0.0.0), PORT (80) e SQUARECLOUD_APP_ID, l’ID dell’applicazione. Compaiono in sola lettura in cima all’editor. Un’applicazione web in ascolto su quell’host e quella porta è raggiungibile via HTTP.

Come salvo un valore con spazi, virgolette o un $?

Scrivilo così com’è. La dashboard e la CLI mettono questi valori tra virgolette singole, così la shell li carica senza modifiche. Tramite l’API, inviali già tra virgolette singole. Evita le virgolette doppie attorno a un valore con $: la shell lo espanderebbe.

Posso tenere un file .env nel progetto?

Puoi, ma meglio importarlo nella dashboard: le variabili impostate lì hanno la precedenza sui valori di quel file. Per tenere il file fuori dai tuoi upload, elencalo in squarecloud.ignore, che leggono la CLI e l’estensione VS Code.

Chi può vedere i valori?

Nel tuo account, solo tu. In un workspace, solo i membri con permesso di amministratore aprono l’editor. Una chiave API ha bisogno dello scope envs:read, o dell’accesso completo, per leggerli.

Quante variabili può avere un’applicazione?

Fino a 256, con chiavi fino a 1.024 caratteri e valori fino a 4.096. L’editor ti avvisa quando restano pochi posti e non salva oltre il limite.

I siti statici hanno variabili d’ambiente?

No. Un sito statico viene servito come file, senza un processo che le legga, quindi le sue impostazioni non hanno la scheda delle variabili. Servono alle applicazioni con un runtime, come Node.js, Python, Java, Go o Rust.

Un piano per ogni fase del tuo progetto

Dal primo deploy a 1 TB di RAM, senza cambiare piattaforma. Ogni fase aggiunge memoria e funzionalità alla precedente, e l'upgrade vale subito.

Confronta tutti i piani
1 GB → 2 GB

Hobby

Porta l'idea fuori dal localhost e mettila online.

  • Fino a 2 vCPU
  • Metriche in tempo reale
  • Blob Storage
  • Rollback con 1 clic
  • Square Shield anti-DDoS

A partire da12,49 BRL/mese

4 GB → 8 GB

Standard

Consigliato

Produzione con database, dominio personalizzato e team.

  • Fino a 4 vCPU
  • Database
  • Dominio personalizzato
  • Load balancer
  • AI Gateway
  • Workspace

A partire da44,99 BRL/mese

12 GB → 24 GB

Pro

Più memoria, snapshot giornalieri e visibilità su ciò che gira.

  • Fino a 12 vCPU
  • Snapshot giornalieri delle applicazioni
  • Analisi delle prestazioni
  • Supporto prioritario

A partire da124,99 BRL/mese

32 GB → 1 TB

Enterprise

Grandi operazioni, con un canale Discord privato.

  • Fino a 16 vCPU
  • Canale Discord privato

A partire da299,90 BRL/mese

HobbyStandardProEnterprise
Calcolo
Memoria RAM1 GB → 2 GB4 GB → 8 GB12 GB → 24 GB32 GB → 1 TB
vCPU1 → 246 → 1216
Piattaforma
Metriche in tempo realeInclusoInclusoInclusoIncluso
Blob StorageInclusoInclusoInclusoIncluso
Rollback con 1 clicInclusoInclusoInclusoIncluso
Square Shield anti-DDoSInclusoInclusoInclusoIncluso
DatabaseNon inclusoInclusoInclusoIncluso
Dominio personalizzatoNon inclusoInclusoInclusoIncluso
Load balancerapp per dominioNon incluso2510
AI GatewayNon inclusoInclusoInclusoIncluso
Snapshot giornalieri delle applicazioniNon inclusoNon inclusoInclusoIncluso
Analisi delle prestazioniNon inclusoNon inclusoInclusoIncluso
Team e supporto
Workspacemembri per workspaceNon incluso3 → 710 → 2020 → 50
Supporto prioritarioNon inclusoNon inclusoInclusoIncluso
Canale Discord privatoNon inclusoNon inclusoNon inclusoIncluso

4,9 su 5

482 recensioni su Google e Trustpilot

Ospitato in un datacenter partner con certificazioni

  • Tier 3
  • ISO 27001
  • SOC 2 Type II
  • Protezione DDoS Always-On
Esplora la nostra infrastruttura

Pronto a scalare il tuo progetto?

Unisciti agli oltre 500.000 sviluppatori che hanno usato Square Cloud per ospitare i loro progetti.

  • Prezzi prevedibili
  • Nessuna sorpresa in fattura
  • Deploy in pochi secondi
  • Alta disponibilità
  • Scala con stabilità
  • Riavvio automatico
  • SSL e sicurezza inclusi
  • Container isolati