# 查看官方 3.3 发布目录，确认最新版本号
curl -sS https://download.phpbb.com/pub/release/3.3/ | grep -oE '3\.3\.[0-9]+' | sort -uV | tail -5

3.3.15
3.3.16
3.3.17
3.3.18
3.3.19

sudo apt-get update
sudo apt-get install -y nginx mariadb-server php8.1-fpm php8.1-mysql php8.1-gd \
  php8.1-curl php8.1-mbstring php8.1-xml php8.1-zip php8.1-intl php8.1-cli \
  php8.1-bcmath php8.1-ldap unzip curl

Reading package lists... Done
Building dependency tree... Done
...
Processing triggers for php8.1-cli (8.1.2-1ubuntu2.28) ...
Processing triggers for php8.1-fpm (8.1.2-1ubuntu2.28) ...

sudo systemctl enable --now nginx
sudo systemctl enable --now php8.1-fpm
sudo systemctl enable --now mariadb

systemctl is-active nginx php8.1-fpm mariadb

active
active
active

nginx -v; php -v | head -1; mariadb --version

nginx version: nginx/1.18.0 (Ubuntu)
PHP 8.1.2-1ubuntu2.28 (cli) (built: Oct 19 2026 18:54:45) (NTS)
mariadb  Ver 15.1 Distrib 10.6.23-MariaDB, for debian-linux-gnu (x86_64) using  EditLine wrapper

php8.1 -m | grep -iE 'mysqli|gd|mbstring|xml|curl|intl|zip'

curl
gd
intl
libxml
mbstring
mysqli
SimpleXML
xml
xmlreader
xmlwriter

sudo mariadb

CREATE DATABASE phpbb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'phpbb'@'localhost' IDENTIFIED BY 'q1w2e3r4';
GRANT ALL PRIVILEGES ON phpbb.* TO 'phpbb'@'localhost';
FLUSH PRIVILEGES;
EXIT;

sudo mariadb -e 'SHOW DATABASES;' | grep phpbb

phpbb

sudo mkdir -p /opt/src && cd /opt/src
curl -sS -O https://download.phpbb.com/pub/release/3.3/3.3.19/phpBB-3.3.19.tar.bz2
curl -sS -O https://download.phpbb.com/pub/release/3.3/3.3.19/phpBB-3.3.19.tar.bz2.sha256
ls -la

total 4040
drwxr-xr-x 2 root root    4096 Oct 22 01:53 .
drwxr-xr-x 1 root root    4096 Oct 22 01:53 ..
-rw-r--r-- 1 root root 4122696 Oct 22 01:53 phpBB-3.3.19.tar.bz2
-rw-r--r-- 1 root root      87 Oct 22 01:53 phpBB-3.3.19.tar.bz2.sha256

sha256sum -c phpBB-3.3.19.tar.bz2.sha256

phpBB-3.3.19.tar.bz2: OK

cd /opt/src
tar -xjf phpBB-3.3.19.tar.bz2
sudo mkdir -p /var/www
sudo cp -a phpBB3 /var/www/phpbb
sudo chown -R www-data:www-data /var/www/phpbb

ls /var/www/phpbb | head -20

adm
app.php
assets
bin
cache
common.php
composer.json
composer.lock
config
config.php
cron.php
docs
download
ext
faq.php
feed.php
files
images
includes
index.php

upstream phpbb-php {
    server unix:/run/php/php8.1-fpm.sock;
}

