imported>Thorsten Klöhn: Import aus Zensical-Doku (Wissen Ahrensburg)

2026-08-10T20:30:25Z

Import aus Zensical-Doku (Wissen Ahrensburg)

Neue Seite

APT-Konfiguration 
Zuerst müssen Sie Ihren Paketmanager so konfigurieren, dass er das XWiki-Repository verwendet. Dies können Sie einfach mit den folgenden Befehlen tun:

<syntaxhighlight lang="bash">sudo wget https://maven.xwiki.org/xwiki-keyring.gpg -O /usr/share/keyrings/xwiki-keyring.gpg
sudo wget "https://maven.xwiki.org/stable/xwiki-stable.list" -O /etc/apt/sources.list.d/xwiki-stable.list</syntaxhighlight>
'''Information''' 
Beachten Sie, dass es mehrere Repositories gibt, aus denen Sie wählen können (als Alternative zum oben genannten Stable-Repository):

* <code>https://maven.xwiki.org/releases/xwiki-releases.list</code>: Alle veröffentlichten Versionen, einschließlich Meilensteine und Release Candidates (instabil).
* <code>https://maven.xwiki.org/stable/xwiki-stable.list</code>: Alle veröffentlichten Versionen, ohne Meilensteine und Release Candidates (stabil).
* <code>https://maven.xwiki.org/lts/xwiki-lts.list</code>: Alle veröffentlichten Cycle-LTS-Versionen.
* <code>https://maven.xwiki.org/lts/xwiki-lts-latest.list</code>: Neueste LTS-Versionen (kann Cycle-LTS oder Intermediate-LTS sein, wenn diese höher sind).

Weitere Informationen zu den verschiedenen unterstützten Zweigen finden Sie auf der Support-Seite.


== Aktualisierung ==

<syntaxhighlight lang="bash">sudo apt-get update</syntaxhighlight>

== Suchen nach XWiki-Versionen ==

<syntaxhighlight lang="bash">apt-cache search xwiki</syntaxhighlight>

== XWiki installieren ==

<syntaxhighlight lang="bash">sudo apt-get install xwiki-tomcat10-pgsql
sudo systemctl stop tomcat10</syntaxhighlight>

== Port auf 9000 ändern ==

<pre>sudo nano /etc/tomcat10/server.xml</pre>
Suchen Sie in der Datei <code>server.xml</code> nach dem folgenden Abschnitt:

<syntaxhighlight lang="xml"><Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" /></syntaxhighlight>
Ändern Sie den Wert des <code>port</code>-Attributs von <code>8080</code> auf <code>9000</code>:

<syntaxhighlight lang="xml"><Connector port="9000" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" /></syntaxhighlight>
Speichern Sie die Datei und schließen Sie den Editor.


== Port auf localhost beschränken und Ersteinrichtung per SSH-Tunnel ==

Bevor Nginx als Reverse Proxy steht, wäre Port 9000 sonst öffentlich erreichbar — inklusive des unfertigen Distribution Wizards, der beim ersten Aufruf das Administratorkonto anlegt. Statt den Port dafür kurzzeitig in der Firewall freizugeben, wird der Connector direkt auf <code>localhost</code> beschränkt und die Ersteinrichtung über einen SSH-Tunnel erledigt.

Im selben <code><Connector></code>-Element zusätzlich das <code>address</code>-Attribut setzen:

<syntaxhighlight lang="xml"><Connector address="127.0.0.1" port="9000" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" /></syntaxhighlight>
Tomcat starten:

<syntaxhighlight lang="bash">sudo systemctl start tomcat10</syntaxhighlight>
Auf dem eigenen Rechner den Port per Local Forwarding zum Server tunneln:

<syntaxhighlight lang="bash">ssh -L 9000:127.0.0.1:9000 admin@SERVER-IP</syntaxhighlight>
Solange die SSH-Sitzung besteht, ist der Distribution Wizard im eigenen Browser unter <code>http://127.0.0.1:9000/xwiki</code> erreichbar — verschlüsselt über die SSH-Verbindung, ohne dass Port 9000 je öffentlich sichtbar war. Dort das erste Administratorkonto anlegen. Mehr zu Local Forwarding und weiteren Tunnel-Varianten: [[Entwicklung / Server & Infrastruktur / Sicherheit / SSH-Tunnel|SSH-Tunnel: Portweiterleitung über SSH]].

'''Hinweis'''

Die <code>address="127.0.0.1"</code>-Bindung bleibt auch nach der Ersteinrichtung dauerhaft bestehen — Nginx läuft auf demselben Host und erreicht Tomcat ohnehin über <code>localhost</code> (siehe <code>proxy_pass</code> unten). Der Tunnel war nur das temporäre Zugangsmittel für die einmalige Kontoanlage, bevor Nginx als dauerhafter, öffentlicher Zugangsweg konfiguriert ist.


== Nginx Konfigration ==

Um Nginx als Reverse Proxy für XWiki zu konfigurieren, erstellen oder bearbeiten Sie eine Konfigurationsdatei, z.B. <code>/etc/nginx/conf.d/xwiki.conf</code>:

<syntaxhighlight lang="nginx">server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name xwiki.wissen-ahrensburg.de;
ssl_certificate /etc/letsencrypt/live/wissen-ahrensburg.de/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/wissen-ahrensburg.de/privkey.pem;

location / {
proxy_pass http://localhost:9000/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}</syntaxhighlight>
Aktivieren Sie die Konfiguration und starten Sie Nginx neu:

<syntaxhighlight lang="bash">
sudo nginx -t
sudo systemctl reload nginx</syntaxhighlight>
Passen Sie <code>server_name</code> an Ihre Domain an.

'''Tipp'''

Statt der TCP-Verbindung über <code>localhost:9000</code> lässt sich Nginx auch über einen Unix-Socket an Tomcat anbinden — siehe [[Wissen / Dokumentation / XWiki / Nginx über Unix-Socket anbinden|Nginx über Unix-Socket anbinden]].


== Port 9000 in der Firewall sperren (UFW) ==

Die <code>address="127.0.0.1"</code>-Bindung von weiter oben schützt bereits auf Netzwerkebene. Als zweite, unabhängige Absicherungsebene sollte Port 9000 zusätzlich in der Firewall nie freigegeben werden — falls die Connector-Bindung später versehentlich wieder auf <code>0.0.0.0</code> gestellt wird:

<syntaxhighlight lang="bash">sudo ufw allow "Nginx Full"
sudo ufw deny 9000/tcp
sudo ufw status verbose</syntaxhighlight>
Die explizite <code>deny</code>-Regel ist bei UFWs Standardrichtlinie (<code>default deny incoming</code>) zwar redundant, macht die Absicht aber in <code>ufw status</code> sichtbar und dokumentiert sie selbsterklärend. Details zu UFW: [[Entwicklung / Server & Infrastruktur / Sicherheit / UFW-Firewall|UFW-Firewall installieren und steuern]].

Für spätere administrative Zugriffe direkt auf Port 9000 (z. B. Fehlersuche ohne Nginx) eignet sich statt einer Portfreigabe weiterhin ein [[Entwicklung / Server & Infrastruktur / Sicherheit / SSH-Tunnel|SSH-Tunnel]].

Wissen / Dokumentation / XWiki / Installieren - Versionsgeschichte

imported>Thorsten Klöhn: Import aus Zensical-Doku (Wissen Ahrensburg)