Node.js unter Ubuntu installieren: Eine vollständige Anleitung mit APT, NodeSource und nvm

.## 1. Einführung: Warum Node.js auf Ubuntu verwenden?

目次

Hervorragende Kompatibilität zwischen Ubuntu und Node.js

Node.js ist eine Plattform zum Ausführen von JavaScript auf der Serverseite und wird häufig für Webanwendungen und die Entwicklung von Tools verwendet. Ubuntu hingegen ist eine Linux-Distribution, der viele Entwickler und Serveradministratoren vertrauen. Durch die Kombination beider können Sie eine Entwicklungsumgebung schaffen, die in Stabilität, Flexibilität und Geschwindigkeit herausragt.

Die Installation von Node.js auf Ubuntu bietet folgende Vorteile:

  • Ein leichtgewichtiges Betriebssystem mit minimalem Overhead, das eine effiziente Nutzung der Systemressourcen ermöglicht
  • Eine einheitliche Linux-basierte Umgebung von der Entwicklung über das Testen bis hin zur Produktion
  • Hohe Kompatibilität mit Node.js und nahtlose Integration von Tools wie npm und nvm

Aus diesen Gründen ist die Kombination aus Ubuntu und Node.js als Entwicklungsumgebung für Front‑ und Backend‑Arbeiten äußerst attraktiv.

Zielgruppe und Zweck dieses Artikels

Dieser Artikel richtet sich an die folgenden Leser:

  • Diejenigen, die Node.js zum ersten Mal auf Ubuntu verwenden möchten
  • Diejenigen, die wissen möchten, welche Installationsmethode die beste ist
  • Diejenigen, die die neueste Node.js‑Version nutzen wollen, sich aber bei der Konfiguration unsicher sind

Durch das Lesen dieses Artikels können Sie drei verschiedene Node.js‑Installationsmethoden auf Ubuntu vergleichen und den am besten geeigneten Ansatz basierend auf Ihren Zielen und Ihrem Kenntnisstand auswählen. Darüber hinaus behandelt diese Anleitung verwandte Werkzeuge wie npm und yarn sowie Lösungen für häufige Fehler, sodass Sie eine Node.js‑Umgebung sicher nutzen können.

2. Überblick über Node.js‑Installationsmethoden auf Ubuntu

Drei Installationsmethoden, jede mit eigenen Merkmalen

Es gibt drei Hauptmöglichkeiten, Node.js auf Ubuntu zu installieren:

  1. Installation des Standardpakets über APT (Advanced Package Tool)
  2. Installation über das NodeSource‑PPA (Personal Package Archive)
  3. Verwendung von nvm (Node Version Manager) für flexibles Versionsmanagement

Jede Methode hat ihre eigenen Vor‑ und Nachteile, und die beste Wahl hängt von Ihrem Anwendungsfall und Ihrer Systemkonfiguration ab. Die folgende Tabelle fasst ihre Eigenschaften zusammen.

Vergleichstabelle der Node.js‑Installationsmethoden

Installation MethodMain FeaturesAdvantagesDisadvantagesRecommended For
APT (Default)Uses Ubuntu’s official repositorySimple and safeVersion may be outdatedBeginners who want to try quickly
NodeSource PPAManages newer Node.js versions via APTRelatively up-to-date versionsRequires adding a PPADevelopers who want a stable recent version
nvmSupports switching between multiple versionsHighly flexible and ideal for developmentRequires shell configurationRecommended for learning and development

Warum ist ein Vergleich wichtig?

Ubuntu legt großen Wert auf Stabilität, was bedeutet, dass die Software‑Versionen im APT‑Repository eher konservativ sind. Daher sollten Benutzer, die die neuesten Node.js‑Funktionen benötigen oder mehrere Versionen testen müssen, Optionen jenseits von APT in Betracht ziehen.

Andererseits, wenn Ihr Ziel lediglich ist, Node.js schnell auszuprobieren oder zusätzliche Konfigurationen auf einem Produktionsserver zu vermeiden, kann die APT‑Methode ausreichend sein.

Welche sollten Sie wählen?

Zusammenfassend ist die Installation über nvm für Entwickler oder alle, die Node.js langfristig nutzen möchten, der am meisten empfohlene Ansatz.
Die Gründe sind:

  • Einfaches Umschalten zwischen der neuesten und älteren Versionen
  • npm wird automatisch installiert
  • Weniger Berechtigungsprobleme (kein sudo erforderlich)