server {
    listen 80;
    server_name _;
    root /var/www/phpbb;

    index index.php index.html index.htm;

    access_log /var/log/nginx/phpbb.access.log;
    error_log /var/log/nginx/phpbb.error.log warn;

    location / {
        try_files $uri $uri/ @rewriteapp;

        location ~ \.php(/|$) {
            include fastcgi.conf;
            fastcgi_split_path_info ^(.+\.php)(/.*)$;
            fastcgi_param PATH_INFO $fastcgi_path_info;
            fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
            fastcgi_param DOCUMENT_ROOT $realpath_root;
            try_files $uri $uri/ /app.php$is_args$args;
            fastcgi_pass phpbb-php;
        }

        location ~ /(config|common\.php|composer\.(json|lock)|cache|files|images/avatars/upload|includes|(?<!ext/)phpbb(?!\w+)|store|vendor) {
            deny all;
            internal;
        }
    }

    location @rewriteapp {
        rewrite ^(.*)$ /app.php/$1 last;
    }

    location /install/ {
        try_files $uri $uri/ @rewrite_installapp =404;

        location ~ \.php(/|$) {
            include fastcgi.conf;
            fastcgi_split_path_info ^(.+\.php)(/.*)$;
            fastcgi_param PATH_INFO $fastcgi_path_info;
            fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
            try_files $uri $uri/ /install/app.php$is_args$args =404;
            fastcgi_pass phpbb-php;
        }
    }

    location @rewrite_installapp {
        rewrite ^(.*)$ /install/app.php/$1 last;
    }

    location ~ /\.svn|/\.git {
        deny all;
        internal;
    }
}

sudo ln -sf /etc/nginx/sites-available/phpbb.conf /etc/nginx/sites-enabled/phpbb.conf
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t && sudo systemctl reload nginx

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

curl -sS -o /dev/null -w '%{http_code} -> %{redirect_url}\n' http://localhost/

302 -> http://localhost/install/app.php

Creating configuration file        (0/14 → 1/14)
Creating database schema file      (1/14 → 2/14)
Setting up database                (2/14，若库已预建会打印 Skip “installer.install_database.set_up_database” task)
Creating tables                    (2/14 → 3/14)
Adding default settings to the database  (3/14 → 4/14)
Adding configuration settings      (4/14 → 5/14)
Installing available languages     (5/14 → 6/14)
Registering bots                   (6/14 → 7/14)
Registering AI crawlers            (7/14 → 8/14)
Installing modules                 (8/14 → 9/14)
Creating search index              (9/14 → 10/14)
Populating migrations              (10/14 → 11/14)
Installing packaged extensions     (11/14 → 12/14，成功项打印 Successfully enabled extension phpbb/viglink)
Sending notification e-mail        (12/14 → 13/14)

The installer has finished successfully
Take me to the ACP

phpBB 演示社区 - Information
...
Sorry but this board is currently unavailable.

Please delete, move or rename the install directory before you use your board.
If this directory is still present, only administrators will be able to access the board.

sudo rm -rf /var/www/phpbb/install
ls /var/www/phpbb | grep -c install || echo 'install dir removed'

0
install dir removed

curl -sS http://localhost/index.php | grep -oE '<title>[^<]*</title>'

<title>phpBB 演示社区 - Index page</title>

Your first forum
- phpBB 3.3.19 安装验证：首个实测主题
- Welcome to phpBB3

mariadb --default-character-set=utf8mb4 -uphpbb -pq1w2e3r4 phpbb \
  -e "SELECT config_name, config_value FROM phpbb_config WHERE config_name IN ('version','sitename','board_startdate');"

config_name     config_value
sitename        phpBB 演示社区
board_startdate 1792634478
version         3.3.19

mariadb -uphpbb -pq1w2e3r4 phpbb -e 'SHOW TABLES;' | grep -c phpbb_

69

sudo apt-get install -y apache2 libapache2-mod-php8.1

Processing triggers for libapache2-mod-php8.1 (8.1.2-1ubuntu2.28) ...

sudo systemctl enable --now apache2
apache2 -v
apache2ctl -M | grep -i php

Server version: Apache/2.4.52 (Ubuntu)
 php_module (shared)

Active: failed (Result: exit-code) since Thu 2026-10-22 02:06:53 UTC; 5s ago
Oct 22 02:06:53 phpbb-server apachectl[17829]: (98)Address already in use: AH00072: make_sock: could not bind to address 0.0.0.0:80
Oct 22 02:06:53 phpbb-server apachectl[17826]: Action 'start' failed.

sudo sed -i 's/^Listen 80/Listen 81/' /etc/apache2/ports.conf
grep -n '^Listen' /etc/apache2/ports.conf

