Wie man Umgebungsvariablen in Node.js verwendet

Dieser Artikel wurde im Juli 2025 aktualisiert.

Einführung

Umgebungsvariablen spielen eine entscheidende Rolle bei der Konfiguration und Sicherung von Node.js-Applikationen. Sie ermöglichen es Entwicklern, sensible Informationen, Konfigurationseinstellungen und andere Variablen außerhalb der Codebasis zu speichern, was die Verwaltung verschiedener Einsatzumgebungen (Entwicklung, Test, Produktion) erleichtert, ohne sensible Informationen preiszugeben.

In diesem Blogbeitrag werden wir uns mit der Verwendung von Umgebungsvariablen in Node.js befassen und Themen wie das Setzen, den Zugriff und die Verwaltung von Umgebungsvariablen in Ihren Applikationen behandeln.

Verstehen von Umgebungsvariablen

Umgebungsvariablen sind dynamische Werte, die das Verhalten eines laufenden Prozesses beeinflussen können. In Node.js können Sie auf Umgebungsvariablen zugreifen, indem Sie das process.env Objekt zugreifen. Diese Variablen werden außerhalb Ihrer Anwendung gesetzt und von Ihrer Anwendung während der Laufzeit gelesen.

Einstellen von Umgebungsvariablen

Um Umgebungsvariablen zu setzen, können Sie je nach Betriebssystem oder Bereitstellungsplattform verschiedene Methoden verwenden.

Windows (Eingabeaufforderung) - set VAR_NAME=value

Linux und macOS (Bash-Shell) - export VAR_NAME=value

Mit einer.env Datei

In vielen Node.js-Projekten verwenden die Entwickler eine .env Datei, um Umgebungsvariablen zu speichern und zu verwalten.

Erstellen Sie eine Datei namens .env im Stammverzeichnis Ihres Projekts und definieren Sie Ihre Variablen:

DB_HOST=localhost
DB_PORT=5432
SECRET_KEY=mysecretkey

Diese Datei sollte nicht an das Versionskontrollsystem übergeben werden, um sicherzustellen, dass sensible Informationen immer auf Ihrem lokalen Computer verbleiben.

hinzufügen .env zu Ihrer .gitignore Datei hinzu, um zu verhindern, dass sie übertragen wird. Hier ist eine Beispieldatei in der es bereits hinzugefügt wurde. Sie können auch dotenv für die fortgeschrittene Konfiguration verwenden und es lädt automatisch Umgebungsvariablen aus einer .env Datei in process.env. Anmerkung: Sie können die dotenv Paket verwenden, um die Datei in Ihren Code zu importieren)

Zugriff auf Umgebungsvariablen in Node.js

Sobald Sie Ihre Umgebungsvariablen gesetzt haben, können Sie in Ihrer Node.js-Anwendung auf sie zugreifen, indem Sie process.env.

const dbHost = process.env.DB_HOST;
const dbPort = process.env.DB_PORT;
const secretKey = process.env.SECRET_KEY;

console.log(`Database Host: ${dbHost}`);
console.log(`Database Port: ${dbPort}`);
console.log(`Secret Key: ${secretKey}`);

Verwendung eines Moduls für Umgebungsvariablen

Zur besseren Organisation sollten Sie ein Modul erstellen, das den Zugriff auf die Umgebungsvariablen zentralisiert. Erstellen Sie eine Datei mit dem Namen config.js:

module.exports = {
  dbHost: process.env.DB_HOST,
  dbPort: process.env.DB_PORT,
  secretKey: process.env.SECRET_KEY,
};

Nun können Sie diese Variablen problemlos importieren und in anderen Teilen Ihrer Anwendung verwenden:

const config = require('./config');

console.log(`Database Host: ${config.dbHost}`);
console.log(`Database Port: ${config.dbPort}`);
console.log(`Secret Key: ${config.secretKey}`);

Handhabung von Standardwerten

Manchmal können Sie Standardwerte für Umgebungsvariablen angeben, wenn diese nicht gesetzt sind. Dies können Sie mit dem || Operator erreichen:

const dbHost = process.env.DB_HOST || 'localhost';
const dbPort = process.env.DB_PORT || 5432;
const secretKey = process.env.SECRET_KEY || 'defaultsecret';

Nachbereitung

Der effektive Einsatz von Umgebungsvariablen in Ihren Node.js-Applikationen ist entscheidend für die Aufrechterhaltung von Sicherheit und Konfigurierbarkeit. Wenn Sie sensible Informationen außerhalb Ihrer Codebasis halten und einen standardisierten Ansatz verwenden, können Sie verschiedene Bereitstellungsumgebungen einfach verwalten und eine sicherere Anwendung gewährleisten.

Denken Sie daran, mit sensiblen Informationen vorsichtig umzugehen und bewährte Verfahren zur Sicherung Ihrer Umgebungsvariablen zu befolgen, insbesondere in Produktionsumgebungen.

Wenn Sie Fragen haben, schließen Sie sich uns auf dem Vonage Entwickler-Slack oder senden Sie uns einen Post auf Xund wir werden auf Sie zurückkommen. Nochmals vielen Dank für die Lektüre, und wir sehen uns beim nächsten Mal wieder!