3. Methode ①: Node.js einfach mit APT installieren (offiziell von Ubuntu)

Was ist APT? Das standardmäßige Paketverwaltungssystem auf Ubuntu

APT (Advanced Package Tool) ist das standardmäßige Paketverwaltungssystem, das von Ubuntu und anderen Debian‑basierten Linux‑Distributionen verwendet wird. Mit APT können Sie Software mit einem einzigen Befehl einfach installieren, aktualisieren und entfernen.

Das offizielle Ubuntu‑Repository enthält Node.js‑Pakete, was bedeutet, dass Sie Node.js sofort ohne besondere Vorbereitung installieren können.

Installationsschritte

  1. Aktualisieren Sie die APT‑Paketliste.
    sudo apt update
    
  1. Installieren Sie Node.js und npm.
    sudo apt install nodejs npm
    
  1. Überprüfen Sie die Installation.
    node -v
    npm -v
    

Wenn Versionsinformationen angezeigt werden, war die Installation erfolgreich.

Vorteile: Einfach und sicher

  • Sehr zuverlässig, da es das offizielle Ubuntu‑Repository nutzt
  • Einfache Befehle, die für Anfänger leicht zu handhaben sind
  • In System‑Updates über APT integriert

.

Nachteile: Version kann veraltet sein

Da APT Stabilität priorisiert, kann die verfügbare Node.js‑Version mehrere Generationen hinterherliegen.

Zum Beispiel kann auf Ubuntu 22.04 die über APT installierte Node.js‑Version 12 oder 14 sein, was bedeutet, dass die neuesten Funktionen und Sicherheitsverbesserungen möglicherweise nicht enthalten sind.

Diese Methode ist zudem nicht geeignet, wenn Sie mehrere Node.js‑Versionen in verschiedenen Projekten benötigen.

Für wen diese Methode am besten geeignet ist

  • Anfänger, die Node.js sofort ausprobieren möchten
  • Produktionsumgebungen, in denen eine stabile Version ausreicht
  • Nutzer, die nicht mehrere Node.js‑Versionen benötigen

4. Methode ②: Installation der neuesten Version über NodeSource‑PPA

Was ist NodeSource?

NodeSource ist ein vertrauenswürdiger Anbieter, der stabile und aktuelle Node.js‑Versionen schnell bereitstellt, unabhängig vom offiziellen Node.js‑Team. Besonders nützlich für Ubuntu‑ und Debian‑Nutzer, die neuere Node.js‑Versionen installieren möchten, während sie weiterhin APT verwenden.

Diese Methode wird auf der offiziellen Node.js‑Website empfohlen und ist in Unternehmensumgebungen weit verbreitet.

Installationsschritte (Beispiel: Node.js 18.x)

  1. Paketliste aktualisieren.
    sudo apt update
    
  1. curl installieren, falls es noch nicht vorhanden ist.
    sudo apt install curl
    
  1. Das NodeSource‑Setup‑Skript ausführen.
    curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
    
  1. Node.js installieren.
    sudo apt install -y nodejs
    
  1. Die Installation überprüfen.
    node -v
    npm -v
    

Vorteile: Neueste Version mit APT nutzen

  • Einfache Installation der neuesten stabilen Node.js‑Version
  • Vertrautes, APT‑basiertes Management
  • npm wird automatisch installiert

Nachteile: Hinzufügen eines PPA erforderlich

  • Etwas mehr Schritte im Vergleich zur Standard‑APT‑Installation
  • Es muss die Vertrauenswürdigkeit der Quelle bewertet werden (NodeSource ist in der Regel sicher)

Für wen diese Methode am besten geeignet ist

  • Entwickler, die eine stabile und aktuelle Node.js‑Version benötigen
  • Nutzer, die das Ubuntu‑Repository als unzureichend empfinden, aber nvm nicht verwenden wollen
  • Alle, die das zentrale, APT‑basierte Paketmanagement beibehalten möchten

5. Methode ③: Flexible Versionsverwaltung mit nvm (Empfohlen)

Was ist nvm? Ein leistungsstarkes Werkzeug zur Verwaltung von Node.js‑Versionen

nvm (Node Version Manager) ist ein Befehlszeilen‑Tool, das das Verwalten und Wechseln zwischen mehreren Node.js‑Versionen ermöglicht. Es ist besonders nützlich für Entwickler, die pro Projekt unterschiedliche Versionen benötigen oder sowohl die neuesten als auch LTS‑Releases testen wollen.