5:Listen 81

sudo systemctl restart apache2 && systemctl is-active apache2
curl -sS -o /dev/null -w 'HTTP %{http_code}\n' http://localhost:81/

active
HTTP 200

sudo mariadb -e "CREATE DATABASE phpbb2 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'phpbb2'@'localhost' IDENTIFIED BY 'q1w2e3r4';
GRANT ALL PRIVILEGES ON phpbb2.* TO 'phpbb2'@'localhost';
FLUSH PRIVILEGES;"
sudo cp -a /opt/src/phpBB3 /var/www/phpbb2
sudo chown -R www-data:www-data /var/www/phpbb2

<VirtualHost *:81>
    ServerAdmin admin@example.com
    DocumentRoot /var/www/phpbb2

    <Directory /var/www/phpbb2>
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/phpbb2_error.log
    CustomLog ${APACHE_LOG_DIR}/phpbb2_access.log combined
</VirtualHost>

sudo a2dissite 000-default
sudo a2ensite phpbb2
sudo apache2ctl configtest
sudo systemctl reload apache2

Site 000-default disabled.
Enabling site phpbb2.
Syntax OK

curl -sS -o /dev/null -w 'HTTP %{http_code} -> %{redirect_url}\n' http://localhost:81/

HTTP 302 -> http://localhost:81/install/app.php

The installer has finished successfully
Take me to the ACP

$dbms = 'phpbb\db\driver\mysqli';
$dbport = '3306';
$dbname = 'phpbb2';
$dbuser = 'phpbb2';
$dbpasswd = 'q1w2e3r4';
$table_prefix = 'phpbb_';
$acm_type = 'phpbb\cache\driver\file';

sudo rm -rf /var/www/phpbb2/install
curl -sS http://localhost:81/index.php | grep -oE '<title>[^<]*</title>'

<title>phpBB Apache 演示站 - Index page</title>

<?php
// phpBB 3.3.x auto-generated configuration file
// Do not change anything in this file!
$dbms = 'phpbb\db\driver\mysqli';
$dbhost = 'localhost';
$dbport = '3306';
$dbname = 'phpbb';
$dbuser = 'phpbb';
$dbpasswd = 'q1w2e3r4';
$table_prefix = 'phpbb_';
$phpbb_adm_relative_path = 'adm/';
$acm_type = 'phpbb\cache\driver\file';

@define('PHPBB_INSTALLED', true);
@define('PHPBB_ENVIRONMENT', 'production');
// @define('DEBUG_CONTAINER', true);

mariadb --default-character-set=utf8mb4 -uphpbb -pq1w2e3r4 phpbb \
  -e "SELECT config_name, config_value FROM phpbb_config WHERE config_name IN ('sitename','site_desc','default_lang','server_name','server_port','cookie_name','email_enable');"

config_name     config_value
sitename        phpBB 演示社区
site_desc       phpBB 3.3.19 安装实测演示站
default_lang    en
server_name     localhost
server_port     80
cookie_name     phpbb3_s11y5
email_enable    1

mariadb-dump -uphpbb -pq1w2e3r4 phpbb | gzip > phpbb_$(date +%F).sql.gz

mariadb-dump -uphpbb -pq1w2e3r4 phpbb | gzip > /root/phpbb_backup.sql.gz

sudo rm -rf /var/www/phpbb

sudo mariadb -e "DROP DATABASE phpbb; DROP USER 'phpbb'@'localhost';"

sudo rm -f /etc/nginx/sites-enabled/phpbb.conf /etc/nginx/sites-available/phpbb.conf
sudo nginx -t && sudo systemctl reload nginx

sudo apt-get purge -y nginx php8.1-fpm apache2 libapache2-mod-php8.1

sudo apt-get purge -y mariadb-server

sudo rm -rf /opt/src/phpBB-3.3.19.tar.bz2 /opt/src/phpBB3

curl -sS -o /dev/null -w '%{http_code}\n' http://localhost/ ; ls /var/www/phpbb 2>&1

404
ls: cannot access '/var/www/phpbb': No such file or directory