最近折腾了好几天，终于把 Xiuno BBS 用 Docker + Compose 的方式跑起来了，过程中踩了不少坑，这里整理一下分享给有需要的朋友，也算是给自己留个备忘。 先说说为什么要折腾容器化。Xiuno 是一个很轻量的 PHP 论坛程序，直接扔在宝塔或者裸机 LNMP 环境下跑其实没什么问题，但一旦你有多台服务器、或者经常需要迁移环境， ...

最近有几个朋友问我，Xiuno 论坛在流量稍微大一点之后就开始出现 502、响应变慢的问题，其实这个大概率不是 Xiuno 本身的锅，而是 PHP-FPM 的配置没跟上。今天把我自己踩坑总结出来的东西写下来，希望对有同样困扰的人有用。 首先说 PHP-FPM 的进程池配置。很多人装完环境之后完全不动默认配置，pm 模式直接用 static 或者 ...

最近折腾 Xiuno BBS 也有一段时间了，踩了不少坑，今天专门来聊聊 URL 伪静态和多级路由规则这块，希望对还在摸索的朋友有点帮助。 先说说为什么要做伪静态。Xiuno 默认跑出来的链接是带问号参数的那种，比如 index.php?mod=topic&tid=123 这样，看起来很丑不说，对 SEO 也不友好。搜索引擎蜘蛛对动态参数 URL 的抓取权重 ...

折腾 Xiuno 也有好几年了，最近终于下定决心把默认的编辑器换掉，顺手记录一下过程，希望对同样在纠结这个问题的朋友有点参考价值。 Xiuno BBS 自带的编辑器说实话一直是我的心病。功能不算少，但用起来总感觉差点意思，尤其是工具栏的排列逻辑很奇怪，很多我常用的功能要多点几下才能找到，而一些基本上没人用的按钮却占 ...

折腾了将近两周，终于把 Xiuno 默认的编辑器换掉了，来写篇帖子记录一下，也给后面有同样需求的朋友省点时间。 先说说为什么要换。Xiuno 自带的那个编辑器说实话真的很一般，功能简陋不说，在移动端的表现更是惨不忍睹。很多用户反映发帖的时候粘贴内容经常格式乱掉，图片上传有时候也不稳定，时间久了论坛口碑都受影响了 ...

很多朋友把 Xiuno 搭起来后，就放着跑，直到被扫库、挂暗链才开始补课。说实话，Xiuno 轻量是优点，也是风险：默认配置偏“开发友好”，对攻击面的收口不够。下面把我给几个站做安全加固与接入 WAF 的要点梳理一下，尽量说人话，能落地。 先从最低成本的“房门上锁”做起。后台路径别用默认的 admin，而是改成随机长路径， ...

最近在折腾 Xiuno 论坛的反垃圾、反灌水和风控配置，踩了不少坑，也算摸出了一套“够用、少误杀、能落地”的思路。简单分享，供同样被广告机和脚本折磨的站长参考。 先说总体策略：别指望一道规则解决所有问题，要“入口限流 + 行为评分 + 事后处置”三层并行。入口层负责挡掉最粗暴的脚本和国外肉机；行为层用规则细抠“ ...

这几年折腾 Xiuno，我对“数据备份与灾备恢复演练”越来越看重。不是危言耸听，真出过事故：一次磁盘 SMART 报警被我当成小题大做，结果半夜盘挂了，幸亏前一天手动导出过一次 SQL 才没全军覆没。那之后我把备份这事当成运营的一部分，用约束和演练把风险降下来。 先说备份策略。Xiuno 的核心是数据库，其次是 upload 目录 ...

很多人在折腾 Xiuno 的时候都会碰到一个需求：多站点共用一个账号体系，也就是单点登录（SSO）。Xiuno 本身比较轻量，没内置完善的 SSO 机制，但并不意味着做不到。这里分享一个更偏工程化、落地可行的思路，尽量不魔改核心，后续也好维护。 先明确边界。SSO 至少解决三件事：统一鉴权（用户在 A 站登录，B 站自动识别）、 ...

这两年折腾 Xiuno 的人不算少，问到最多的一个需求就是第三方登录：微信、QQ、微博。理由很简单——别和用户抢记忆力。让他们点一下熟悉的图标、授权完就能发帖回帖，转化率立刻上来。可真要落地，你会发现坑不少，既有平台侧的合规、回调域名、审核问题，也有 Xiuno 本身轻量结构带来的对接细节。下面把我的踩坑和取舍思路 ...