Mit nvm können Sie eine flexible Entwicklungsumgebung vollständig in Ihrem Benutzerkonto aufbauen, ohne Node.js systemweit zu installieren.

Installation von nvm

  1. Das Installationsskript mit curl ausführen.
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
    
  1. Ihre Shell‑Konfigurationsdatei neu laden.
    source ~/.bashrc
    

Oder, wenn Sie Zsh verwenden:

source ~/.zshrc
  1. Prüfen, ob nvm installiert ist.
    command -v nvm
    

Wenn nvm angezeigt wird, war die Installation erfolgreich.

Node.js mit nvm installieren

  1. Die LTS‑Version installieren:
    nvm install --lts
    
  1. Eine bestimmte Version installieren:
    nvm install 18
    
  1. Die aktive Version wechseln:
    nvm use 18
    
  1. Die Standard‑Version festlegen:
    nvm alias default 18
    
  1. Versionen prüfen:
    node -v
    npm -v
    

Vorteile: Maximale Flexibilität und Kontrolle

  • Mehrere Versionen können gleichzeitig existieren und sofort gewechselt werden
  • npm wird automatisch installiert
  • Kein sudo nötig, wodurch Berechtigungsprobleme reduziert werden
  • Das Systemumfeld bleibt unverändert – ideal für die Entwicklung

Nachteile: Erster Setup erfordert Aufmerksamkeit

  • nvm funktioniert nicht, wenn Shell‑Konfigurationsdateien nicht korrekt geladen werden
  • Installation pro Benutzer, nicht systemweit

Für wen diese Methode am besten geeignet ist

.* Entwickler, die zwischen Node.js-Versionen wechseln müssen * Nutzer, die mehrere Projekte mit unterschiedlichen Anforderungen verwalten * Anfänger, die Berechtigungsprobleme vermeiden möchten

6. Verwendung von npm und yarn

Was ist npm?

npm (Node Package Manager) ist ein unverzichtbares Werkzeug zur Verwaltung von Node.js-Paketen. Es ermöglicht das einfache Installieren und Verwalten von Bibliotheken und Tools, die von Entwicklern weltweit veröffentlicht werden.

Wenn Node.js über APT, NodeSource oder nvm installiert wird, wird npm in der Regel automatisch mitinstalliert.

Version prüfen:
npm -v

Grundlegende npm-Befehle

ActionCommand Example
Install a packagenpm install <package-name>
Install globallynpm install -g <package-name>
Uninstall a packagenpm uninstall <package-name>
Initialize a projectnpm init or npm init -y
List packagesnpm list or npm list -g

Was ist yarn?

yarn ist eine von Facebook entwickelte Alternative zu npm, die für schnellere und zuverlässigere Paketverwaltung konzipiert ist. Seine Befehle sind weitgehend mit npm kompatibel.

Installation von yarn (via npm)

npm install -g yarn

Installation überprüfen:

yarn -v

Grundlegende yarn-Befehle

ActionCommand Example
Install a packageyarn add <package-name>
Global installyarn global add <package-name>
Uninstall a packageyarn remove <package-name>
Initialize a projectyarn init
List packagesyarn list or yarn global list

npm vs yarn: Welche sollte man verwenden?

Comparisonnpmyarn
StandardIncluded with Node.jsRequires installation
SpeedStandardFaster with caching
Lock filepackage-lock.jsonyarn.lock
CompatibilityMostly compatible

Modernes npm (v7 und später) hat sich deutlich verbessert, sodass beide Optionen im Allgemeinen in Ordnung sind. Es ist am besten, dem zu folgen, was Ihr Projekt oder Team bereits verwendet.

7. Häufige Fehler und Fehlersuche

Häufige Probleme und Lösungen

node: command not found

Ursache:
Node.js ist nicht korrekt installiert, oder der PATH ist nicht gesetzt. Dies tritt häufig nach der Installation von nvm auf, ohne die Shell-Konfiguration neu zu laden.

Lösung:

  • Laden Sie die Shell-Konfigurationsdatei neu:
    source ~/.bashrc
    
  • Wenn das Problem weiterhin besteht, melden Sie sich ab und wieder an oder starten Sie den Rechner neu

E: Unable to locate package nodejs

Ursache:
Die APT-Paketliste ist veraltet oder das korrekte PPA wurde nicht hinzugefügt.

