Square CloudSquare Cloud

Umgebungsvariablen, getrennt von Ihrem Code

Speichern Sie Tokens, Passwörter und Verbindungs-Strings in den Einstellungen jeder Anwendung. Werte bleiben auf dem Bildschirm maskiert, eine .env ist mit einem Einfügen übernommen, und ein Neustart übernimmt die Änderung ohne neuen Upload.

Bis zu 256 Variablen pro Anwendung, in jedem Plan. Auch über die CLI und die API.

So funktioniert es

Variablen gehören zur Anwendung, nicht zu den Dateien, die Sie hochladen. Ändern Sie eine, und der nächste Start verwendet sie.

  1. 01

    Hinzufügen oder einfügen

    Geben Sie einen Schlüssel und seinen Wert ein, fügen Sie KEY=Wert-Zeilen in ein Schlüsselfeld ein oder importieren Sie eine .env-Datei.

  2. 02

    Speichern

    Ein Speichern sendet die ganze Liste. Werte, die die Shell trennen oder erweitern würde, werden dabei in Anführungszeichen gesetzt.

  3. 03

    Neu starten

    Direkt nach dem Speichern bietet das Dashboard einen Neustart an. Die Anwendung startet mit den neuen Werten, ohne neuen Upload.

Secrets bleiben auf dem Bildschirm verborgen

Der Editor in den Einstellungen Ihrer Anwendung maskiert jeden Wert, bis Sie ihn anzeigen lassen, und hält zusammengehörige Schlüssel beieinander.

Maskierte Werte

Werte erscheinen als Punkte. Zeigen Sie einen über das Auge an, kopieren Sie ihn, ohne ihn anzuzeigen, oder klicken Sie zum Bearbeiten darauf.

  • Jede Änderung wird einzeln bestätigt oder verworfen
  • Mit gedrückter Umschalttaste eine Zeile per Klick entfernen

Nach Präfix gruppiert

Schlüssel mit gemeinsamem Präfix, etwa DB_HOST und DB_USER, stehen zusammen, alphabetisch sortiert.

  • Suche nach Schlüssel ab mehr als 15 Variablen
  • Ein Hinweis erscheint, wenn nur noch wenige Plätze frei sind

Square-Cloud-Standard

HOST, PORT und SQUARECLOUD_APP_ID gehören zu jeder Anwendung, schreibgeschützt und mit einem Hinweis, wofür sie da sind.

  • HOST 0.0.0.0 und PORT 80 für HTTP
  • Die eigene ID der Anwendung für Ihren Code
  • Bis zu 256 Variablen pro Anwendung
  • Schlüssel bis 1.024 Zeichen, Werte bis 4.096
  • In einem Workspace öffnen nur Admins den Editor
  • In jedem Plan enthalten

Bringen Sie Ihre vorhandene .env mit

Importieren Sie eine .env-Datei und prüfen Sie sie, bevor sich etwas ändert: neue Schlüssel, Schlüssel, die ersetzt würden, und Zeilen, die nicht übernommen werden können, jeweils mit Zeilennummer und Grund.

Ganze Zeilen einfügen

Fügen Sie mehrere KEY=Wert-Zeilen in ein Schlüsselfeld ein, und jede wird zu einer Zeile. Ein vorhandener Schlüssel übernimmt den eingefügten Wert.

  • Kommentare und das Präfix export werden berücksichtigt
  • Einfügen in eine ausgefüllte Zeile behält diese Variable

Schon beim Deploy festlegen

Das Deploy-Formular nimmt ebenfalls Variablen an und bietet, wenn Ihr Projekt eine .env.example enthält, deren Schlüssel zum Ausfüllen an.

  • Liest auch .env.sample, .env.template und .env.dist
  • Überlässt HOST und PORT Square Cloud

Exportieren oder kopieren

Laden Sie alle Variablen als KEY=VALUE-Textdatei herunter oder kopieren Sie alle auf einmal, um sie in eine andere Anwendung zu übernehmen.

  • Werte kommen in Anführungszeichen, ladebereit
  • Zeilen ohne Schlüssel bleiben außen vor

Werte erreichen Ihren Code so, wie Sie sie eingegeben haben

