Xiuno BBS 域名绑定完整教程：轻松实现自定义域名访问配置

52JinY 助手

聊聊xiuno绑定域名那些坑，踩过才知道有多烦

用xiuno建站也有两三年了，这个轻量级论坛程序确实挺好用的，干净、快、代码也简洁。但说实话，第一次给它绑定域名的时候，我真的折腾了大半天，查了很多帖子都没找到完整的说法，索性今天把自己的经验整理出来，希望能帮到后来者少走弯路。

先说最基础的部分。域名绑定本质上分两个层面：一个是DNS解析层面，一个是程序配置层面。很多新手只做了前者，把域名A记录指向服务器IP，然后直接访问发现样式全乱、图片加载不出来，就开始怀疑是程序bug。其实根本原因是config.php里的site_url没有同步修改，xiuno是把这个地址硬写进很多资源路径里的，所以只要这个配置项还指向旧地址或者localhost，你新绑的域名访问起来肯定一团糟。

具体操作步骤我说一下。找到程序根目录下的config.php，搜索site_url这个键值，把它改成你实际绑定的域名，带上协议头，比如https://www.yourdomain.com，注意结尾不要加斜杠，这个细节很多人忽略。改完之后如果还有问题，去后台的系统设置里再确认一遍，因为有些版本会把站点URL单独存一份在数据库里，两个地方不一致也会出问题。

然后说说HTTPS的问题，这个坑更深。现在基本上网站都要上SSL证书，申请完证书配好Nginx或者Apache之后，如果你的xiuno站点出现混合内容警告，导致页面某些元素加载失败，大概率是因为程序内部有些链接还是http开头的硬编码。这时候可以在config.php里找有没有force_ssl之类的配置项，不同版本字段名可能不一样。如果没有这个配置，可以考虑在Nginx层面做一个全局的HTTP到HTTPS重定向，同时在PHP层面用$_SERVER['HTTPS']做判断，也算是一个折中的解决办法。

另外提一个容易被忽略的地方，就是附件和上传文件的路径问题。绑定新域名之后，历史帖子里的图片链接如果是旧域名的绝对路径，就全部失效了。这个没有什么特别优雅的解决方法，要么直接去数据库做一次批量替换，把旧域名替换成新域名，要么提前规划好，上传文件就用相对路径存储，后期迁移会省很多事。我当初就因为没注意这个，迁移了一批帖子之后图片全挂了，后来用SQL跑了一次replace才搞定。

还有一点想说，就是绑定域名之后记得清一下缓存，xiuno有自己的缓存机制，有些静态缓存文件里可能还存着老的URL。找到cache目录，把里面的文件清掉，然后重新访问让程序重新生成，很多奇怪的问题就自然消失了。

总体来说，xiuno的域名绑定流程并不复杂，核心就是三件事：DNS解析指向正确、config.php里的URL同步更新、HTTPS证书配置到位。但每一步都有细节，特别是对刚接触这个程序的人，文档又不够详细，很容易卡在某个小地方搞半天。希望这篇帖子能当个参考，有问题欢迎回帖讨论，我尽量解答。