使用1panel V2面板安装部署Flarum论坛系统

在 1Panel V2 面板上安装 Flarum 论坛系统教程

本教程详细介绍如何在 1Panel V2 面板中成功安装 Flarum 论坛系统，并包含了解决依赖问题的实战经验。

一、 前期准备

一台基于 Linux 的服务器（推荐 CentOS 9+、Debian 12、Ubuntu 20+，本教程使用 Ubuntu 24.04）。

能够通过 SSH 连接服务器。

服务器可正常访问外部网络。

二、 安装 1Panel V2 面板

通过 SSH 连接服务器，执行以下安装命令：

bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

安装过程中，根据提示完成设置（如安装 Docker、设置访问端口、用户名和密码），这些信息后续均可在面板中修改。

安装完如下：

三、 配置基础环境

安装必要服务
登录 1Panel 后台，进入“应用商店”，安装以下服务：

OpenResty (用于 Web 服务)

MySQL (用于数据库)

(可选) phpMyAdmin (用于数据库可视化管理，安装时建议开启“外部访问”)。

创建 PHP 运行环境
进入“网站”->“运行环境”，点击“创建运行环境”：

名称：自定义（如 flarumPHP）。

来源：默认。

PHP 版本：选择 8.3（Flarum 目前支持的最高版本）。

扩展模版：务必选择 flarum，此模板已包含 curl, gd, pdo_mysql, mysqli, bz2, exif 等必装扩展。如需 Redis，可额外勾选。

创建网站
进入“网站”->“网站”，点击“创建网站”：

运行环境：类型选择 PHP，并选中上一步创建的 flarumPHP 环境。

填写您的域名。

同时创建好数据库，记下数据库名称、用户名和密码。

四、 关键配置调整

解除 PHP 函数限制
这是 1Panel V2 与 V1 路径有区别的地方。进入“网站”->“运行环境”，找到您创建的 PHP 环境，点击“更多”->“配置”->“配置文件”。

在配置文件中，按 Ctrl+F 搜索 disable_functions，在该行行首添加分号 ; 将其注释掉，然后保存并重载配置。

五、 安装 Flarum

清理网站根目录
进入“网站”->“运行环境”，点击对应环境的“终端”。在终端中执行以下命令，进入网站目录并清理默认文件：

cd /www/sites/你的主域名/index
rm -rf index.html 404.html

提示：也可通过 1Panel 的“文件”功能手动删除这些文件。

通过 Composer 安装 Flarum

在同一个终端中，执行 Flarum 安装命令：

composer create-project flarum/flarum .

等待安装完成。如遇报错，请根据错误信息排查。

（可选）解决依赖问题
若安装过程中报错提示“缺少 ZIP 扩展”或“缺少 Git 命令”，说明 Docker 容器内缺少必要组件。解决方法如下：

进入容器：从终端信息或 Docker 容器列表找到您的 PHP 环境容器 ID（形如www-data@1b908c14d923:/www$其中 1b908c14d923就是ID），然后执行：

docker exec -u 0 -it 你的容器ID /bin/bash
    # 或
docker exec -u root -it 你的容器ID /bin/bash

安装依赖：在容器内执行（适用于 Debian/Ubuntu 系）：

apt update
apt install git unzip -y
apt install php8.3-zip -y

安装完成后，输入 exit 退出容器，然后重新执行 composer create-project flarum/flarum .。

验证安装
安装完成后，在终端执行 ls 命令，确认目录下包含 vendor, flarum, storage 等 Flarum 核心文件和文件夹，即表示安装成功。

六、 网站配置

设置运行目录
进入“网站”，找到您的 Flarum 网站，点击“配置”->“网站目录”，将“运行目录”设置为 public，然后保存并重载。

引入 Nginx 配置
进入“网站”->“配置”->“配置文件”->“OpenResty”，在 } 前添加以下内容：

include /www/sites/你的主域名/index/.nginx.conf;

保存并重载。

七、 安装 SSL 证书（推荐）

进入“网站”->“证书”，配置或使用默认的 ACME 账户。

点击“申请证书”，填写域名，验证方式选择 HTTP，提交并等待签发成功。

回到“网站”列表，进入您的网站配置页，在“HTTPS”选项中启用 HTTPS，并选择刚申请到的证书。

八、 完成 Flarum 安装

在浏览器中访问您的域名，将出现 Flarum 的图形化安装界面。

数据库信息：填写第三步创建网站时记录的数据库连接地址（注意：1Panel 的 MySQL 地址通常为容器内地址，如 1Panel-mysql-XxXx，请在“数据库”->“连接信息”中查看“容器连接地址”）、数据库名、用户名和密码。

数据表前缀：可按需填写或留空。

填写无误后提交，Flarum 即安装完成。

九、 安装插件（以中文语言包为例）

进入“网站”->“运行环境”，打开对应 PHP 环境的终端，并进入网站目录：

cd /www/sites/你的主域名/index
composer require flarum-lang/chinese-simplified

此方法适用于安装任何其他 Flarum 插件。

花费数小时整理这份的实战经验！希望这份经过梳理的教程能帮助更多朋友顺利搭建自己的论坛。

附上演示：flarum.abrdns.com