HDWiki建站避坑指南，踩过这些雷，你也能少走弯路

搞HDWiki建站，说多了都是泪，当年还是一枚小白，看着HDWiki轻巧好用，就拿来搭个知识库，结果三天两头出幺蛾子，现在回头看，很多坑其实都有迹可循，今天就把我这几年攒下的经验倒给你，能省的时间尽量省,能避的雷就别再踩了。

环境不搭调，全盘皆输
一开始图省事，用虚拟主机装了个HDWiki，PHP版本才5.2，结果页面乱码、后台打不开、AJAX半天没响应，差点让我怀疑人生，后来换到Linux服务器，装PHP 7.4才总算消停，别用Windows IIS，HDWiki对Apache和Nginx支持最友好，我习惯用宝塔面板，一键装好LNMP环境，PHP锁死7.4——别手贱升到8.0以上，有些老扩展直接不兼容，MySQL选5.7，MariaDB 10.3以上的版本有查询兼容坑,别问我是怎么知道的。

伪静态配错，首页一秒500
默认动态URL又臭又长，想开伪静态装个“高级”，结果忘了放.htaccess规则，整个站直接白屏，Apache还好，官方给了规则；Nginx就得自己写，网上有现成的，但一定要把路径改成你实际安装的目录，我用的Nginx规则里有个坑：rewrite ^/(.*)$ /index.php?q=$1 last; 如果你放在子目录，就得写成/子目录/index.php，改完务必重启nginx，再清一下浏览器和服务器缓存,不然你折腾一晚上都刷新不出来。

附件上传限制，气得想砸键盘
默认上传只有2MB，我传一张产品图都提示超限，后台设置里改了个寂寞，压根没用，后来才明白，要改三处：PHP的upload_max_filesize、post_max_size，还有HDWiki后台的允许上传大小，前两个在宝塔的“软件设置”里就能改，改完记得重启PHP，附件多了以后，建议把附件目录单独挂载到云硬盘上，别跟系统盘挤在一起,不然哪天磁盘满了你哭都来不及。

中文乱码，差点让我删库 全是问号？先别急着删库，查一下数据库排序规则，我当初建库用的是utf8_general_ci没问题，但连接编码不对，解决方案：安装前直接把库排序规则设为utf8mb4，再修改config里数据库编码参数，比如'DB_CHARSET' => 'utf8mb4'，所有PHP文件一律用UTF-8无BOM头保存，别用什么带BOM的编辑器，否则头部会输出乱码,小坑大隐患。

缓存插件，静态页变成僵尸
为了提速，我装了个静态化插件，结果页面更新后还是旧内容，后台改了一个小时，前台纹丝不动，我还以为数据起死回生了，后来才发现是缓存没过期，解决方案：缓存时间别设太长，最多10分钟；或者干脆不用那些不明来历的缓存插件，直接上Memcached做对象缓存，再配合opcache，性能杠杠的，还不会出现“改啥都不变”的破事。

推荐配置和插件
服务器别太寒酸，2核4G起步，带宽按实际访问量走，HDWiki本身不挑食，但MySQL吃内存，如果预算紧张，1核2G也能跑，记得开2GB的swap，不然一访问量大就卡死，插件方面，我强烈推荐三样：防垃圾注册验证码插件，不然你的站点会被灌满色情广告；sitemap生成插件，给百度站长工具提交用的；还有一个自动备份插件，或者更靠谱的，用crontab脚本每天打包数据库和附件目录,这些都能让你少熬夜。

长期维护，比建站更重要
HDWiki不是装完就一劳永逸，备份是命根子——每天自动备份数据库，每周全量备份文件，存到另一台服务器或OSS上，别放在同机，安全补丁要盯紧，HDWiki更新不频繁，但一出就是安全漏洞，看到官方发版本赶紧升，再有，每天瞄一眼nginx和mysql的错误日志，发现扫描漏洞的IP就直接防火墙封掉，开放注册的站点必须加内容审核机制,不然垃圾帖能把你的服务器拖垮。

一句话：HDWiki建站不难，难的是稳定跑几年，环境选对，配置调好，剩下的就是耐心，希望这些经验能让你少掉几根头发，别问我是谁，一个被HDWiki虐过千百遍、还想继续用下去的老站长。