selim13/phpbb

phpBB3 Docker镜像

基于Alpine的轻量级phpBB Docker镜像。

支持的标签及对应Dockerfile链接

• https://github.com/selim13/docker-phpbb/blob/master/Dockerfile%EF%BC%9A%E5%86%85%E7%BD%AEPHP 8
• https://github.com/selim13/docker-phpbb/blob/3.2-alpine-apache/Dockerfile%EF%BC%9A%E5%86%85%E7%BD%AEPHP 7.2

如何使用此镜像

初始安装

如果尚未准备phpBB数据库，可使用标准phpBB安装脚本，通过运行带有PHPBB_INSTALL=true环境变量的临时容器：

console
$ docker run -p 8000:80 --name phpbb-install -e PHPBB_INSTALL=true -d selim13/phpbb:3.3

在浏览器中访问http://localhost:8000开始安装流程。

此镜像内置SQLite3、MySQL和PostgreSQL数据库引擎支持。其他引擎可通过创建自定义Dockerfile添加。对于MySQL和PostgreSQL，可使用标准容器链接；若需独立容器，可使用SQLite。

SQLite3配置：将“数据库服务器主机名或DSN”字段设为/phpbb/sqlite/sqlite.db。该文件会创建在Docker卷中，且位于Web服务器文档根目录外以确保安全。用户名、密码和数据库名字段留空。

安装完成后，可安全停止临时容器：

console
$ docker stop phpbb-install

启动容器

可按以下方式启动容器：

console
$ docker run --name phpbb -d selim13/phpbb:3.3

默认使用SQLite3作为数据库后端，需提供数据库文件，默认路径为/phpbb/sqlite/sqlite.db。

可从上述临时安装容器导入数据库：

console
$ docker run --volumes-from phpbb-install --name phpbb -d selim13/phpbb:3.3

或从现有phpBB安装复制数据库文件到容器：

console
$ docker cp /path/at/host/sqlite.db phpbb:/www/sqlite/sqlite.db

对于其他数据库引擎，需通过环境变量传递凭据和驱动类型：

console
$ docker run --name phpbb     \
    -e PHPBB_DB_DRIVER=mysqli \
    -e PHPBB_DB_HOST=dbmysql  \
    -e PHPBB_DB_PORT=3306     \
    -e PHPBB_DB_NAME=phpbb    \
    -e PHPBB_DB_USER=phpbb    \
    -e PHPBB_DB_PASSWD=pass -d selim13/phpbb:3.3

环境变量

此镜像使用环境变量进行基础配置，大部分会直接传递给phpBB的config.php或启动脚本。

PHPBB_INSTALL

设为true时，容器将以空config.php文件和完整的phpBB/install/目录启动，便于全新安装时初始化论坛数据库。

PHPBB_DB_DRIVER

选择数据库驱动。phpBB3支持以下驱动：

• mssql - MS SQL Server
• mysql - 基于旧版PHP扩展的MySQL
• mysqli - 基于新版PHP扩展的MySQL
• oracle - Oracle
• postgres - PostgreSQL
• sqlite - SQLite 2
• sqlite3 - SQLite 3

此镜像内置sqlite3、mysqli和postgres驱动支持。

默认值：sqlite3

PHPBB_DB_HOST

数据库主机名或IP地址。

对于SQLite3驱动，设置数据库文件路径。

默认值：/phpbb/sqlite/sqlite.db

PHPBB_DB_PORT

数据库端口。

PHPBB_DB_NAME

phpBB3数据库名称。

PHPBB_DB_USER

phpBB3数据库用户名。

PHPBB_DB_PASSWD

phpBB3数据库用户密码。

若担心通过环境变量传递密码，可通过卷或扩展镜像提供自定义config.php文件。

PHPBB_DB_TABLE_PREFIX

phpBB3数据库表前缀。

默认值：phpbb_

PHPBB_DB_AUTOMIGRATE

设为true时，容器在每次启动时执行bin/phpbbcli.php db:migrate运行数据库迁移。若迁移失败，容器将无法启动。

PHPBB_DB_WAIT

设为true时，容器将等待数据库服务可用。需显式设置PHPBB_DB_HOST和PHPBB_DB_PORT。建议与PHPBB_DB_AUTOMIGRATE配合使用，避免在数据库就绪前执行迁移。不适用于SQLite（始终可用）。

PHPBB_DISPLAY_LOAD_TIME

设为true时，phpBB将在页面底部显示加载时间、查询次数和峰值内存使用情况。

PHPBB_DEBUG

设为true时，启用phpBB调试模式。

PHPBB_DEBUG_CONTAINER

卷

默认每个容器创建四个卷：

• /phpbb/sqlite
• /phpbb/www/files
• /phpbb/www/store
• /phpbb/www/images/avatars/upload

额外配置

此镜像基于Alpine官方镜像，包含apache2和php5包（来自Alpine Linux仓库）。可将自定义配置文件放入/etc/apache2/conf.d和/etc/php5/conf.d。

从代理传递用户IP

若容器部署在代理（如https://github.com/jwilder/nginx-proxy%EF%BC%89%E5%90%8E%EF%BC%8C%E5%BB%BA%E8%AE%AE%E8%8E%B7%E5%8F%96%E7%94%A8%E6%88%B7%E7%9C%9F%E5%AE%9EIP%E8%80%8C%E9%9D%9E%E4%BB%A3%E7%90%86IP%E3%80%82%E5%8F%AF%E4%BD%BF%E7%94%A8Apache RemoteIP模块，创建配置文件：

apache
LoadModule remoteip_module modules/mod_remoteip.so

RemoteIPHeader X-Real-IP
RemoteIPInternalProxy nginx-proxy

其中X-Real-IP是代理传递真实IP的头字段，nginx-proxy是代理主机名。

通过扩展镜像将配置文件放入/etc/apache2/conf.d/目录：

dockerfile
FROM selim13/phpbb:3.3

COPY remoteip.conf /etc/apache2/conf.d