Lösung:

  • Aktualisieren Sie die APT-Liste:
    sudo apt update
    
  • Wenn Sie NodeSource verwenden, führen Sie das Setup-Skript erneut aus

npm ERR! permission denied

Ursache:
Unzureichende Berechtigungen beim Installieren globaler npm-Pakete.

Lösung:

  • Verwenden Sie sudo (nicht immer empfohlen):
    sudo npm install -g <package-name>
    
  • Die Verwendung von nvm ist die beste Praxis, um Berechtigungsprobleme zu vermeiden

nvm: command not found

Ursache:
nvm ist installiert, aber die Shell-Konfiguration wurde nicht geladen.

Lösung:

  • Stellen Sie sicher, dass nvm in Ihrer Shell-Konfigurationsdatei eingebunden ist
  • Laden Sie es manuell:
    export NVM_DIR="$HOME/.nvm"
    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
    

Best Practices zur Vermeidung von Problemen

  • Überprüfen Sie stets die PATH-Einstellungen
  • Die Verwendung von nvm hilft, die meisten umgebungsbezogenen Probleme zu vermeiden
  • Achten Sie auf die Kompatibilität zwischen Ubuntu- und Node.js-Versionen

8. Häufig gestellte Fragen (FAQ)

Q1. Wie kann ich meine Node.js-Version prüfen?

A. Führen Sie den folgenden Befehl im Terminal aus:

node -v

Um auch npm zu prüfen:

npm -v

Q2. Wie kann ich mehrere Node.js-Versionen unter Ubuntu verwenden?

A. Die Verwendung von nvm ist der einfachste und sicherste Ansatz. Nach der Installation können Sie die Versionen wie folgt wechseln:

nvm install 16
nvm use 16

Q3. Node.js, das über nvm installiert wurde, ist nicht aktiv. Warum?

A. In den meisten Fällen wurde die Shell-Konfigurationsdatei nicht geladen. Führen Sie aus:

source ~/.bashrc

Oder, für Zsh:

source ~/.zshrc

Q4. Was ist der Unterschied zwischen npm und yarn?

A. Ihre Kernfunktionalität ist ähnlich, aber yarn bietet schnellere Installationen durch Caching und explizite Abhängigkeitsbindung über yarn.lock. Modernes npm hat sich deutlich verbessert, sodass beide Optionen gut funktionieren.

Q5. Wie unterscheiden sich Node.js, Deno und Bun?

A. Deno und Bun sind alternative Laufzeitumgebungen, die entwickelt wurden, um die Einschränkungen von Node.js zu adressieren.

  • Deno : Native TypeScript-Unterstützung, verbesserte Sicherheit, integrierte Standardbibliothek
  • Bun : Schnellere Ausführung und integrierte Paketverwaltung

Allerdings bleibt Node.js die praktischste Wahl aufgrund seines umfangreichen npm-Ökosystems.

9. Fazit: Wählen Sie die passende Installationsmethode für Ihre Bedürfnisse

Es gibt mehrere Möglichkeiten, Node.js auf Ubuntu zu installieren, jede mit klaren Stärken und Anwendungsfällen. Dieser Artikel hat drei repräsentative Methoden vorgestellt und erklärt, wie man die geeignetste auswählt.

APT (Ubuntu Offiziell)

  • Vorteile: Am einfachsten und sichersten
  • Nachteile: Version könnte veraltet sein
  • Empfohlen für: Anfänger, die einen schnellen Einstieg wollen

NodeSource PPA

  • Vorteile: Neuere Versionen installieren, während APT verwendet wird
  • Nachteile: Erfordert das Hinzufügen eines PPA
  • Empfohlen für: Entwickler, die eine stabile, aktuelle Version wollen

nvm (Node Version Manager)

  • Vorteile: Flexible Versionswechsel und saubere Umgebung
  • Nachteile: Etwas komplexere Einrichtung
  • Empfohlen für: Entwickler, die mehrere Projekte handhaben

Dieser Leitfaden hat auch npm, yarn und gängige Tipps zur Fehlerbehebung behandelt. Obwohl die Installation von Node.js zunächst komplex erscheinen mag, macht die Wahl der richtigen Methode es einfach, eine stabile Entwicklungsumgebung auf Ubuntu aufzubauen.

Wenn Sie Ihre Projekte weiter ausbauen möchten, hilft die Verwendung von nvm als Grundlage, in die Team-Entwicklung und CI/CD-Workflows zu skalieren.

侍エンジニア塾