在 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
评论1
从零到精通：我如何用几天时间“磨”透了Flarum安装，并写下了你可能正需要的新教程 - 小舅子Blog
[...]还记得几天前，当我接到要为一个英文论坛搭建平台的任务时，我信心满满。在众多开源论坛系统中，轻量、优雅的Flarum一下子抓住了我的心。然而，我万万没想到，接下来的旅程，会是一场与“过时信息”的搏斗，以及一次通往“熟练工”的硬核修炼。第一步：满怀希望，却撞上“教程的时空陷阱”和所有开发者一样，我的第一步是搜索。谷歌、百度、技术博客……我翻遍了能找到的所有“Flarum完整安装教程”。但很快，我就发现[...]