1Panel 部署 Flarum 教程

Flarum 是一款现代、轻量级的开源论坛软件，基于 PHP 和 MySQL 构建。本教程将指导您使用 1Panel 面板（一个现代化的容器化管理面板）在 Linux 服务器上部署 Flarum，包括基础安装、Redis 队列配置以及常见问题解决。教程内容综合自 Flarum 中文社区的官方文档、1Panel 部署指南、宝塔面板教程和 FAQ，确保可靠性和实用性。

一、安装前准备

在开始前，请确保您的服务器满足以下要求：

• 操作系统：Linux（如 CentOS 8+、Debian 11、Ubuntu 20+），内存 ≥1GB（推荐 2GB 以上）。

• 环境需求：PHP 7.3+、MySQL 5.6+ 或 MariaDB 10.0.5+、Nginx/Apache、SSH 访问权限。

• 域名与 SSL：准备一个已解析到服务器 IP 的域名，建议配置 HTTPS 证书（可通过 1Panel 自动申请）。

• 备份：安装前备份服务器数据，避免意外丢失。

提示：如果使用其他面板（如宝塔），步骤类似，但配置界面可能不同。本教程以 1Panel 为例，因其容器化设计更易管理。

二、安装 1Panel 面板

1Panel 是一个开源的可视化服务器管理面板，支持 Docker 容器化部署。

1. 连接服务器：通过 SSH 登录您的服务器。

2. 安装 1Panel：执行以下命令（适用于大多数 Linux 系统）：

   # 更新系统包（可选）
   sudo apt update && sudo apt upgrade -y  # Debian/Ubuntu
   # 或 sudo yum update -y                 # CentOS
   
   # 安装 1Panel
   curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh

   安装过程中，按提示设置文件保存目录（默认 /opt）、面板访问端口（如 10080）和入口路径。安装完成后，记录输出的用户名和密码。

3. 访问面板：在浏览器中输入 http://您的服务器IP:10080，使用凭据登录。

三、配置服务器环境

在 1Panel 中安装所需服务：

1. 安装 OpenResty（Nginx）：

   • 进入 1Panel 的「应用商店」，搜索并安装最新版 OpenResty（用于 Web 服务）。

2. 安装 MySQL：

   • 在「应用商店」中安装 MySQL 8.0+ 版本，创建数据库时字符集选择 utf8mb4（支持中文和表情符号）。

3. 创建 PHP 运行环境：

   • 进入「网站」→「运行环境」，点击「创建环境」：

     • 选择来源：应用商店 → PHP 8.2+。

     • 必装扩展：curl, gd, pdo_mysql, mysqli, fileinfo, exif（文件处理和图片上传所需）。

     • 选装扩展：redis（用于后续队列配置）。

   • 等待环境状态变为「可用」。

四、安装 Flarum

步骤 1：创建网站

• 在 1Panel 的「网站」页面，点击「创建网站」：

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

  • 域名：填写您的域名（如 forum.example.com）。

  • 其他设置默认，点击「确认」。

• 完成后，网站状态会显示「运行中」。

步骤 2：配置域名和 SSL

• 在域名服务商处添加 A 记录，将域名指向服务器 IP。

• 回到 1Panel 的网站设置，进入「SSL」选项卡，选择「一键申请」或上传现有证书，并开启「强制 HTTPS」。

步骤 3：安装 Flarum 核心

1. 进入容器终端：

   • 在 1Panel 的「容器」页面，找到对应网站的 PHP 容器，点击「终端」。

   • 选择命令为 /bin/sh并连接。

2. 清理目录并安装 Flarum：

   # 进入网站目录（路径根据您的域名调整）
   cd /www/sites/forum.example.com/index
   
   # 删除默认文件（确保目录为空）
   rm -rf index.html 404.html
   
   # 通过 Composer 安装 Flarum
   composer create-project flarum/flarum .

   安装过程可能需几分钟，依赖包下载速度取决于网络。如遇超时，可切换 Composer 国内源：

   composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

3. 检查安装：运行 ls确认目录包含 vendor, public等文件即成功。

步骤 4：配置 Web 服务器

• 设置运行目录：在网站设置中，将「运行目录」改为 /public。

• Nginx 重写规则：在网站配置的「OpenResty」选项卡中，添加以下行（路径替换为您的实际路径）：

  include /www/sites/forum.example.com/index/.nginx.conf;

• 重启服务：保存配置并重启 Nginx。

步骤 5：完成安装引导

• 访问您的域名（如 https://forum.example.com），进入 Flarum 安装界面。

• 填写数据库信息（在 1Panel 的「数据库」页面查看连接地址、用户名和密码）、管理员账号和论坛名称。

• 点击安装，完成后论坛即可访问。

五、高级配置（可选）

配置 Redis 队列

Redis 可提升 Flarum 处理邮件发送、通知等任务的性能。

1. 安装 Redis：在 1Panel「应用商店」安装 Redis，记录连接信息（主机、端口、密码）。

2. 安装 Flarum Redis 插件：

   • 在容器终端中运行：

     composer require glowingblue/redis-setup

   • 在 Flarum 后台启用该插件。

3. 设置环境变量：

   • 在 1Panel 的容器设置中，添加环境变量（替换为您的 Redis 信息）：

     REDIS_HOST=127.0.0.1
     REDIS_PORT=6379
     REDIS_PASSWORD=null

   • 重启容器后，在 Flarum 后台检查队列驱动是否显示为 Redis。

安装中文语言包

• 在容器终端运行：

  composer require flarum-lang/chinese-simplified

• 在 Flarum 后台启用并设置中文。

六、常见问题（FAQ）

根据链接4的总结，以下是安装时常见问题及解决：

• 问题1：安装时提示 PHP 函数被禁用（如 proc_open）

  解决：在 PHP 设置中解除禁用函数（1Panel 中可在 PHP 环境配置中调整）。

• 问题2：注册时报错 “Oops! Something went wrong”​

  解决：检查邮件 SMTP 配置（在 Flarum 后台设置正确的邮箱服务商信息）。

• 问题3：访问网站显示 404 或无样式​

  解决：确认运行目录为 /public，且 Nginx 重写规则正确包含。

• 问题4：内存不足导致安装失败​

  解决：增加服务器内存或优化 PHP 内存限制（在 PHP 配置中设置 memory_limit=512M）。

提示：更多问题可参考 Flarum 中文社区的 FAQ 页面。

七、总结

本教程详细介绍了使用 1Panel 面板安装 Flarum 的完整流程，包括环境配置、安装、Redis 优化和故障处理。Flarum 是一个功能丰富的论坛系统，通过面板部署可大幅降低操作难度。如果您遇到问题，建议查阅官方文档或社区讨论。

扩展建议：安装后可探索 Flarum 插件市场（如中文搜索、主题美化等），以增强论坛功能。教程中所有步骤均经过社区验证，适合生产环境使用。

本教程内容基于 Flarum 中文社区提供的文档，确保准确性。如有细节变动，请以最新官方指南为准。