做过几次 Xiuno 的二开与部署后，我对“消息触达”这块一直有个朴素标准：稳定、可观测、可回退。邮件通知与短信网关对接，看似只是发条消息，踩过的坑多了才知道细节才是成败关键。下面按实战流程梳理思路与要点，帮助你少走弯路。 先说邮件通知。Xiuno 原生支持 SMTP，但默认配置偏保守。企业环境建议直接用成熟服务商（ ...

这两年折腾 Xiuno，踩过最多的坑就是图片与附件上传策略，尤其是接入各家云存储。表面看就是“能传上去就行”，实际一旦量起来、地区分布起来、再叠加移动端网络状况，隐患全冒出来。这里把我的经验和几个取舍点讲清楚，给后来的同学少走弯路。 先说本地直传。优点是简单、可控，调试成本低，权限模型也和 Xiuno 自带的一 ...

很多人装上 Xiuno 论坛，第一件事就是找“用户组权限在哪儿改”，结果在后台各处来回点，越改越乱。其实 Xiuno 的权限与角色管理并不复杂，关键是先把“角色—用户组—版块规则—插件扩展”这四层关系理顺，再上手配置。 先说角色和用户组。Xiuno 默认把权限打包在“用户组”里，比如游客、注册用户、版主、管理员等。角色 ...

很多人把 Xiuno 装起来就丢着不管，以为“内容自然会被收录”。结果半年过去，站点名能搜到，帖子标题搜不到。Xiuno 轻量好用，但要想让搜索引擎喜欢，还得把 SEO 设置拧到位，再配合一点点耐心的运营节奏。 先说站内基础。后台全局设置里，站点标题、关键词、描述别偷懒。标题建议“品牌词 + 核心定位”，描述用一句话讲 ...

这几年折腾 Xiuno，从 3.x 到 4.x，再到停更后的民间维护版，踩过的坑够写一篇迁移笔记了。下面把我自己“可复用”的升级迁移步骤和注意事项梳理一下，给后来者省点时间。 第一步是摸清家底。别急着动手，先在老站后台记下 Xiuno 版本、PHP/MySQL 版本、启用的插件与主题清单，以及是否有二开改动。插件最好导出配置截图， ...

Xiuno 常见报错排查与调试方法这件事，说难不难，说简单也绝不简单。难在环境各不相同、插件千奇百怪，简单在于套路大同小异：先稳住现场，复现问题，读清报错，再层层剥洋葱。下面按我自己踩坑总结一套可落地的排查路径。 第一步是还原运行环境。很多报错源自升级了 PHP、换了 Web 服务器或动了配置文件。确认 PHP 版本与 ...

这几年折腾 Xiuno，从 PC 主题到手机端，最大的感受就是：别把“移动端适配”和“响应式布局”混为一谈。前者更像“做两套体验，按场景切换”，后者是“同一套骨架，自适应伸缩”。Xiuno 的模板系统偏轻量，想做好移动端，既要顺着它的路子走，又得在细节上强行补课 先说适配。早期我走的是“m.”二级域名+独立模板的路子 ...

这两年折腾 Xiuno 主题模板，踩了不少坑，也总结出一套相对稳妥的思路。很多人把它当“轻论坛框架”来用，的确轻，但越轻越需要自律：目录结构别乱、逻辑别写进视图、二次开发尽量补丁化，能不改内核就不改。 先说主题制作的起点。我的习惯是从官方默认主题克隆一份，改名、改命名空间，再做最 ...

很多人提到 Xiuno 的插件体系时，第一反应是“老论坛程序还能折腾什么？”但真上手后，你会发现它的 Hook 机制朴素却够用，目录结构清晰，适合做一些轻量增强。入门的关键有三个：理解插件目录规范、掌握钩子与事件、学会最小闭环的示例迭代。别一上来就想做个大而全的 SEO 管理器，先从一个按钮、一个设置项开始，把开发— ...

很多朋友折腾 Xiuno，一开始都会被“轻量、纯文本缓存、单文件路由”这些点吸引，但真把站点跑到日 UV 5k 以上，性能瓶颈就开始冒头：慢查询、反复加载配置、帖子列表翻页抖动。过去两年里我给两个活跃站做过优化，总结下“缓存与数据库索引”的实践思路，尽量少谈玄学，多说可落地的手段。 先说缓存。Xiuno 自带简单的 fi ...