Bereitstellung einer C#-Anwendung auf einem VPS: Schritt-für-Schritt-Anleitung von A bis Z

Einleitung: Warum ein VPS der ideale Ort für Ihre C#-Anwendung ist

Die Entwicklung mit C# im .NET-Ökosystem bietet leistungsstarke Werkzeuge zur Erstellung von Webanwendungen, APIs und Microservices. Das Schreiben des Codes ist jedoch nur die halbe Miete. Damit Ihre Anwendung für Benutzer verfügbar wird, muss sie auf einem Server bereitgestellt werden. Ein virtueller privater Server (VPS) bietet die vollständige Kontrolle über die Umgebung, was für eine Produktionsumgebung entscheidend ist. In dieser Anleitung gehen wir den Weg von Null bis zu einer voll funktionsfähigen C#-Anwendung auf einem VPS mit Ubuntu. Sie erfahren, wie Sie die .NET Runtime installieren, den Reverse-Proxy-Server Nginx konfigurieren, die Anwendung als systemd-Dienst starten und ihren automatischen Neustart sicherstellen.

Servervorbereitung und Installation der erforderlichen Software

1. Verbindung zum VPS und grundlegende Einstellungen

Nachdem Sie Zugriff auf den VPS erhalten haben (IP-Adresse, Benutzername und Passwort oder SSH-Schlüssel), verbinden Sie sich über das Terminal:

ssh root@Ihre_Server_IP

Aktualisieren Sie die Paketdatenbank und installieren Sie curl (wird zum Herunterladen von .NET benötigt):

apt update && apt upgrade -y\napt install curl -y

2. Installation des .NET SDK/Runtime

Microsoft empfiehlt die Installation von .NET über das offizielle Repository. Fügen wir es hinzu und installieren das SDK (zum Erstellen) oder die Runtime (nur zum Ausführen). Für einen Produktionsserver reicht in der Regel die Runtime, aber zur Vereinfachung der Bereitstellung installieren wir das SDK:

wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb\ndpkg -i packages-microsoft-prod.deb\napt update\napt install -y dotnet-sdk-8.0

Überprüfen Sie die Installation:

dotnet --version

3. Installation von Nginx und Git

Nginx fungiert als Reverse-Proxy und leitet Anfragen von Port 80 an Ihre Anwendung weiter. Git wird zum Klonen des Repositorys benötigt:

apt install -y nginx git\nsystemctl enable nginx\nsystemctl start nginx

Vorbereitung und Veröffentlichung der C#-Anwendung

1. Projekt erstellen oder klonen

Als Beispiel erstellen wir eine einfache ASP.NET Core Web API-Anwendung direkt auf dem Server (in einem realen Projekt würden Sie ein Repository klonen):

mkdir /var/www/myapp\ncd /var/www/myapp\ndotnet new webapi --name MyApp\ncd MyApp

2. Anwendung veröffentlichen (self-contained)

Damit die Anwendung ohne installiertes SDK auf dem Server läuft, veröffentlichen wir sie im self-contained-Modus:

dotnet publish -c Release -r linux-x64 --self-contained true -o /var/www/myapp/publish

Das Flag --self-contained true bindet alle .NET-Abhängigkeiten in den publish-Ordner ein. Die Alternative ist --self-contained false (erfordert eine installierte Runtime).

3. Testlauf

Überprüfen Sie, ob die Anwendung startet (standardmäßig auf Port 5000):

cd /var/www/myapp/publish\n./MyApp --urls "http://0.0.0.0:5000"

Öffnen Sie im Browser http://Ihre_IP:5000 – Sie sollten eine API-Antwort sehen. Stoppen Sie den Prozess (Strg+C).

Konfiguration von Nginx als Reverse-Proxy

1. Site-Konfiguration

Erstellen wir eine Konfigurationsdatei für Nginx:

nano /etc/nginx/sites-available/myapp

Fügen Sie den folgenden Code ein (ersetzen Sie your_domain_or_ip durch Ihre Domain oder IP):

server {\n    listen 80;\n    server_name your_domain_or_ip;\n\n    location / {\n        proxy_pass http://localhost:5000;\n        proxy_http_version 1.1;\n        proxy_set_header Upgrade $http_upgrade;\n        proxy_set_header Connection keep-alive;\n        proxy_set_header Host $host;\n        proxy_cache_bypass $http_upgrade;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n    }\n}

2. Konfiguration aktivieren

ln -s /etc/nginx/sites-available/myapp /etc/nginx