本教程适用于以下操作系统版本
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
- Debian 9 (Stretch)
本页内容
- 前提条件
- 安装 LAMP Stack
- 配置 MariaDB 部署
- 为 TYPO3 CMS 创建新数据库和用户
- 安装 Composer
- 使用 Composer 下载 TYPO3 CMS
- 设置 Apache 虚拟主机
- 安装 TYPO3 CMS
- 结论
TYPO3 是一个免费开源的企业级内容管理系统。它为企业级应用提供了许多特性,例如支持多站点的可扩展 CMS、多语言安装、强大的安全实现、极快的速度,并且可以在任何地方运行。
使用 TYPO3 CMS 可以让你构建灵活且可靠的网站。TYPO3 CMS 背后是一个活跃的专业社区。而且从设计上来说,TYPO3 CMS 是一个可插拔的内容管理系统,具有适应性强且解耦的架构。
在本指南中,我将向你展示如何在最新的 Debian 11 Bullseye 上使用 LAMP Stack 安装 TYPO3 CMS。此外,我们还将介绍 TYPO3 CMS 的典型基础安装。
前提条件
- 一台 Debian 11 的 Linux 服务器。
- 一个 root 用户或具有 root 权限的非 root 用户。
- 一个指向服务器 IP 地址的域名。
安装 LAMP Stack
TYPO3 CMS 是用 PHP 编写的,因此你需要安装 LAMP 或 LEMP Stack 来进行安装。本指南将向你展示如何为 TYPO3 CMS 设置 LAMP Stack。
在安装一些软件包之前,运行下面的 apt 命令来更新你的仓库并刷新 Debian 系统上的软件包索引。
sudo apt update
接下来,使用以下命令安装基础的 LAMP Stack 软件包。
sudo apt install apache2 mariadb-server php php-common php-mysql libapache2-mod-php php-gd php-curl php-json php-xmlrpc php-intl php-bcmath php-zip php-apcu php-mbstring php-fileinfo php-xml php-soap
输入 Y 确认安装并按 ENTER 继续。

所有软件包安装完成后,使用 nano 编辑器编辑配置文件 /etc/php/7.4/apache2/php.ini。
sudo nano /etc/php/7.4/apache2/php.ini
使用以下配置更改默认的 PHP 配置。
memory_limit = 512M max_execution_time = 240 max_input_vars = 1500 date.timezone = Europe/Amsterdam post_max_size = 50M upload_max_filesize = 50
完成后保存文件。
最后,重启 Apache2 服务以应用对 PHP 配置的新更改,并验证 Apache2 服务。
sudo systemctl restart apache2
sudo systemctl status apache2
下面你将看到 Apache2 服务处于 active (running) 状态。

配置 MariaDB 部署
你已经在服务器上安装了 MariaDB 服务器软件包,但仍处于默认设置。现在,我们将向你展示如何使用命令行工具 mysql_secure_installation 部署 MariaDB 服务器的安全性。
mysql_secure_installation 命令包含在 MariaDB 软件包中。它将帮助你为 MariaDB 服务器设置基本安全,例如设置 root 密码、移除默认的匿名访问、移除 test 数据库,以及禁用 MariaDB root 用户的远程登录。
执行下面的 mysql_secure_installation 命令以开始配置 MariaDB 部署。
sudo mysql_secure_installation
当询问当前的 root 密码时按 ENTER。
Enter current password for root (enter for none): OK, successfully used password, moving on...
现在输入 Y 确认并将本地认证切换为 unix_socket。
Switch to unix_socket authentication [Y/n] Y Enabled successfully! Reloading privilege tables.. ... Success!
现在输入 Y 确认为 MariaDB 服务器设置一个新的 root 密码。然后输入新密码并重复一次。请确保为 MariaDB root 用户设置一个强密码。
Change the root password? [Y/n] Y New password: Re-enter new password: Password updated successfully! Reloading privilege tables.. ... Success!
现在输入 Y 以移除对 MariaDB 数据库服务器的默认匿名访问。
Remove anonymous users? [Y/n] Y ... Success!
输入 Y 以禁用 MariaDB root 用户的远程登录。要对 MariaDB 服务器进行远程连接,你需要创建另一个用户。
Disallow root login remotely? [Y/n] Y ... Success!
现在再次输入 Y 以从你的 MariaDB 服务器中移除默认的 test 数据库。
Remove test database and access to it? [Y/n] Y - Dropping test database... ... Success! - Removing privileges on test database... ... Success!
最后,再次输入 Y 以确认并重新加载 MariaDB 服务器上所有表的权限并应用新更改。
Reload privilege tables now? [Y/n] Y ... Success!
现在你已经完成了 MariaDB 数据库服务器的基本配置。
为确保所有更改都已应用到 MariaDB 服务器,运行下面的命令重启 MariaDB 服务并验证服务状态。
sudo systemctl restart mariadb
sudo systemctl status mariadb
现在你将看到 MariaDB 服务器处于 active (running) 状态。

为 TYPO3 CMS 创建新数据库和用户
至此,你已经完成了 TYPO3 CMS 安装所需的基础 LAMP Stack 安装。现在你将为 TYPO3 CMS 创建一个新的 MariaDB 数据库和用户。
使用下面的 mysql 命令登录到 MariaDB shell。系统将要求你输入 MariaDB root 密码。
mysql -u root -p
现在运行以下 MariaDB 查询语句,创建一个新数据库 typo3db,用户为 typo3,密码为 typo3password。
CREATE DATABASE typo3db;
GRANT ALL PRIVILEGES ON typo3db.* to typo3@localhost IDENTIFIED BY 'typo3password';
FLUSH PRIVILEGES;
EXIT;
现在输入 EXIT 从 MariaDB shell 退出,并继续 TYPO3 CMS 的安装。