Ihre Anwendung lädt ihre Variablen über eine Shell, in der ein Leerzeichen, ein $ oder ein ; einen Wert abschneiden oder verändern kann. Der Editor setzt solche Werte für Sie in Anführungszeichen.

  • Anführungszeichen, wo nötig

    Ein Wert mit Leerzeichen oder Zeichen wie $, &, ;, | oder ) kommt in einfache Anführungszeichen, wenn Sie ihn bestätigen, importieren oder speichern.

  • Riskante Anführungszeichen abgelehnt

    Doppelte Anführungszeichen um einen Wert mit $ ließen die Shell ihn erweitern, daher bittet der Editor Sie, sie zu entfernen oder einfache zu verwenden.

  • Gültige Schlüssel

    Leerzeichen in einem Schlüssel werden zu Unterstrichen, und ein Schlüssel darf nicht doppelt vorkommen. Beim Import muss ein Schlüssel mit einem Buchstaben oder _ beginnen.

Über das Terminal und die API

Dieselben Variablen erreichen Sie über die CLI, die GitHub Action, die VS Code-Erweiterung und die REST-API.

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

Seit Version 3.1.1 setzt die CLI Werte mit Leerzeichen oder Symbolen für Sie in Anführungszeichen. Alles, was die CLI kann.

REST-API
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"

Senden Sie Werte so, wie die Shell sie lesen soll, in einfachen Anführungszeichen, wenn sie Leerzeichen oder Symbole enthalten. Ein Neustart übernimmt sie.

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

    Listet die Umgebungsvariablen der Anwendung auf.

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

    Fügt Variablen hinzu oder ändert vorhandene. Die übrigen bleiben unverändert.

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

    Ersetzt alle Variablen durch die gesendeten.

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

    Entfernt die angegebenen Variablen.

  • API-Schlüssel lassen sich auf envs:read oder envs:write und auf eine einzelne Anwendung beschränken.
API-Referenz

Fragen zu Umgebungsvariablen

Was sind Umgebungsvariablen bei Square Cloud?

Schlüssel-Wert-Paare, die in den Einstellungen Ihrer Anwendung gespeichert und beim Start geladen werden. Sie halten Tokens, Passwörter und Verbindungs-Strings aus Ihrem Code und aus den hochgeladenen Dateien heraus. Jede Anwendung hat ihre eigene Liste mit bis zu 256 Variablen.

Muss ich nach dem Ändern einer Variable neu deployen?

Nein. Speichern Sie die Änderung und starten Sie die Anwendung neu: Sie startet mit den neuen Werten, ohne neuen Upload. Bis zum Neustart behält der laufende Prozess die Werte, mit denen er gestartet ist.

Welche Variablen stellt Square Cloud bereit?

HOST (0.0.0.0), PORT (80) und SQUARECLOUD_APP_ID, die eigene ID der Anwendung. Sie stehen schreibgeschützt oben im Editor. Eine Webanwendung, die auf diesem Host und Port lauscht, ist über HTTP erreichbar.

Wie speichere ich einen Wert mit Leerzeichen, Anführungszeichen oder $?

Geben Sie ihn so ein, wie er ist. Dashboard und CLI setzen solche Werte in einfache Anführungszeichen, damit die Shell sie unverändert lädt. Über die API senden Sie sie bereits in einfachen Anführungszeichen. Vermeiden Sie doppelte Anführungszeichen um einen Wert mit $: Die Shell würde ihn erweitern.

Kann ich eine .env-Datei im Projekt behalten?

Ja, aber importieren Sie sie besser im Dashboard: Die dort gesetzten Variablen haben Vorrang vor den Werten in dieser Datei. Um die Datei aus Ihren Uploads herauszuhalten, tragen Sie sie in squarecloud.ignore ein, das die CLI und die VS Code-Erweiterung lesen.

Wer kann die Werte sehen?

In Ihrem Konto nur Sie. In einem Workspace öffnen nur Mitglieder mit Admin-Berechtigung den Editor. Ein API-Schlüssel braucht den Scope envs:read oder vollen Zugriff, um sie zu lesen.

Wie viele Variablen kann eine Anwendung haben?

