Flarum 安装指南关键词：Flarum 安装, Flarum 安装教程, Flarum 安装指南, Flarum 中文教程, Flarum 中文指南主要内容：服务器环境要求，安装命令，运行目录，文件夹权限设置，创建数据库，URL 重写规则（Apache/Nginx/Caddy），Composer 源，自定义路径，注册邮件设置，扩展插件，面板安装等 💡 全文编排解释: Yannis & Triangle - 2021/10/10 Flarum 1.0 正式版已发布，经过 6 年的洗礼，测试版结束了其任务。请不要在生产中使用 Flarum Beta ，除非你知道你正在做什么以及有能力修复漏洞。如果您发现 Flarum 存在安全漏洞，请发送邮件至官方邮件 security@flarum.org 进行反应。 ❌ 安装前或提问前请仔细阅读指南或在 FAQ 和求助分类下查找类似案例，并了解《提问的智慧》精读注解版。 ⭕ 迫不得已，请在求助分类中提问能更快得到帮助。如果您发现指南中存在语法错误或者漏洞，请及时指出，感谢以下朋友们指出错误或提及建议，或许有其他伙伴未能在这里出现，请留言告诉我： @Dikkoo 、 @undo 、 @自媒体酷、@没胡子的猫环境配置 Composer 安装与支持重要提示：在安装之前，请务必检查服务器是否满足以下要求 1. Composer 安装与支持 Flarum 需要基于 Composer 容器，这在后续的升级和安装扩展等内容上至关重要，请务必在安装之前对服务器或其提供商进行调查，是否支持 Composer 依赖项，截至 2020 年 10 月 24 号，Composer 已从 v1 版本更新迭代至 v2 ! 🔦 相关链接： Composer | Composer 中文文档 | Composer 中文网 1.1 我如何判断服务器安装了 Composer composer -v if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 查看 Composer 版本命令如果以上命令不能运行，则需要你手动安装或者通过面板自动化进行安装。 1.2 我能否使用 zip/rar 的形式安装 🧁 注意：安装与管理 Flarum 的唯一官方支持方式是通过 Composer 不能。过去，社区框架往往通过用户自行下载并上传的形式来安装管理，这虽然看起来简单，却无法及时有效对代码更新迭代，甚至在多站点管理，自动部署以及测试等方面上造成不必要的麻烦和未知冲突。所以，使用 Composer 可以更好的处理所有这些问题。 1.3 我的共享主机不支持 SSH 怎么办大多数共享主机都会提供 SSH 访问权限，如果服务商屏蔽了，请及时和他们联系并说明情况。如果不支持，请及时切换服务商！服务器推荐要求配置 2. 服务器推荐要求配置如果服务器不满足要求，Flarum 可能无法安装且正常运行。 SSH 命令功能 Apache 或 Nginx 功能 PHP 7.3 版本以上数据库 MySQL 5.6 版本以上或 MariaDB 10.0.5 版本以上 2.1 PHP 功能支持及函数解禁 2.1.1 PHP 必要功能 fileinfo、exif 根据你的社区后续功能拓展，可能会需要用到除上方外其他的 PHP 功能扩展 curl, dom, gd, json, mbstring, openssl, pdo_mysql, tokenizer, zip 2.1.2 PHP 必要函数 putenv、proc_open 运行命令时，请额外注意错误提示，是否有其他依赖函数未解禁，经典函数未解禁案例： Installing flarum/flarum (v1.0.0): Downloading (100%) The Process class relies on proc_open, which is not available on your PHP in stallation. 安装清空指定目录提示：进行安装之前，请确保已阅读上方有关配置的内容。 3. 清空指定目录清空指定目录来安装 Flarum 程序，其中包含目录下的隐藏项，运行 rm 命令务必注意，反复确认其在指定目录下运行，否则特别危险和致命！！！ 3.1 删除命令部分详解命令功能作用 -f 强制删除 -r 递归，删除指定目录下内容并包含其子目录及文件 * 所有文件 /* 目录下的所有文件 /.* 目录下的所有隐藏文件 Flarum 安装命令 4. 使用 Composer 命令安装 composer create-project flarum/flarum . if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 调整 Webroot 及文件权限 5. 调整 Webroot 及文件权限 5.1 调整 Webroot 运行目录确认 Webroot 运行目录为 /public 文件夹 Apache 配置中目录定向到 /public <Directory "/<Flarum 路径>/public"> AllowOverride All </Directory> if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } Nginx 全站配置中 root 目录定向到 /public ...... root /www/wwwroot/xxx.com/public; if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 可以根据实际修改路径 /www/wwwroot/xxx.com 5.2 文件权限 ⛔ 请勿将任何文件权限设置为 777 ，该权限允许任何人随意访问文件内容，严重威胁安全。调整 public 、 storage 、 vendor 文件夹以及子目录下所有文件权限为 755 ，且所有者为 www 组别。默认下，文件均为 root 权限，当外网访问时，www-data 用户组别无权限查看，故需用 chown 更改文件夹权限组。 chown -R www-data:www-data /www/wwwroot/xxx.com if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 可以根据实际修改路径 /www/wwwroot/xxx.com chmod -R 755 /www/wwwroot/xxx.com/public if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 可以根据实际修改路径 /www/wwwroot/xxx.com 755 权限对 /public、/storage、/vendor 文件夹及子目录下所有文件数据库 6. 数据库 6.1 登陆 MySQL mysql -u root -p if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 若出现错误，请善于搜索和学习后再进行提问 6.2 创建数据库 create database 数据库名 character set utf8mb4 collate utf8mb4_unicode_ci; if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 为什么使用 utf8mb4 而不是 utf8 ，因为，utf8是一个有限版本，只适用于部分字符，不适用于表情符号。后来便有了 utf8mb4，但 MySQL 必须保持向后兼容，所以这就是为什么添加了一个新的编码而不是修复旧的。所以，这里建议所有新的数据库都应该使用 utf8mb4 编码。完成安装，请重启服务器 7. 完成安装后，请重启服务器 Apache/Nginx Apache 提示：如果完成后并没有生效，记得重启你的 Apache/Nginx ！ Apache 请确认服务器启用 mod_rewrite 模块或 .htaccess ，否则将无法正常运行。 /pubilc 目录下存在 .htaccess 文件，此文件包含了需要用到的定向规则。在配置中加入以下内容启用定向，将运行目录设置为 /public 。 <Directory "/<Flarum 路径>/public"> AllowOverride All </Directory> if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } Nginx Nginx 安装目录下存在 .nginx.conf 文件，只需将该文件包括在全站重定向配置中即可，使用 include 包含该文件即可： include /www/wwwroot/xxx.com/.nginx.conf; if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 可以根据实际修改目录路径 /www/wwwroot/xxx.com 由于某些服务商不支持，可以将 .nginx.conf 文件内容复制并插入到全站配置中，注意，这里不是全覆盖，而是在最后插入 .nginx.conf 文件中的定向内容： .nginx.conf # Pass requests that don't refer directly to files in the filesystem to index.php location / { try_files $uri $uri/ /index.php?$query_string; } # Uncomment the following lines if you are not using a `public` directory # to prevent sensitive resources from being exposed. # location ~* ^/(\.git|composer\.(json|lock)|auth\.json|config\.php|flarum|storage|vendor) { # deny all; # return 404; # } # The following directives are based on best practices from H5BP Nginx Server Configs # https://github.com/h5bp/server-configs-nginx # Expire rules for static content location ~* \.(?:manifest|appcache|html?|xml|json)$ { add_header Cache-Control "max-age=0"; } location ~* \.(?:rss|atom)$ { add_header Cache-Control "max-age=3600"; } location ~* \.(?:jpg|jpeg|gif|png|ico|cur|gz|svg|mp4|ogg|ogv|webm|htc)$ { add_header Cache-Control "max-age=2592000"; access_log off; } location ~* \.(?:css|js)$ { add_header Cache-Control "max-age=31536000"; access_log off; } location ~* \.(?:ttf|ttc|otf|eot|woff|woff2)$ { add_header Cache-Control "max-age=2592000"; access_log off; } # Gzip compression gzip on; gzip_comp_level 5; gzip_min_length 256; gzip_proxied any; gzip_vary on; gzip_types application/atom+xml application/javascript application/json application/ld+json application/manifest+json application/rss+xml application/vnd.geo+json application/vnd.ms-fontobject application/x-font-ttf application/x-web-app-manifest+json application/xhtml+xml application/xml font/opentype image/bmp image/svg+xml image/x-icon text/cache-manifest text/css text/plain text/vcard text/vnd.rim.location.xloc text/vtt text/x-component text/x-cross-domain-policy; if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 其他扩展插件请在扩展分类中寻找：中文社区 | 英文社区或者在非官方的 Extensions 扩展数据库页面中搜寻。安装扩展与 Flarum 一样，扩展是使用 SSH 通过 Composer 安装的。要安装一个典型的扩展： cd 到 composer.json 所在文件夹。运行 composer require COMPOSER_包名具体安装命令一般可在扩展的文档中找到。卸载 composer remove COMPOSER_包名管理扩展后台管理面板的「扩展」页面提供了一种在安装后便捷管理扩展程序的途径。您可以：启用或禁用一个扩展访问扩展设置（有些扩展会在主侧边栏添加标签页进行设置）。回滚一个扩展的迁移，以删除它所做的任何数据库修改（这可以通过卸载按钮来完成）。这将删除与该扩展相关的所有数据，并且是不可逆的。只有当你要删除一个扩展程序，并且不打算再次安装它时，才应该这样做。当然这不是非要做的事情，选择权在您手中。面板安装宝塔 Linux 面板安装 Flarum： https://discuss.flarum.org.cn/d/2195 / 由 @itnt 提供 Linux OneinStake 安装： https://ryanc.cc/archives/flarum-install-and-config / 由 @Ryanc 提供 Composer 源切换 (一般使用默认源) 默认源有时候会出现安装等待时间过长等问题，可切换至国内源，这里以阿里举例：全局切换阿里源： composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 全局取消配置： composer config -g --unset repos.packagist if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 自定义路径默认情况下 Flarum 的目录结构，包含公开访问的文件 public 目录。这是最好最安全的，确保所有敏感的源代码文件无法从网站根目录完全访问。但, 如果你希望将 Flarum 安装在一个子目录中（例如你的网站.com/forum ），或者如果你的主机不让你安装在自己的网站根目录下 (受制于 public_html 或 htdocs 之类的东西），则可以进行设置没有 public 目录的 Flarum。只需将 public 目录（包括 .htaccess ）中的所有文件移动到你要安装 Flarum 的目录中。然后编辑 .htaccess 并取消注释第 9 ~ 14 行用来保护敏感资源的 Code 。最后，编辑 index.php 和 Flarum 可执行文件，并更新以下行中的路径以反映你的新目录结构： require 'vendor/autoload.php'; if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 'base' => __自定义__, 'public' => __自定义__, 'storage' => __自定义__.'/storage', if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 注册邮件设置每个社区都需要发送电子邮件给用户，用来激活账户、重置密码、接收通知以及与其他用户通讯交流。作为论坛管理员，您首先要做的几件事之一就是配置好论坛的邮件服务！配置错误的话，用户在注册时会收到报错。支持的邮件驱动 Flarum 默认提供以下所列驱动，若有需要，开发者可自行开发插件添加自定义邮件驱动。 SMTP 这是最常用的邮件驱动，需要您配置主机地址、端口、加密方式、用户名和密码，以使用外部 SMTP 服务。请注意，加密方式必须为小写的 ssl 或 tls 。 Mail mail 会用到许多托管服务器上都有的 sendmail / postfix 邮件系统。您必须在服务器上正确安装并配置好 sendmail 才能正常工作。 Mailgun 通过您的 Mailgun 来发送邮件。您需要填写 secret key，以及您在 Mailgun 配置的域名、区域。 Log 日志模式下不会有任何邮件被发出，该模式多在开发者调试时使用，在这个模式下，任何邮件内容都会被写入日志中（日志路径： Flarum根目录/storage/logs ）。测试邮件在您保存邮件配置后，您可以在后台管理面板的邮件配置页面点击「发送测试邮件」发送一封邮件以检测您的配置是否可用。如果提示错误，或者您没有收到测试邮件，那就意味着配置有误，请检查配置然后重试。如果没有任何报错，邮件也发送出去了，但是您在收件箱中找不到测试邮件，请去垃圾箱看看，它很可能在那边。若你的邮件设置全部正确，但是无法发送邮件或出现无法注册错误，请重新检查邮箱的用户名和密码是否正确，或切换邮箱服务商重试，推荐163邮箱或其他域名邮箱相关链接： 163 FAQ

关键词：Flarum 安装, Flarum 安装教程, Flarum 中文教程, Flarum 中文指南主要内容：服务器环境要求，在线安装命令，Composer 国内源设置，URL 重写规则（Apache/Nginx/Caddy），文件夹权限设置，自定义路径，注册邮件设置，插件问题（中文语言包） 💡 全文编排和翻译解释: Yannis & Triangle Flarum 是 Beta 版软件，这意味着它仍具有一些不完整的功能和 BUG，并且可能会在特定时刻崩坏 💥 Beta 是利于解决问题和改进 Flarum 的。请不要在生产中使用 Flarum，除非你知道你正在做什么。如果情况不好，我们不能支援你。升级到后续版本是可能的，但可能会弄脏你的手。 ❌ 安装前或提问前请仔细阅读全文或在相关 FAQ 和分类下查找类似案例，并了解《提问的智慧》精读注解版。 ⭕ 在求助分类中提问能更快得到帮助。| 官方中文安装文档 ♻ 安装后请完全重启一次服务器和清除一次缓存！！服务器环境要求在你安装 Flarum 之前，请检查你的服务器是否符合以下的要求，以便顺利的安装和运行：服务器： Apache (需支持重写 Rewire 功能) 或者 Nginx , 内存≥1G (推荐；若内存溢出或不足请查看FAQ) 数据库： MySQL 5.6+ 或者 MariaDB 10.0.5+ 可支持 SSH (命令行) 并运行 Composer PHP 7.3+ ，需开启PHP扩展：curl, dom, gd, json, mbstring, openssl, pdo_mysql, tokenizer, zip 现阶段，暂不能通过下载 ZIP 压缩包并将其上传至网络端服务器来安装 Flarum 。这是因为 Flarum 使用了一个叫做 Composer (opens new window)的依赖管理系统，它需要在该命令上安装并运行 Flarum。这并不意味着你需要一个 VPS。某些共享主机会给予你 SSH 访问权限，这样你就能够安装 Composer 和 Flarum 了。对于其他不开放 SSH 权限的主机，你可以尝试 Pockethold 等变通方法。若你的主机环境已搭配安装好 Composer，既可以主动运行，不需要另外再单独安装 Composer 。 composer (运行composer命令) if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 在线安装 Flarum 使用 Composer 来管理它的目录和扩展. 在安装 Flarum 之前，你需要安装 Composer 在你的主机上。然后，在你需要安装 Flarum 的位置目录下运行此命令，在这之前：安装目录需为空，包含隐藏项 (善用 rm 命令) 解禁 PHP 中的 putenv、proc_open 函数安装 PHP 所需扩展 fileinfo、exif 如何安装 Flarum 指定版本？ * composer create-project flarum/flarum . if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 你可在运行命令的同时，配置 Web 服务器。需确保你的 Flarum 网站运行目录 (Webroot) 为 /你的Flarum路径/public ，然后按照下方说明设置 URL Rewrite。一切准备就绪后，刷新并访问你的网络地址，填写信息完成安装。运行目录与权限调整* 再次提醒，需要设定你的运行目录为 /public 并且将目录下的 public 和 storage 文件夹 (包含子文件夹) 权限所有者从 root组提升为 www组 Flarum 基本目录结构* . Flarum 安装根目录 ├── public (公共目录) │ ├── assets (资源目录。存放头像、上传的文件等) │ └── .htaccess (自带 Apache 配置) │ ├── storage │ └── logs (日志) │ ├── vendor (核心、插件目录) ├── .nginx.conf (自带 Nginx 配置) ├── composer.json (Composer 配置文件) ├── extend.php (自定义扩展文件) ├── flarum ├── LICENSE ├── README.md └── site.php if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } URL 重写 ⛔ 403/404 通常是重写/运行目录设置不正确 Flarum 自带 .htaccess 或 .nginx.conf 文件，请将其规则包含到伪静态或重写中即可，非覆盖替换。请自行阅读下面的说明和重写正确后刷新页面，清除缓存后再次查看页面。 Apache Flarum 在 public 文件中包含一个 .htaccess 文件，此文件包含了需要用到的规则。如果你使用共享主机，请与你的提供商确认启用了 mod_rewrite 重写功能并允许使用 .htaccess 文件。如果你使用的是其他 web 服务器，你需要在配置文件中添加以下规则： <Directory "/你的Flarum路径/public"> AllowOverride All </Directory> if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } Nginx Flarum 根目录附带了一个 .nginx.conf 文件。假如你已经在 Nginx 中建立了一个 PHP 站点，应当在站点配置中添加以下内容，以导入 Flarum 默认的重写规则： include /你的Flarum路径/.nginx.conf; if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 某些服务器商或安装设置可能不全，可按照以下内容补全 `` location / { try_files $uri $uri/ /index.php?$query_string; } location /api { try_files $uri $uri/ /api.php?$query_string; } location /flarum { deny all; return 404; } location ~ .php$ { fastcgi_split_path_info ^(.+.php)(/.+)$; fastcgi_pass unix:/var/run/php5-fpm.sock; fastcgi_index index.php; include fastcgi_params; } if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } Caddy Caddy 的配置很简单。你需要将下方代码中的 URL 替换为自己的 URL，并将 path 替换为自己的 public 文件夹路径。如果你使用的是其他版本的 PHP，你还需要修改 fastcgi 路径，使其指向正确的 PHP 安装 Socket 或 URL 。 www.example.com { root * /var/www/flarum/public php_fastcgi unix//var/run/php/php7.4-fpm.sock header /assets { +Cache-Control "public, must-revalidate, proxy-revalidate" +Cache-Control "max-age=25000" Pragma "public" } file_server } if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 文件夹权限设置 ❌ 请勿将文件夹包含根目录设置为 777 ，这是非常危险的一件事情。任何用户或组都将允许访问文件内容，无法保证文件安全！若完成这些步骤，Flarum 需继续索要权限，则你可能需要检查你的文件是否正确的设置了组和用户所拥有的权限。因为，你的环境可能与所提供的文档有所不同，需要向你的Web服务器配置或 Web 提供商咨询有关 PHP 和 Web 服务器所使用的正确用户和组的信息。在大多数 Linux 和衍生系统中，默认情况下，www-data 是 PHP 和 Web 服务器下运行的组和用户。你可以通过运行 chown -R www-data:www-data 文件夹名/. 来更改大多数 Linux 操作系统中的文件夹所有权。 Composer 源* 若安装等待时间过长可切换源，具体视情况而定。全局切换阿里源： composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 全局取消配置： composer config -g --unset repos.packagist 自定义路径默认情况下 Flarum 的目录结构，包含公开访问的文件 public 目录。这是最好最安全的，确保所有敏感的源代码文件无法从网站根目录完全访问。但, 如果你希望将 Flarum 安装在一个子目录中（例如你的网站.com/forum ），或者如果你的主机不让你安装在自己的网站根目录下 (受制于 public_html 或 htdocs 之类的东西），则可以进行设置没有 public 目录的 Flarum。只需将 public 目录（包括 .htaccess ）中的所有文件移动到你要安装 Flarum 的目录中。然后编辑 .htaccess 并取消注释第 9 ~ 14 行用来保护敏感资源的 Code 。最后，编辑 index.php 和 Flarum 可执行文件，并更新以下行中的路径以反映你的新目录结构： require 'vendor/autoload.php'; if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 'base' => __自定义__, 'public' => __自定义__, 'storage' => __自定义__.'/storage', if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 注册邮件设置若你的邮件设置全部正确，但是无法发送邮件或出现无法注册错误，请重新检查邮箱的用户名和密码是否正确，或切换邮箱服务商重试，目前推荐163邮箱或域名邮箱使用相关插件进行注册邮件屏蔽(需前往Flarum官网社区进行获取)，既注册已激活状态，但不利于防范垃圾注册。使用正常邮件注册发送， SMTP 方式，推荐使用 163 FAQ /126 邮箱等或国外邮件商。既注册未激活状态，需邮件激活，利于防范垃圾注册。插件请在 Extensions 查看，或在英文官网 Extensions 查看目前推荐可用的插件均发文在 Extensions 分类中，更多插件介绍将会在不久的将来编写进该文档中。常用插件概览： "antoinefr/flarum-ext-bbcode-fa": 在帖子中插入 FA 图标, "antoinefr/flarum-ext-money": 发帖得金钱, "antoinefr/flarum-ext-online": 在线会员列表, "askvortsov/flarum-categories": 启用传统板块布局, "askvortsov/flarum-moderator-warnings": 向会员发送警告信息, "askvortsov/flarum-pwa": PWA 应用, "branchzero/flarum-ext-qqcaptcha": 腾讯防水墙, "clarkwinkelmann/flarum-ext-author-change": 变更作者, "clarkwinkelmann/flarum-ext-circle-groups": 头像圆环, "clarkwinkelmann/flarum-ext-comicsans": 彩虹文字, "clarkwinkelmann/flarum-ext-create-user-modal": 创建用户, "clarkwinkelmann/flarum-ext-emojionearea": Emoji 选择器, "clarkwinkelmann/flarum-ext-post-date": 发帖日期变更, "clarkwinkelmann/flarum-ext-who-read": 阅读进度, "clarkwinkelmann/post-license": 文章许可证, "csineneo/lang-traditional-chinese": 繁体中文语言包, "datitisev/flarum-ext-dashboard": 仪表板增强, "flagrow/ads": 广告插件, "flagrow/direct-links": 功能链接, "flagrow/flarum-ext-analytics": 谷歌统计, "flagrow/sitemap": 网站地图, "flarum/akismet": 垃圾留言过滤系统, "flarum/approval": 审核系统, "flarum/auth-facebook": 脸书登录, "flarum/auth-github": GitHub 登录, "flarum/auth-twitter": 推特登录, "flarum/bbcode": BBCode 基本, "flarum/emoji": Emoji 基本, "flarum/flags": 举报功能, "flarum/lang-english": 英语语言包, "flarum/likes": 点赞功能, "flarum/lock": 锁定功能, "flarum/markdown": Markdown 语法, "flarum/mentions": 提及功能, "flarum/pusher": Pusher 推送, "flarum/statistics": 后台统计图表, "flarum/sticky": 置顶功能, "flarum/subscriptions": 关注主题功能, "flarum/suspend": 封号功能, "flarum/tags": 分类标签, "flarumalshain/showlastpost": 首页信息流显示最新回复摘要, "fof/ban-ips": 拉黑 IP 地址, "fof/best-answer": 最佳回复, "fof/byobu": 私人讨论, "fof/default-user-preferences": 默认给用户开启某些设置, "fof/disposable-emails": 禁止一次性邮箱注册, "fof/drafts": 草稿功能, "fof/filter": 关键词过滤器, "fof/follow-tags": 关注标签, "fof/formatting": 文本、链接格式化, "fof/forum-statistics-widget": 前台统计挂件, "fof/geoip": 地理位置查询服务, "fof/github-autolink": GitHub 链接自动识别, "fof/linguist": 语言学家（自定义翻译）, "fof/links": 导航栏链接, "fof/merge-discussions": 合并主题, "fof/moderator-notes": 留言板, "fof/nightmode": 夜间模式, "fof/pages": 静态页面, "fof/polls": 投票功能, "fof/pretty-mail": 邮件模板, "fof/prevent-necrobumping": 防止挖坟, "fof/profile-image-crop": 头像裁剪, "fof/reactions": 反应心情, "fof/realtimedate": 实时时间, "fof/recaptcha": 谷歌验证码, "fof/share-social": 分享按钮, "fof/socialprofile": 社交链接, "fof/spamblock": 标记垃圾用户为破坏者, "fof/split": 拆分主题, "fof/stopforumspam": 防垃圾发帖人, "fof/subscribed": 增加通知项, "fof/terms": 社区条款, "fof/upload": 文件上传器, "fof/user-bio": 个性签名, "fof/user-directory": 前台会员名录, "fof/username-request": 更改用户名, "irony/flarum-ext-login2see": 登录后可见, "isaced/flarum-ext-email-verification-switch": 注册自动激活, "itnt/flarum-backtop": 返回顶部, "itnt/flarum-uitab": 手机端底部导航栏, "jjandxa/flarum-ext-chinese-search": 中文搜索（需安装 xunsearch） "kilowhat/flarum-ext-mailing": 群发邮件（不兼容后台用户列表插件）, "kvothe/pipetables": Markdown 表格, "kvothe/reply-to-see": 回复后可见, "kvothe/signup-button": 注册按钮, "lcinhk/flarum-ext-acgembed": ACG 媒体嵌入, "league/flysystem-aws-s3-v3": 亚马逊 S3 存储, "littlegolden/flarum-lang-japanese": 日语语言包, "littlegolden/flarum-lang-simplified-chinese": 简体中文语言包, "littlegolden/flarum-mybb": Steam 黑幕 + 外链标志, "michaelbelgium/flarum-discussion-views": 主题浏览量, "michaelbelgium/flarum-profile-views": 个人访客, "minr/flarum-ext-auth-weibo": 微博登录, "mskian/tasklist": BBCode 任务清单, "nomiscz/flarum-ext-auth-wechat": 微信登录, "oe800/flarum-ext-bbcode-alerts": BBCode 警告, "overtrue/flysystem-qiniu": 七牛存储, "reflar/cookie-consent": Cookie 横幅, "reflar/level-ranks": 经验值, "squeevee/flarum-ext-fancybox": 图片灯箱, "studosi/mail-filter": 邮箱过滤器, "tank/perspective": 歧视、恶毒评论过滤, "tank/polyfills": 旧浏览器兼容, "the-turk/flarum-diff": 编辑记录, "the-turk/flarum-edit-notifications": 编辑后通知, "the-turk/flarum-password-strength": 密码强度检测, "therealsujitk/flarum-ext-gifs": 动图选择器, "therealsujitk/flarum-ext-hljs": 更换代码高亮主题, "therealsujitk/flarum-ext-show-password": 显示密码, "v17development/flarum-seo": SEO 优化, "veroz1/users-list": 后台用户列表, "xelson/flarum-ext-chat": 实时聊天（需要 Pusher）, "zerosonesfun/bbbbcode": 大美 BBCode if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } Flarum 简体中文语言包 2020 FoF 文件上传器 - 智能处理文件上传的扩展程序，需 PHP 扩展 exif 支持 Fancybox wrapper - 更方便的查看图片更多：小白用户推荐：《宝塔 Linux 面板安装 Flarum》 https://iflarum.cn/d/2195 宝塔 Linux 面板安装 Flarum： https://itnt.xyz/it/11 / 由 @itnt 提供 Linux OneinStake 安装： https://ryanc.cc/archives/flarum-install-and-config / 由 @Ryanc 提供中文社区测试版升级至正式版经历： https://discuss.flarum.org.cn/d/2864 关于 Akismet 扩展与 PHP 8.0 不兼容的说明： https://discuss.flarum.org.cn/d/2863 FoF/Recaptcha 与 UsernameBlacklist 插件不兼容： https://discuss.flarum.org.cn/d/3376

yannis 真的是很棒的教程，我是跟着这个教程来的ww 也提个建议，yannis加上一下之前我遇到的那个vendor文件夹没有安装的问题吧，就是要检查安装时是否有报错，若有报错则请根据报错检查是否开启相关函数并确定安装了对应扩展。

Dikkoo 好的！晚些时候加上这些内容 😘 已知的扩展冲突-beta15 开启 FoF Secure HTTPS 插件会导致前台无法正常显示 Nicknames 插件开启后提示错误，请在开启情况下运行 php flarum cache:clear 命令，即可解决这个问题。

Flarum 真的是个宝藏社区！ 😍

BBcode-Font zerosonesfun/font 有几率会导致编辑器发帖时无法实时预览效果，需要修改文件注释掉一些内容。其实有些插件的开启顺序也是会出现玄学问题，即插件相克。这个时候只能一个个测试插件间的兼容性了

您好我想问一下，我安装了Flarum后同目录下的文件怎么访问？

你好,请问在环境centos7 1核1G下安装composer require littlegolden/flarum-lang-simplified-chinese 进程会被杀死,要怎么处理?

shenmadouyaowen 常见问题 > 内存不足

Golden 可以了,内存是够了,安装了其他东西,然后就不够了

Flarum 安装指南

Golden

混子朗内存过小，请看faq

Golden 常见问题 > 内存不足

混子朗

Golden 感谢大佬

v2ex

舔狗社区[ext] 欢迎来舔！！！

木呆桑

技术小白- -应该是遇到重定向问题了，无法将.nginx.conf路径添加到nginx
的conf文件中，然后后台和其他功能都无法正常打开，出现404，这个有没有更详细的教程可以参考？

yannis

木呆桑

有將關於後臺的重定向注解掉嗎？
或者，看看你的nginx？

木呆桑

yannis 感谢回复，是重定向的部分加错位置了，后来参考论坛里的教程设置好了，目前站点已基本正常，非常感谢！

eucliwood

Warning: require(/www/wwwroot/example.com/vendor/autoload.php): failed to open stream: No such file or directory in /www/wwwroot/example.com/site.php on line 22

Fatal error: require(): Failed opening required ‘/www/wwwroot/example.com/vendor/autoload.php’ (include_path=‘.:’) in /www/wwwroot/example.com/site.php on line 22
在设置完毕访问论坛，发生这种问题，怎么解决？请楼主大佬帮帮忙

yannis

eucliwood
https://discuss.flarum.org.cn/d/325 请查看FAQ中相同的问题

自媒体酷

建议把「Flarum 中文安装指南」改成「安装 Flarum 的中文指南」，因为原标题语法错误。（不过话又说回来了，既然是中文论坛没必要特意加中文二字，直接写「Flarum 安装指南」就行了。没人会介绍自己，你好我是男性张三。）

这标题我看上去以为是安装中文语言包或让 Flarum 支持中文环境使用习惯的方法。

lovingyk

安装运行,并且创建好数据库之后运行站点,mysql80服务被强行关闭了,是什么回事?

Taleling

QNAP怎么通过Web服务器安装呢？很多功能不能直接配置。只能修改php.ini

14569

yannis 注意：安装与管理 Flarum 的唯一官方支持方式是通过 Composer

不，现在不是了，zip 安装包已上线，还支持一键更新。

yannis

14569 okk，有时间我更新一下，谢谢提醒

« 上一页