安装 Composer
TYPO3 CMS 可以通过不同方式安装。在本指南中,你将使用 Composer 安装 TYPO3 CMS。所以现在你将在 Debian 11 服务器上安装 Composer。
首先,运行下面的命令下载 PHP Composer 安装程序并验证安装程序文件。
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '906a84df04cea2aa72f40b5f787e49f22d4c2f19492ac310e8cba5b96ac8b64115ac402c8cd292b8a03482574915d1a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
确保你看到输出消息 " Installer verified ",这表示安装程序文件是正确的。
接下来,运行 Composer 安装程序脚本以下载 Composer。下载完成后,删除该安装程序脚本。
php composer-setup.php
php -r "unlink('composer-setup.php');"
现在将文件 composer.phar 移动到 /usr/local/bin 目录,以便 Debian 系统上的用户能够运行 Composer。
sudo mv composer.phar /usr/local/bin/composer

最后,使用以下命令验证 Composer 的安装。
sudo -u www-data composer --version
sudo -u www-data composer -v
你将看到 PHP composer v2.3.3 已安装在你的 Debian 11 系统上,现在你已准备好安装 TYPO3 CMS。

使用 Composer 下载 TYPO3 CMS
要开始 TYPO3 CMS 的安装,使用以下命令创建一个新目录 /var/www/typo3。
mkdir -p /var/www/typo3
将 /var/www/typo3 目录的所有权更改为用户 www-data,并允许 www-data 用户写入该目录。
sudo chown -R www-data:www-data /var/www/typo3
sudo chmod u+rw /var/www/typo3

接下来,进入 /var/www/typo3 目录并运行下面的 Composer 命令,将 TYPO3 CMS 安装到你的服务器上。
cd /var/www/typo3
sudo -u www-data composer create-project typo3/cms-base-distribution:^11 .
Composer 将下载 TYPO3 CMS 和 PHP 依赖。

安装完成后,运行 ls 命令以验证 / var/www/typo3 下所有可用的文件和目录。
ls
你将看到名为 public 的目录,它是 TYPO3 CMS 默认的实际源码目录,并将用作虚拟主机配置的 DocuemtRoot。
设置 Apache 虚拟主机
使用 Composer 下载 TYPO3 CMS 之后,现在你将为 TYPO3 CMS 安装创建一个新的虚拟主机配置。
进入 /etc/apache2/sites-available 目录,并使用 nano 编辑器创建一个新的虚拟主机配置 typo3.conf。
cd /etc/apache2/sites-available/
sudo nano typo3.conf
将以下配置添加到新的虚拟主机 typo3.conf 中。确保更改域名和 SSL 证书的路径。
<VirtualHost *:80>
ServerName example.io
Redirect permanent / https://example.io/
</VirtualHost>
<VirtualHost *:443>
ServerAdmin
[email protected]
DocumentRoot /var/www/typo3/public
ServerName example.io
Protocols h2 http/1.1
SSLEngine On
SSLCertificateFile /etc/letsencrypt/live/example.io/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.io/privkey.pem
<Directory /var/www/typo3/public/>
Options FollowSymlinks
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
<Directory /var/www/typo3/public/>
RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*) index.php [PT,L]
</Directory>
</VirtualHost>
完成后保存文件。
接下来,使用以下命令激活一些 Apache2 模块。
sudo a2enmod ssl rewrite headers
之后,激活虚拟主机配置 typo3.conf 并验证所有 Apache2 配置。
sudo a2ensite typo3.conf
sudo apachectl configtest
确保你看到消息 Syntax OK,这表示 Apache 配置是正确的。

最后,运行以下命令重启并验证 Apache2 服务。并确保 Apache2 服务的状态为 active (running)。
sudo systemctl restart apache2
sudo systemctl status apache2

现在你已经完成了 TYPO3 CMS 安装的 Apache2 虚拟主机配置。
安装 TYPO3 CMS
在开始 TYPO3 CMS 安装之前,你需要在 public 目录内创建一个新的空白文件 FIRST_INSTALL。这将表明你是在这台服务器上首次安装 TYPO3 CMS。
使用以下命令在 public 目录下创建一个新文件 FIRST_INSTALL。
sudo -u www-data touch /var/www//typo3/public/FIRST_INSTALL
接下来,打开你的 Web 浏览器并输入 TYPO3 CMS 安装的域名。
https://example.io/
现在你将看到 TYPO3 CMS 安装的第一页。确保你的安装环境没有问题。然后点击绿色按钮继续。

对于数据库配置,输入数据库用户名和密码,然后点击 Continue。

现在选择选项 Use an existing empty database 并选择数据库 typo3db,然后点击 Continue。

现在你需要为 YUPO3 CMS 创建一个管理员用户和密码,然后点击 Continue 完成安装。

TYPO3 CMS 安装现已完成,点击按钮 Open the TYPO3 Backend。

你将被重定向到 TYPO3 CMS 登录页面。输入你的管理员用户和密码,然后点击 Login。

一旦用户名和密码正确,你将看到 TYPO3 CMS 管理仪表板。

在 Admin 用户图标内,你将看到矩形菜单。点击它,你将看到 TYPO3 CMS 安装的详细环境。

结论
恭喜!你现在已经在最新的 Debian 11 Bullseye 上使用 LAMP Stack 成功安装了 TYPO3 CMS。现在你可以为 TYPO3 CMS 创建自定义索引,并探索一些扩展来扩展 TYPO3 CMS 在你环境中的应用。