Installation als Webserver für Linux - Quick Start

Laden Sie das CODESYS 4 Debian-Paket aus dem CODESYS Store.

Installieren Sie das CODESYS 4 Debian-Paket.

sudo apt install ./codesys-4_[your version]_[your architecture].deb

Legen Sie die Gruppe codesys-4 und den User c4-server an, die für den Start des Servers und die Anmeldung an der Applikation notwendig sind.

Im nachfolgenden Beispiel wird zusätzlich ein Testnutzer hugo angelegt und zur Gruppe codesys-4 hinzugefügt. Dieser User kann sich somit in der Applikation anmelden. Das ist optional - Sie können zum Testen stattdessen auch einen bestehenden Nutzer in die Gruppe codesys-4 aufnehmen.

Erstellen Sie eine Datei codesys-4.service unter /etc/systemd/system/. Ersetzen Sie dabei nano mit Ihrem bevorzugten Editor.

sudo nano /etc/systemd/system/codesys-4.service

Editieren Sie die Datei folgendermaßen:

[Unit]
Description=CODESYS 4 Server
 
[Service]
Type=exec
WorkingDirectory=/opt/codesys-4/
ExecStart=/opt/codesys-4/c4-server --port 8080
Restart=always
# Restart service after 10 seconds if the dotnet service crashes:
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=codesys-4-server
User=c4-server
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false
 
[Install]
WantedBy=multi-user.target

Starten Sie die soeben angelegte Systemd-Unit:

sudo systemctl start codesys-4

Setzen Sie die Unit zusätzlich auf enabled, um den Server beim Systemstart automatisch zu starten:

sudo systemctl enable codesys-4

Installieren Sie das nginx-Paket, wenn noch nicht geschehen:

sudo apt update && sudo apt install -y nginx

Um HTTPS-Kommunikation zu ermöglichen, müssen Sie temporär ein selbstsigniertes Zertifikat und einen Schlüssel erstellen.

Erstellen Sie zu Testzwecken einen privaten Schlüssel und ein Zertifikat für den Reverse-Proxy:

Legen Sie die Konfiguration für den Reverse-Proxy an. Ersetzen Sie dabei nano mit Ihrem bevorzugten Editor.

sudo nano /etc/nginx/sites-available/codesys-4

Erstellen Sie nachfolgende Konfiguration:

# See https://docs.microsoft.com/en-us/troubleshoot/developer/webapps/aspnetcore/practice-troubleshoot-linux/2-2-install-nginx-configure-it-reverse-proxy
# for more information.

server {
 listen	443 ssl;
 listen	[::]:443 ssl;
 ssl_certificate /etc/ssl/certs/codesys-4-certificate.crt;
 ssl_certificate_key /etc/ssl/private/codesys-4.key;

 #server_name _;
 server_tokens off; # see https://nginx.org/en/docs/http/ngx_http_core_module.html#server_tokens

 location / {
 rewrite ^/$ /index.html last;
 proxy_pass http://127.0.0.1:8080;
 proxy_http_version 1.1;
 proxy_set_header Upgrade $http_upgrade;
 proxy_set_header Connection keep-alive;
 proxy_set_header Connection "Upgrade";
 proxy_set_header Host $host;
 proxy_cache_bypass $http_upgrade;
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 proxy_set_header X-Forwarded-Proto $scheme;

 #hsts header
 add_header Strict-Transport-Security "max-age=31536000" always;
 }
}

# Redirect unencrypted http access to encrypted https access.
server {
 listen 80 default_server;
 listen [::]:80 default_server ipv6only=on;

 server_name _;

 return 301 https://$host$request_uri;
}

Aktivieren Sie die Konfiguration via symlink:

1. Deaktivieren Sie die Standard-Konfiguration von nginx.

   sudo rm /etc/nginx/sites-enabled/default

2. Aktivieren Sie die von Ihnen angelegte Konfiguration.

   sudo ln -s /etc/nginx/sites-available/codesys-4 /etc/nginx/sites-enabled/codesys-4

Starten Sie nun nginx neu, um die geänderte Konfiguration zu übernehmen:

sudo systemctl restart nginx

Setzen Sie die nginx Unit zusätzlich auf enabled, um auch den Reverse-Proxy beim Systemstart automatisch zu starten:

sudo systemctl enable nginx

Wenn Ihnen Ihre IP-Adresse nicht bekannt ist, führen Sie das Kommando ip aus. Voraussetzung dafür ist, dass Ihr Firmennetz und Ihre Firewall den Zugriff erlauben.

ip addr

#1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
#    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
#    inet 127.0.0.1/8 scope host lo
#       valid_lft forever preferred_lft forever
#    inet6 ::1/128 scope host noprefixroute
#       valid_lft forever preferred_lft forever
#2: end0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
#    link/ether 01:23:45:67:89:ab brd ff:ff:ff:ff:ff:ff
#    inet 192.168.0.123/24 brd 192.168.0.255 scope global dynamic noprefixroute end0
#       valid_lft 350450sec preferred_lft 350450sec
#    inet6 fe80::0123:1234:2345:3456/64 scope link noprefixroute
#       valid_lft forever preferred_lft forever