-
Was ist ein VPS?
-
VPS und Sicherheit
-
VPS - Anwendungsfälle
-
VPS bei METANET
-
VPS und Plesk
-
VPS - Einrichtung & Konfiguration
0. Überblick
- Verwendetes System: Debian 11 64 bit
- Genutzter User: Ich nehme alles als «root» vor
- Testsystem: Cloud Server M
- Zeitdauer: ca. 5 Minuten
- Schwierigkeit: Einfach. Nur Code kopieren 😉
- Besonderheiten:
- Grundlage ist folgende Anleitung: Traefik Reverseproxy installieren Diese Anleitung muss zuerst ausgeführt werden.
- Die Installation von Docker / Docker Compose wird hier vorausgesetzt.
1. Typo3 installieren
1.1 Einleitung
Typo3 (https://typo3.com) ist eine open source Content Management System (CMS). Laut typo3.com nutzen derzeit 500'000 Webseiten im Internet dieses CMS und gibt ca. 1500 Erweiterungen dazu. Typo3 ist ein sehr mächtiges CMS, welches jedoch keinen so leichten Einstieg wie beispielsweise Wordpress bietet.
1.2 Infos zu yml Dateien
Bei yml Dateien ist es sehr wichtig, dass die Zeilen alle richtig eingerückt sind. Die Zeilen MÜSSEN immer mit der Leertaste eingerückt werden. Es dürfen KEINE Tabs enthalten sein. Sie können den nachfolgenden Code immer online «überprüfen» lassen. Die meisten Fehler entstehen nämlich durch die falsche Formatierung. Ein Dienst zum Überprüfen ist zum Beispiel: https://codebeautify.org/yaml-validator
1.3 Vorbereitung
Diese Anleitung basiert auf dem aktuellen Debian 10 Betriebssystem. Typo3 werden wir unter Docker realisieren. Dies ermöglicht uns später sehr schnelle Updates und eine schnelle Installation.
Um Typo3 neben anderen Diensten auf unserem Server betreiben zu können, nutzen wir hier den Reverse Proxy Traefik.
VPS Server von METANET
Finden Sie den Server der zu Ihren Anforderungen passt – jetzt einfach vergleichen.
1.3.1 Verzeichnis erstellen
Wir erstellen uns ein neues Verzeichnis, in welchem wir später alle Daten von Typo3 abspeichen. Dazu geben Sie folgendes in der Konsole ein:
mkdir -p /opt/containers/typo3/{database,fileadmin,typo-build,typo3conf,uploads}
Sie können hier auch ein anderes Verzeichnis verwenden. Müssen dann aber die gesamte Anleitung entsprechend anpassen.
1.3.2 docker-compose.yml erstellen
Nun können wir mit der eigentlichen «Installation» von Typo3 beginnen. Dazu öffnen Sie folgende Datei:
nano /opt/containers/typo3/docker-compose.yml
Nun kopieren Sie folgenden Code in die Datei. Dieser Code ist unser Bauplan für unseren Typo3 Container.
version: '2'
services:
typo3-db:
image: mariadb:latest
container_name: typo3-db
environment:
- MARIADB_USER=typo3
- MARIADB_DATABASE=typo3
- MARIADB_PASSWORD=sicher12!
- MARIADB_CHARACTER_SET=utf8mb4
- MARIADB_COLLATE=utf8mb4_unicode_ci
- MARIADB_RANDOM_ROOT_PASSWORD=1
volumes:
- ./database:/var/lib/mysql
networks:
- default
restart: unless-stopped
typo3:
build: ./typo-build
container_name: typo3
restart: unless-stopped
volumes:
- ./fileadmin:/var/www/html/fileadmin
- ./typo3conf:/var/www/html/typo3conf
- ./uploads:/var/www/html/uploads
networks:
- default
- proxy
depends_on:
- typo3-db
labels:
- "traefik.enable=true"
- "traefik.http.routers.typo3.entrypoints=http"
- "traefik.http.routers.typo3.rule=Host('typo.euredomain.de')" # Hier Ihre URL eingeben #
- "traefik.http.middlewares.typo3-https-redirect.redirectscheme.scheme=https"
- "traefik.http.routers.typo3.middlewares=typo3-https-redirect"
- "traefik.http.routers.typo3-secure.entrypoints=https"
- "traefik.http.routers.typo3-secure.rule=Host('typo.euredomain.de')" # Hier Ihre URL eingeben #
- "traefik.http.routers.typo3-secure.tls=true"
- "traefik.http.routers.typo3-secure.tls.certresolver=http"
- "traefik.http.routers.typo3-secure.service=typo3"
- "traefik.http.services.typo3.loadbalancer.server.port=80"
- "traefik.docker.network=proxy"
- "traefik.http.routers.typo3-secure.middlewares=secHeaders@file"
networks:
proxy:
external: true
Nun müssen wir noch einiges anpassen.
1.3.3 Hostname anpassen
Nun müssen Sie noch den Hostnamen anpassen, über welchen später Moodle erreichbar sein soll.
Diese beiden Zeilen müssen Sie anpassen.
- "traefik.http.routers.typo3-app.rule=Host('typo.euredomain.de')"
- "traefik.http.routers.typo3-app-secure.rule=Host('typo.euredomain.de')"
In meinem Fall also:
- "traefik.http.routers.typo3.rule=Host('typo.testbereich.net')"
- "traefik.http.routers.typo3-secure.rule=Host('typo.testbereich.net')"
Wenn Sie Typo3 direkt auf Ihrer «Hauptdomain» betreiben wollen, dann ändern Sie es folgendermassen ab:
"traefik.http.routers.typo.rule=Host('www.euredomain.de','euredomain.de')"
"traefik.http.routers.typo-secure.rule=Host('www.euredomain.de','euredomain.de')"
1.3.4 Datenbank Passwort anpassen
Nachdem Sie den Hostnamen angepasst haben, müssen Sie noch das Datenbank Passwort anpassen. Vergeben Sie ein langes, sicheres Kennwort.
Folgende Zeile müssen Sie ändern:
- MARIADB_PASSWORD=sicher12!
Ich ändere also meine Kennwörter ab. Dies könnte beispielsweise so sein:
- MARIADB_PASSWORD=Fhas23!da4
1.3.5 Dockerfile anlegen
Nun legen wir noch die Datei an, welche später unseren Typo3 Container baut. Dazu geben Sie folgendes ein:
nano /opt/containers/typo3/typo-build/Dockerfile
In die Datei kopieren Sie folgendes:
# Docker image for TYPO3 CMS
# Copyright (C) 2016-2020 Martin Helmich martin@helmich.me
# and contributors https://github.com/martin-helmich/docker-typo3/graphs/contributors
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see https://www.gnu.org/licenses/.
FROM php:7.4-apache-buster
LABEL maintainer="Martin Helmich typo3@martin-helmich.de"
# Install TYPO3
RUN apt-get update && \
apt-get install -y --no-install-recommends \
wget \
# Configure PHP
libxml2-dev libfreetype6-dev \
libjpeg62-turbo-dev \
libmcrypt-dev \
libpng-dev \
libpq-dev \
libzip-dev \
zlib1g-dev \
# Install required 3rd party tools
graphicsmagick && \
# Configure extensions
docker-php-ext-configure gd --with-libdir=/usr/include/ --with-jpeg --with-freetype && \
docker-php-ext-install -j$(nproc) mysqli soap gd zip opcache intl pgsql pdo_pgsql && \
echo 'always_populate_raw_post_data = -1\nmax_execution_time = 240\nmax_input_vars = 1500\nupload_max_filesize = 32M\npost_max_size = 32M' > /usr/local/etc/php/conf.d/typo3.ini && \
# Configure Apache as needed
a2enmod rewrite && \
apt-get clean && \
apt-get -y purge \
libxml2-dev libfreetype6-dev \
libjpeg62-turbo-dev \
libmcrypt-dev \
libpng-dev \
libzip-dev \
zlib1g-dev && \
rm -rf /var/lib/apt/lists/* /usr/src/*
RUN cd /var/www/html && \
wget -O download.tar.gz https://get.typo3.org/10.4.17 && \
echo "05a9f6352b2506b2a3446d0e8d18cefb7ed5e25c0ee5f1aff80ccf68fdc775c6 download.tar.gz" > download.tar.gz.sum && \
sha256sum -c download.tar.gz.sum && \
tar -xzf download.tar.gz && \
rm download.* && \
ln -s typo3_src-* typo3_src && \
ln -s typo3_src/index.php && \
ln -s typo3_src/typo3 && \
cp typo3/sysext/install/Resources/Private/FolderStructureTemplateFiles/root-htaccess .htaccess && \
mkdir typo3temp && \
mkdir typo3conf && \
mkdir fileadmin && \
mkdir uploads && \
touch FIRST_INSTALL && \
chown -R www-data. .
1.3.6 Ordnerberechtigungen anpassen
Nun passen wir noch die Berechtigungen an, damit Typo3 später auf unsere Ordner zugreifen kann. Geben Sie dazu folgendes ein:
chown www-data:www-data /opt/containers/typo3/fileadmin/
chown www-data:www-data /opt/containers/typo3/uploads
chown www-data:www-data /opt/containers/typo3/typo3conf
Nun sind wir fertig mit der Vorbereitung.
2. Typo3 starten
Als erstes «bauen» wir unseren Container. Geben Sie dazu folgendes ein:
cd /opt/containers/typo3/
docker compose build
Nun können wir Typo3 starten. Dazu geben Sie folgendes ein:
docker compose -f /opt/containers/typo3/docker-compose.yml up -d
Jetzt gehen Sie mit Ihrem Browser auf die Webseite. Dies ist bei mir https://typo.testbereich.net.
Hier sollte jetzt alles grün sein.
Anschliessend geben Sie diese Daten ein sowie das Kennwort, welches Sie im Schritt 1.3.4 vergeben haben.
Nun wählen wir die Datenbank «typo3» aus.
Hier müssen Sie noch einen Nutzernamen sowie Passwort vergeben für den Administrator Account.
Jetzt sind Sie fertig mit der Installation.
Klicken Sie hier aber noch NICHT weiter. Wir müssen noch eine Einstellung (TYPO3 Exception 1588095935 — TYPO3 Exceptions master documentation) anpassen.
Geben Sie dazu folgendes ein:
nano /opt/containers/typo3/typo3conf/LocalConfiguration.php
Scrollen Sie nun ganz nach unten und fügen Sie dort folgende Zeile noch ein:
'security.backend.enforceReferrer' => false,
Dies sollte dann so aussehen.
Nun können Sie im Webbrowser weitermachen und sich ganz normal anmelden mit Ihrem neu erstellten Administrator Account.
Hier haben Sie nun alle Einstellungen und können Typo3 anpassen.