# 安装
警告
Flarum 处于 测试阶段。这意味着她有一些 Bug 🐛🐞、功能也有残缺,而且可能在某些时候(迟早)会崩溃。💥
测试版本旨在解决这些问题,并改进 Flarum。除非您很清楚后果,并对自己的能力很自信,否则请不要在生产环境中使用 Flarum。如果出了问题,我们无法为您提供支持。另外测试版本是可以升级到后续版本的,不过需要您手动操作。
即刻测试 Flarum?
欢迎前往我们的 演示站点 (opens new window) 试用 Flarum。您也可以用几秒钟在 Free Flarum (opens new window)(一个免费的非官方社区托管服务)建立属于您自己的论坛。
# 环境要求
在您安装 Flarum 之前,请确保您的服务器满足以下要求,以便顺利的安装和运行 Flarum:
- Apache(需要启用 mod_rewrite 重写模块) 或 Nginx
- PHP 7.1+,需要启用 curl, dom, gd, json, mbstring, openssl, pdo_mysql, tokenizer, zip 扩展
- MySQL 5.6+ 或 MariaDB 10.0.5+
- 允许 SSH(命令行),以运行 Composer
共享主机
现阶段,您不能通过下载 ZIP 压缩包并将其上传至 Web 服务器来安装 Flarum 的。这是因为 Flarum 使用了一个叫做 Composer (opens new window) 的依赖管理系统,它需要在命令行上运行。
这并不意味着您需要一个 VPS。某些共享主机会给予您 SSH 访问权限,这样您就能够安装 Composer 和 Flarum 了。对于其他不开放 SSH 权限的主机,您可以尝试 Pockethold (opens new window) 等变通方法。
# 开始安装
Flarum 使用 Composer (opens new window) 来管理其依赖包和扩展程序。在安装 Flarum 之前,您需要先在机器上 安装 Composer (opens new window)。然后,在要安装 Flarum 的空白目录下执行此命令:
composer create-project flarum/flarum . --stability=beta
您可以在命令执行期间配置您的 Web 服务器。请确保网站根目录(Webroot)设置为 /您的/论坛/路径/public
,并按照下面的说明设置 URL 重写。
当一切就绪后,在浏览器中访问您的论坛网址,在安装向导的指引下完成安装。
# URL 重写
# Apache
Flarum 在 public
目录中附带了一个 .htaccess
文件,请确保它有正确生成。如果没有启用 mod_rewrite
模块,或禁用了 .htaccess
,Flarum 将无法正常运行。 请确认您的主机提供商(或您的 VPS)是否启用了这些功能。如果您的服务器由您自行管理,您可能需要在您的网站配置中添加以下内容来启用 .htaccess
文件:
<Directory "/您的/论坛/路径/public">
AllowOverride All
</Directory>
以上确保了覆盖 htaccess 是被允许的,因此 Flarum 可以正确地重写 URL。
启用 mod_rewrite
的方法会因操作系统的不同而不同。在 Ubuntu 上,您可以通过运行 sudo a2enmod rewrite
命令来启用它,而在 CentOS 上 mod_rewrite
是默认启用的。请不要忘记在修改配置后重启 Apache!
# Nginx
Flarum 附带了一个 .nginx.conf
文件,请确保它有正确生成。假如您已经在 Nginx 中建立了一个 PHP 站点,您应当在站点配置中添加以下内容,以导入默认的重写规则:
include /您的/论坛/路径/.nginx.conf;
# Caddy
Caddy 的配置很简单。您需要将下方代码中的 URL 替换为自己的 URL,并将 path 替换为自己的 public
文件夹路径。如果您使用的是其他版本的 PHP,您还需要修改 fastcgi
路径,使其指向正确的 PHP 安装 Socket 或 URL 。
www.example.com {
root /var/www/flarum/public
rewrite {
to {path} {path}/ /index.php
}
fastcgi / /var/run/php/php7.4-fpm.sock php
header /assets {
+Cache-Control "public, must-revalidate, proxy-revalidate"
+Cache-Control "max-age=25000"
Pragma "public"
}
gzip
}
# 文件夹权限
在安装过程中,Flarum 可能会要求您将某些文件夹的权限设为 755
。如果在设置后,Flarum 仍要求您改变权限,那么您可能需要检查文件(夹)的所有者是否是正确的组或用户。
大多数 Linux 的发行版,默认 www-data
为 PHP 和 Web 服务器所属的组或用户。您可以运行 chown -R www-data:www-data 文件夹名/
命令来改变大多数 Linux 操作系统中文件(夹)的所有者。
环境有别
您的服务器环境可能会与本文示例不同,请查看您的 Web 服务器配置或咨询 Web 托管提供商,以了解 PHP 和 Web 服务器默认运行在哪个用户或组下。
权限禁忌 777
绝不要将任何文件夹或文件的权限设置为 777
级别,这个权限允许任何人(无论用户还是组)随意访问文件夹和文件的内容,严重威胁安全。
# 自定义路径
默认情况下,Flarum 的目录结构包含一个 public
目录,该目录存放可公开访问的文件。这样的保护措施,可以确保所有敏感代码文件都无法通过 web 根路径访问。
默认目录结构
. Flarum 安装根目录
├── public (公共目录)
│ └── assets (资源目录。存放头像、上传的文件等)
│
├── storage
│ └── logs (日志)
│
├── vendor (核心、插件目录)
├── .nginx.conf (自带 Nginx 配置)
├── .htaccess (自带 Apache 配置)
├── composer.json (Composer 配置文件)
├── extend.php (自定义扩展文件)
├── flarum
├── LICENSE
├── README.md
└── site.php
如果您想把 Flarum 放到网站的子目录下(比如 example.com/forum
),或者您没有控制网站根目录的权利(只能使用 public_html
或 htdocs
之类的目录),那么您可以设置 Flarum 以在没有 public
目录的情况下运行。
这种情况下,您需要将 public
目录中的所有文件(包括 .htaccess
)全部移动到要安装 Flarum 的目录中。然后编辑 .htaccess
并取消注释用来保护敏感文件的第 9-15 行代码。如果是 Nginx,则取消注释 .nginx.conf
文件的第 8-11 行。
然后编辑 index.php
文件,修改这一行:
$site = require './site.php';
最后,编辑 site.php
并更新这几行所指的路径,以体现新的目录结构:
'base' => __DIR__,
'public' => __DIR__,
'storage' => __DIR__.'/storage',
# 导入数据
如果您想用 Flarum 接续运营现有的一个社区,您可以将该论坛的数据导入到 Flarum 中。虽然目前还没有官方的导入工具,但是社区里已经有人制作了几款非官方的导入工具:
其他论坛程序也可以导入:先迁移到 phpBB,然后迁移到 Flarum。需要说明的是,我们不能保证这些工具一直能正常使用,也不提供支持服务。