Telepítés Linuxra (systemd és nginx)

Telepítés Linuxra (systemd és nginx)

Ezen az oldalon

Az alkalmazás systemd szolgáltatásként fut egy külön felhasználó nevében, előtte nginx fordított proxyval. A parancsok Ubuntura és Debianra vonatkoznak; a Red Hat család (RHEL, CentOS Stream, Rocky, Alma, Oracle Linux) eltéréseit jelezzük. Linuxon Active Directory-s bejelentkezés nem érhető el; használja a helyi, LDAP, Entra ID vagy OAuth bejelentkezést.

Az nginx-en végződik a TLS, és a localhost:5000 címre továbbít, ahol az alkalmazás systemd szolgáltatásként fut.

1. Futtatókörnyezet#

bash
# Ubuntu 24.04 és újabb
sudo apt-get update && sudo apt-get install -y aspnetcore-runtime-10.0

# Ubuntu 22.04: a Canonical backports PPA-ja
sudo add-apt-repository -y ppa:dotnet/backports
sudo apt-get update && sudo apt-get install -y aspnetcore-runtime-10.0

# Red Hat család
sudo dnf install -y aspnetcore-runtime-10.0

Debianon előbb regisztrálja a Microsoft csomagtárolóját. Csak egy csomagforrást használjon, és ellenőrizze a dotnet --list-runtimes paranccsal (Microsoft.AspNetCore.App 10.0.x). Ha az adatbázis, az SMTP-szerver, a Vault vagy az identitásszolgáltató belső hitelesítésszolgáltatótól (CA) kapott tanúsítványt használ, vegye fel a CA-t a rendszer megbízható tanúsítványai közé.

2. Az alkalmazás fájljai és felhasználója#

bash
# másolja a kiadás (publish) mappáját a /opt/worksmarthub mappába, majd:
sudo useradd --system --shell /sbin/nologin worksmarthub
sudo chown -R worksmarthub:worksmarthub /opt/worksmarthub

Az alkalmazás ebbe a mappába ír: Logs/, az SQLite adatbázis, FileStorage/, az élő sablonok és az appsettings.json.

3. systemd szolgáltatás#

/etc/systemd/system/worksmarthub-app.service:

ini
[Unit]
Description=WorkSmartHub
After=network.target

[Service]
Type=simple
Restart=always
RestartSec=3
User=worksmarthub
WorkingDirectory=/opt/worksmarthub
ExecStart=/usr/bin/dotnet /opt/worksmarthub/WorkSmartHub.dll
TimeoutStopSec=75
SyslogIdentifier=WorkSmartHub

[Install]
WantedBy=multi-user.target
bash
sudo systemctl daemon-reload
sudo systemctl enable --now worksmarthub-app
journalctl -t WorkSmartHub -f

A WorkingDirectory fontos, mert a relatív elérési utak ehhez képest értendők. A TimeoutStopSec=75 időt ad az alkalmazásnak a rendezett leálláshoz.

4. Beállítás#

Szerkessze az /opt/worksmarthub/appsettings.json fájlt (Konfiguráció), majd indítsa újra a szolgáltatást. nginx mögött hagyja a HttpSettings.Urls értékét http://localhost:5000-en; csak akkor írja át http://+:5000-re, ha az alkalmazást közvetlenül teszi elérhetővé. Portonként egy bejegyzést használjon.

5. nginx#

nginx
server {
    listen 443 ssl http2;
    server_name wsh.example.com;
    ssl_certificate     /opt/ssl/certificate.crt;
    ssl_certificate_key /opt/ssl/certificate.key;

    location / {
        proxy_pass http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

A http blokkban állítsa be a client_max_body_size 50m; értéket (a feltöltések 25 MB-os darabokban érkeznek, az nginx alapértelmezett 1 MB-os korlátja ezeket elutasítja), és 600 másodperces időkorlátokat. Az nginx mindig írja felül a továbbított fejléceket, soha ne adja tovább a klienstől érkező értékeket. Red Hat családon SELinux mellett futtassa a sudo setsebool -P httpd_can_network_connect 1 parancsot; firewalld esetén nyissa meg a http és https szolgáltatást.

Állítsa a PublicBaseUrl értékét a nyilvános címre.

Frissítés#

  1. Ha a kiadás igényli, előbb telepítse az újabb .NET futtatókörnyezetet.
  2. Készítsen mentést, majd: sudo systemctl stop worksmarthub-app.
  3. Tegye félre az appsettings.json fájlt, másolja be az új fájlokat, tegye vissza, és futtassa: chown -R worksmarthub:worksmarthub /opt/worksmarthub.
  4. Indítsa el a szolgáltatást; az adatbázist az alkalmazás induláskor migrálja.

Alternatívák: ugyanez az egység futhat systemd felhasználói szolgáltatásként is (a loginctl enable-linger paranccsal engedélyezze a lingeringet), vagy futtathatja az alkalmazást Dockerben.

Nem találta, amit keresett?

Írjon nekünk, vagy foglaljon időpontot. Válaszolunk a funkciókkal, a telepítéssel és a licenceléssel kapcsolatos kérdésekre.

Kapcsolat