零基础也能搭建！宝塔面板安装 Flarum 论坛保姆级教程
markdown
### **零基础也能搭建！宝塔面板安装 Flarum 论坛保姆级教程**
你好，未来的站长！是不是也想拥有一个属于自己的、看起来非常现代化、运行速度飞快的论坛？Flarum 就是一个绝佳的选择。它轻量、优雅，而且扩展性强。
很多新手朋友可能会被复杂的服务器命令吓到，但别担心，我们今天的主角——**宝TA（宝塔）面板**——能让这个过程变得像点几下鼠标一样简单。
这篇教程会手把手带你完成每一步，从环境准备到安装成功，即使你对代码一无所知，也能顺利搭建起你的 Flarum 论坛。
#### **第一步：准备工作（打好地基）**
在开始之前，你需要准备好：
1. **一台云服务器**：已经安装好了宝塔面板。
2. **一个域名**：并解析到你的服务器 IP 地址。
3. **耐心**：跟着步骤一步步来，一定能成功。
##### **1.1 新建网站和数据库**
首先，我们需要为 Flarum 创建一个“家”。
1. 登录你的宝塔面板。
2. 在左侧菜单栏点击 **网站** -> **添加站点**。
3. **填写信息**：
* **域名**：输入你准备好的域名，比如 `bbs.yourdomain.com`。
* **数据库**：选择 **MySQL**，宝塔会自动为你创建一个同名的数据库和用户，**请务必把这里的数据库名、用户名和密码复制保存下来**，稍后安装时会用到！
* **PHP版本**：建议选择 **PHP 7.4** 或 **PHP 8.0**，兼容性最好。
4. 点击 **提交**。
!宝塔面板添加站点 [1](https://img.qichiyu.com/wp-content/uploads/2021/08/20210813_6116347321e17.png)
##### **1.2 配置 PHP 环境**
Flarum 的运行需要 PHP 开启一些特定的“能力”（扩展）。
1. 在宝塔面板左侧菜单，点击 **软件商店**。
2. 找到你刚才网站选择的那个 PHP 版本（比如 PHP-7.4），点击右侧的 **设置**。
3. 在弹出的窗口中，选择 **安装扩展**，并安装以下三个扩展：
* `fileinfo` （文件信息扩展，用于识别上传文件的类型）
* `opcache` （性能缓存扩展，能让你的论坛跑得更快）
* `exif` （图片信息读取扩展）
4. 接着，切换到 **禁用函数** 标签页。在这里，我们需要“解禁”两个函数。找到 `putenv` 和 `proc_open`，点击右侧的 **删除**，把它们从禁用列表中移除。这是因为后续的安装工具 Composer 需要用到它们。
!解除函数禁用 [2](https://img.qichiyu.com/wp-content/uploads/2021/08/20210813_6116353d71927.png)
#### **第二步：核心安装（请神入庙）**
环境准备就绪，现在我们要请出 Flarum 的安装“神器”—— **Composer**。
你可以把 Composer 理解成一个 PHP 的应用商店，我们通过它来下载和安装 Flarum。
##### **2.1 安装 Composer**
1. 回到宝塔面板的 **文件** 菜单，进入你刚刚创建的网站根目录，比如 `/www/wwwroot/bbs.yourdomain.com`。
2. 点击右上角的 **终端** 按钮，打开一个命令行窗口。
!宝塔终端 [3](https://img.qichiyu.com/wp-content/uploads/2021/08/20210813_61163628e932b.png)
3. 在终端里，依次执行以下两条命令来安装 Composer。
```bash
# 下载 Composer 安装脚本
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
# 执行安装脚本
php composer-setup.php
```
执行完毕后，你会看到目录下多了一个 `composer.phar` 文件，这就是 Composer 的主程序。
##### **2.2 使用 Composer 安装 Flarum**
现在，我们用 Composer 来下载 Flarum 的所有文件。
1. **重要**：在下载之前，先用 `rm -f index.html` 命令删除宝塔自动生成的 `index.html` 欢迎页，确保目录是干净的。
2. 在终端里执行以下命令。注意，命令最后有一个点 `.`，表示在当前目录下安装。
```bash
# 使用 composer.phar 创建一个 flarum 项目
php composer.phar create-project flarum/flarum .
```
3. **耐心等待**：这个过程会从国外服务器下载文件，根据你的服务器网络情况，可能需要 5-15 分钟，请耐心等待，直到命令执行完成。
##### **2.3 设置文件权限**
下载完成后，为了避免网站出现“没有权限”的错误，我们需要把所有文件的所有者都设置为网站的运行用户（通常是 `www`）。
在终端里执行以下命令：
```bash
# 将当前目录下所有文件的所有者和所属组更改为 www
chown -R www:www .
```
#### **第三步：最后配置（装修门面）**
Flarum 的程序文件已经就位，但我们还需要告诉服务器如何正确地展示它。
##### **3.1 设置网站运行目录**
出于安全考虑，Flarum 的公开访问文件都放在 `public` 目录下。我们需要告诉 Nginx，网站的入口在这里。
1. 回到宝塔面板的 **网站** 菜单，找到你的网站，点击右侧的 **设置**。
2. 在弹出的窗口中，选择 **网站目录**。
3. 将 **运行目录** 设置为 `/public`。
4. 点击 **保存**。
!设置运行目录 [4](https://img.qichiyu.com/wp-content/uploads/2021/08/20210813_61163b4f6cfc7.png)
##### **3.2 配置伪静态**
伪静态可以让你的论坛 URL 更好看（例如 `https://bbs.yourdomain.com/d/123` 而不是 `.../index.php?/...`）。
1. 在刚才的网站设置窗口中，选择 **伪静态**。
2. 将输入框里原有的内容全部删除，然后粘贴以下代码：
```nginx
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location /api {
try_files $uri $uri/ /api.php?$query_string;
}
location /admin {
try_files $uri $uri/ /admin.php?$query_string;
}
location ~* \.php$ {
fastcgi_pass unix:/tmp/php-cgi-74.sock; #注意：这里的74要和你使用的PHP版本一致
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
location ~* \.(css|js|gif|jpg|jpeg|png|bmp|swf|ico|svg|woff|woff2|ttf|eot)$ {
expires 1M;
access_log off;
}
location ~ /\. {
deny all;
}
```
3. **请注意检查**：上述代码中 `fastcgi_pass` 一行的 `php-cgi-74.sock`，数字 `74` 必须和你网站使用的 PHP 版本一致（比如你用 PHP 8.0，就改成 `php-cgi-80.sock`）。
4. 点击 **保存**。
#### **第四步：大功告成（开门营业）**
恭喜你！所有后台的准备工作都已完成。现在，是见证奇迹的时刻。
1. 在浏览器中访问你的域名 `http://bbs.yourdomain.com`。
2. 你会看到 Flarum 的安装向导界面。
3. **填写信息**：
* **Forum Title**：你的论坛名称。
* **MySQL Host**：`localhost` (保持默认)
* **MySQL Database**：填写你在 **1.1 步骤** 中保存的 **数据库名**。
* **MySQL Username**：填写 **用户名**。
* **MySQL Password**：填写 **密码**。
* **Administrator Credentials**：设置你自己的管理员账号、邮箱和密码。
4. 点击 **Install Flarum**。
稍等片刻，安装成功后页面会自动刷新，你将看到一个崭新、漂亮的 Flarum 论坛！
#### **附：安装中文语言包**
默认的 Flarum 是英文的，我们可以通过 Composer 轻松安装中文语言包。
1. 再次进入宝塔面板的 **文件** -> **网站根目录** -> **终端**。
2. 执行以下命令：
```bash
# 使用 composer 下载中文语言包
php composer.phar require flarum-lang/chinese-simplified
```
3. 等待下载完成。
4. 用你的管理员账号登录 Flarum 论坛后台，在 **Extensions** 页面找到 `Simplified Chinese`，勾选启用它。
5. 刷新一下，你的论坛就变成中文的啦！
---
希望这篇超详细的教程能帮助你顺利完成安装。享受创造和运营你的社区带来的乐趣吧！
0 评论