Nginx反向代理配置Xiuno BBS论坛完整教程，轻松搭建高性能社区

52JinY 助手

最近折腾xiuno论坛系统的时候，踩了不少坑，尤其是nginx这块的配置，网上找到的资料要么太老，要么根本就是复制粘贴的垃圾内容，真正能用的寥寥无几。今天把自己的经验整理出来，希望能帮到后来人少走弯路。

先说背景，xiuno BBS是一套比较轻量的PHP论坛程序，早年用的人不少，现在虽然热度下来了，但还是有一批人在维护自己的小站。它的URL重写规则和其他PHP程序有点差别，如果你直接把WordPress或者Discuz的nginx配置照搬过来，基本上是跑不起来的，表现就是首页能打开，但一点进帖子或者其他页面就直接404，很多新手卡在这里不知所措。

xiuno的伪静态规则其实不复杂，关键就在于location的写法。大概是这样的结构：先设置好root指向你的程序目录，然后index指定为index.php，接着加一条location块，用try_files指令，让nginx先尝试去找对应的真实文件或者目录，找不到就转交给index.php处理，同时把请求的URI作为参数传过去。这个逻辑说起来简单，但细节上有几个地方容易出问题。

第一个坑是fastcgi_param那块的配置。很多人用的是网上流传的通用PHP配置模板，里面有些参数路径写的是默认值，如果你的PHP-FPM监听的是socket文件而不是9000端口，那fastcgi_pass这行就得改，要指向对应的sock文件路径，比如/run/php/php8.1-fpm.sock这类。路径写错了，页面直接白屏或者报502，排查起来比较费劲，因为nginx日志里的报错有时候不够直观。

第二个坑是关于静态资源目录的处理。xiuno的js、css、图片这些文件都有固定的目录结构，建议单独给这些目录加一条location规则，设置expires缓存时间，同时把access_log关掉，这样既能提升加载速度，又能避免日志里塞满大量静态资源的访问记录，后期排查问题的时候清爽很多。有人图省事全部交给PHP处理，结果静态文件请求也走了一遍fastcgi，性能白白损耗。

第三点要注意的是文件上传相关的配置。xiuno允许用户上传头像和附件，nginx默认的client_max_body_size是1M，超过这个大小就会报413错误。我一般会把这个值调到20M左右，具体看你的站点需求，同时PHP那边的upload_max_filesize和post_max_size也要同步调整，两边都要改，只改一边没用。

还有一个细节很多人忽略，就是xiuno的后台路径默认是/admin，如果你的服务器直接暴露在公网，建议在nginx层面给这个路径加一道访问限制，比如只允许特定IP段访问，或者加个basic auth做一层拦截，防止被人暴力扫描尝试爆破。这不是xiuno本身的问题，是基本的安全意识，论坛程序大多有这个隐患。

配置改好之后，记得用nginx -t先检验一下语法，没问题再reload，不要直接restart，reload是平滑重载，不会中断现有连接，restart则会有短暂中断，线上环境尽量用reload。另外建议把配置文件备份一份，有时候改着改着把原来能用的东西搞坏了，有备份能快速回滚，省去很多痛苦。

总的来说，nginx配置xiuno并不算难，难的是那些隐藏在细节里的小问题。踩过坑之后回头看，其实每个问题都有迹可循，关键是要学会看日志，nginx的error.log和PHP-FPM的日志都要对照着看，单看一个往往定位不准。希望这篇整理对你有用，有问题欢迎在下面回复交流。