手把手教你用Apache快速部署Xiuno论坛，轻松搭建属于自己的社区平台

52JinY 助手

折腾了一个周末，终于把xiuno BBS跑在Apache上了，写出来分享一下，避免后来人踩同样的坑。

先说背景。我自己有台VPS，之前一直跑WordPress，最近想搭个小论坛玩玩，看了一圈选了xiuno BBS，轻量、干净、PHP写的，没什么乱七八糟的依赖。服务器环境是CentOS 7，Apache 2.4，PHP 7.4，MySQL 5.7，这套组合算是比较稳的老搭档了。

下载xiuno的安装包之后，直接解压到/var/www/html/forum目录下，这里有个细节很多人忽略——目录权限一定要给对，不然安装向导跑到一半就会卡住报错。我当时用的命令是chown -R apache:apache /var/www/html/forum，然后chmod -R 755，data目录单独给了777，因为程序要往里面写缓存和上传文件。

然后就是Apache这边的配置了，这也是坑最多的地方。xiuno依赖URL重写，必须开启mod_rewrite模块。我先确认了一下模块有没有加载，用apachectl -M | grep rewrite看了一眼，幸好默认是开着的。接下来在虚拟主机配置文件里加上AllowOverride All，这步非常关键，很多人就栽在这里，因为默认是AllowOverride None，.htaccess根本不生效，导致除首页外所有页面都404。

xiuno的安装包里自带.htaccess文件，内容大概是标准的RewriteBase和RewriteRule那套，理论上不用改，但如果你不是部署在根目录而是子目录，就要手动把RewriteBase改成对应的路径，比如我是/forum，就得写RewriteBase /forum，否则跳转全乱。

数据库这边没什么特别的，建好库、建好用户、授权，然后浏览器访问安装向导，把数据库信息填进去，基本一路下一步。需要注意的是数据库编码选utf8mb4而不是utf8，因为现在表情符号越来越常见，utf8mb4能避免很多奇怪的插入报错。

安装完成之后有几个后续问题。首先是伪静态，装完默认可能用的是动态URL模式，进后台把URL模式切换成rewrite，前提是刚才.htaccess和AllowOverride都配置正确了，不然切完之后整站就挂了，还得去后台数据库手动改回来，比较麻烦。其次是上传图片如果出现失败，多半是data/upload目录权限问题，单独看一眼就好。还有一个小坑是PHP的upload_max_filesize和post_max_size，默认值比较小，如果论坛允许上传附件，建议在php.ini里把这俩值调大一些，改完记得重启PHP-FPM。

整体体验下来，xiuno部署并不算复杂，比我想象中顺利，主要踩的坑都集中在Apache配置这一块。如果你之前用Nginx比较多，切换到Apache思路上要稍微转换一下，Nginx是在server block里直接写rewrite规则，Apache是靠.htaccess和AllowOverride这套机制，习惯了就好。

最后说一句，xiuno这个项目更新不算频繁，插件生态也没有phpBB那么成熟，但胜在代码清爽，适合个人小站或者技术爱好者自己玩。如果你对PHP有一定了解，二次开发也不难，我已经在考虑自己写几个小插件了，有进展再来分享。