Flarum是一款现代化的开源论坛系统，基于PHP开发，以MIT协议开源，完全免费商用。Flarum诞生于2010年（前身是esoTalk和FluxBB），以极简优雅的设计、流畅的用户体验、出色的性能著称。Flarum采用单页应用（SPA）架构，前后端分离，界面简洁现代，支持扩展机制，适合搭建技术社区、兴趣论坛、产品支持社区、小型讨论平台。
核心优势：界面现代优雅、响应式设计、性能出色、单页应用体验、Markdown支持、扩展机制丰富、SEO友好、REST API、完全免费商用、国际化支持。Flarum是新一代论坛系统的代表，特别适合追求现代感和用户体验的社区。
环境要求
- Web服务器：Nginx / Apache
- PHP版本：PHP 8.1 ~ 8.3（Flarum 2.x推荐PHP 8.2+）
- 数据库：MySQL 5.7+ / MariaDB 10.2+
- 内存：最低512MB，推荐1GB以上
- 磁盘：至少500MB可用空间
- PHP扩展：pdo_mysql、gd、curl、mbstring、json、xml、zip、opcache、fileinfo
- Composer：必须，用于安装和管理扩展
安装教程
步骤1：安装Composer
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"
composer --version步骤2：使用Composer创建Flarum项目
cd /www/wwwroot
composer create-project flarum/flarum yourdomain.com
cd yourdomain.comFlarum的网站根目录为public目录。
步骤3：创建数据库
mysql -u root -p
CREATE DATABASE flarum DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'flarum_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON flarum.* TO 'flarum_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;步骤4：配置文件权限
chown -R www:www /www/wwwroot/yourdomain.com
chmod -R 755 /www/wwwroot/yourdomain.com
chmod -R 777 /www/wwwroot/yourdomain.com/public/assets
chmod -R 777 /www/wwwroot/yourdomain.com/storage步骤5：Nginx配置
server {
listen 80;
server_name yourdomain.com www.yourdomain.com;
root /www/wwwroot/yourdomain.com/public;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/tmp/php-cgi-82.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_read_timeout 300;
}
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
location ~ /\.ht {
deny all;
}
}
步骤6：运行安装向导
浏览器访问 http://yourdomain.com，进入安装页面：
- 填写数据库配置：
- MySQL Host：localhost
- MySQL Database：flarum
- MySQL Username：flarum_user
- MySQL Password：你的密码
- Table Prefix：flarum_（默认即可）
- 填写管理员信息：
- 管理员用户名：admin
- 管理员邮箱：你的邮箱
- 管理员密码：设置强密码
- 确认密码：再次输入
- 填写论坛基础信息：
- 论坛标题：你的论坛名称
- 论坛描述：简短描述
- 点击”安装Flarum”，等待安装完成
步骤7：登录后台
安装完成后，使用管理员账号登录。Flarum后台地址为 http://yourdomain.com/admin。后台功能包括：基础设置、外观设置、邮件设置、权限管理、扩展管理、标签管理等。
Windows环境安装（phpStudy集成环境）
对于Windows用户，推荐使用phpStudy或XAMPP集成环境快速搭建：
- 下载安装phpStudy（https://www.xp.cn）或XAMPP（https://www.apachefriends.org）
- 启动集成环境，开启Apache/Nginx和MySQL服务
- 将程序源码解压到网站根目录（phpStudy默认是WWW目录，XAMPP默认是htdocs目录）
- 打开phpMyAdmin创建数据库（访问http://localhost/phpmyadmin）
- 浏览器访问http://localhost，按照安装向导完成安装
注意：Windows环境仅推荐用于本地开发和测试，生产环境建议使用Linux服务器。
宝塔面板安装（推荐）
宝塔面板是国内最流行的服务器管理面板，支持一键部署PHP环境和网站：
- 安装宝塔面板：CentOS执行
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh，Ubuntu/Debian执行wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh - 安装完成后，登录宝塔面板（地址和账号密码在安装完成后显示）
- 首次登录提示安装LNMP/LAMP环境，选择Nginx + MySQL + PHP，点击一键安装
- 点击”网站” → “添加站点”，填写域名、选择PHP版本、创建数据库
- 将程序源码上传到网站根目录（/www/wwwroot/你的域名）
- 设置目录权限：在文件管理器中选中网站目录，权限设置为755，所有者为www
- 浏览器访问域名，按照安装向导完成安装
宝塔面板优势：可视化操作、一键环境配置、方便管理数据库和文件、内置SSL证书部署、适合新手和非技术用户。
服务器配置建议
- PHP内存限制：
memory_limit = 256M - 上传文件大小：
upload_max_filesize = 32M，post_max_size = 32M - 最大执行时间：
max_execution_time = 120 - 启用OPcache，设置
opcache.memory_consumption=128 - 配置Redis缓存（需安装Redis扩展和对应Flarum扩展）
- 配置邮件服务（SMTP）用于通知和注册验证
- 定期使用
composer update更新Flarum核心和扩展 - 定期备份数据库和storage目录
- 生产环境关闭调试模式（config.php中debug=false）
常见问题
Q：安装时提示”storage目录不可写”？
A：执行chmod -R 777 storage public/assets，确保目录所有者为www用户。
Q：访问网站显示500错误？
A：检查PHP版本是否符合要求（需要PHP 8.1+），检查storage/logs目录下的错误日志，确认所有必需PHP扩展已安装。
Q：如何安装Flarum扩展？
A：在项目根目录执行：composer require 扩展包名，然后在后台扩展管理中启用。
Q：忘记管理员密码怎么办？
A：在项目根目录执行：php flarum reset-password admin，按提示输入新密码。
Q：Flarum和Discuz怎么选？
A：追求现代界面、轻量快速、用户体验选Flarum；需要功能全面、插件丰富、中文生态选Discuz。技术社区和小型论坛推荐Flarum，大型综合社区推荐Discuz。
官方网址
官方网站：https://flarum.org
下载地址：https://flarum.org/download