Bis zu 256, mit Schlüsseln bis 1.024 Zeichen und Werten bis 4.096. Der Editor warnt Sie, wenn nur noch wenige Plätze frei sind, und speichert nicht über das Limit hinaus.

Haben statische Websites Umgebungsvariablen?

Nein. Eine statische Website wird als Dateien ausgeliefert, ohne Prozess, der sie lesen könnte, daher haben ihre Einstellungen keinen Variablen-Tab. Sie sind für Anwendungen mit Runtime gedacht, etwa Node.js, Python, Java, Go oder Rust.

Ein Plan für jede Phase Ihres Projekts

Vom ersten Deploy bis 1 TB RAM, ohne die Plattform zu wechseln. Jede Phase ergänzt die vorherige um Speicher und Funktionen, und Upgrades gelten sofort.

Alle Pläne vergleichen
1 GB → 2 GB

Hobby

Bringen Sie die Idee vom localhost ins Netz.

  • Bis zu 2 vCPU
  • Echtzeit-Metriken
  • Blob Storage
  • Rollback mit 1 Klick
  • Square Shield gegen DDoS

Ab12,49 R$/Monat

4 GB → 8 GB

Standard

Empfohlen

Produktion mit Datenbanken, eigener Domain und Team.

  • Bis zu 4 vCPU
  • Datenbanken
  • Eigene Domain
  • Load Balancer
  • AI Gateway
  • Workspaces

Ab44,99 R$/Monat

12 GB → 24 GB

Pro

Mehr Speicher, tägliche Snapshots und Einblick in das, was läuft.

  • Bis zu 12 vCPU
  • Tägliche Snapshots der Anwendungen
  • Performance-Analyse
  • Priorisierter Support

Ab124,99 R$/Monat

32 GB → 1 TB

Enterprise

Große Betriebe, mit privatem Discord-Kanal.

  • Bis zu 16 vCPU
  • Privater Discord-Kanal

Ab299,90 R$/Monat

HobbyStandardProEnterprise
Rechenleistung
RAM1 GB → 2 GB4 GB → 8 GB12 GB → 24 GB32 GB → 1 TB
vCPU1 → 246 → 1216
Plattform
Echtzeit-MetrikenEnthaltenEnthaltenEnthaltenEnthalten
Blob StorageEnthaltenEnthaltenEnthaltenEnthalten
Rollback mit 1 KlickEnthaltenEnthaltenEnthaltenEnthalten
Square Shield gegen DDoSEnthaltenEnthaltenEnthaltenEnthalten
DatenbankenNicht enthaltenEnthaltenEnthaltenEnthalten
Eigene DomainNicht enthaltenEnthaltenEnthaltenEnthalten
Load BalancerApps pro DomainNicht enthalten2510
AI GatewayNicht enthaltenEnthaltenEnthaltenEnthalten
Tägliche Snapshots der AnwendungenNicht enthaltenNicht enthaltenEnthaltenEnthalten
Performance-AnalyseNicht enthaltenNicht enthaltenEnthaltenEnthalten
Team und Support
WorkspacesMitglieder pro WorkspaceNicht enthalten3 → 710 → 2020 → 50
Priorisierter SupportNicht enthaltenNicht enthaltenEnthaltenEnthalten
Privater Discord-KanalNicht enthaltenNicht enthaltenNicht enthaltenEnthalten

4,9 von 5

482 Bewertungen auf Google und Trustpilot

Gehostet in einem Partner-Rechenzentrum mit den Zertifizierungen

  • Tier 3
  • ISO 27001
  • SOC 2 Type II
  • Always-On-DDoS-Schutz
Entdecken Sie unsere Infrastruktur

Bereit, Ihr Projekt zu skalieren?

Schließen Sie sich den mehr als 500.000 Entwicklern an, die Square Cloud für das Hosting ihrer Projekte genutzt haben.

  • Vorhersehbare Preise
  • Keine Überraschungen bei der Abrechnung
  • Deploy in Sekunden
  • Hohe Verfügbarkeit
  • Stabil skalieren
  • Automatischer Neustart
  • SSL und Sicherheit inklusive
  • Isolierte Container