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.
1. Futtatókörnyezet#
# 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.0Debianon 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#
# 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/worksmarthubAz 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:
[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.targetsudo systemctl daemon-reload
sudo systemctl enable --now worksmarthub-app
journalctl -t WorkSmartHub -fA 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#
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#
- Ha a kiadás igényli, előbb telepítse az újabb .NET futtatókörnyezetet.
- Készítsen mentést, majd:
sudo systemctl stop worksmarthub-app. - Tegye félre az
appsettings.jsonfájlt, másolja be az új fájlokat, tegye vissza, és futtassa:chown -R worksmarthub:worksmarthub /opt/worksmarthub. - 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.