Xunruicms安装教程：环境检测与数据库配置_Xunruicms_安装教程_数据库配置
Xunruicms的安装教程说难不难，关键在几个容易忽略的细节。一旦踩中就会导致配置不生效或者站点异常。结合多年维护经验，把坑点标出来，同时给出标准操作流程。
虚拟主机安装Xunruicms和VPS上安装流程不一样。虚拟主机用面板自带的一键安装省事，VPS需要自己配PHP和MySQL。不管哪种环境，安装前的环境检测这一步不能跳过。
操作方法如下，新手也能跟着完成。
宝塔面板里点添加站点，域名填好，数据库选MySQL，设置数据库名和密码。PHP版本选Xunruicms推荐的版本，不要选太新的，兼容性优先。
到Xunruicms官网下载最新稳定版安装包，上传到站点根目录解压。把解压出来的文件移到根目录，不要多一层文件夹。设置runtime和upload目录权限为755。
浏览器访问域名，自动跳转到安装页面。按提示填数据库信息，数据库名和密码用刚才添加站点时设置的。管理员账号密码自己设，安装完成后删除install目录，登录后台开始配置。
操作过程中有几个点需要特别注意。
伪静态规则改错会导致全站404。修改规则前备份原配置，改完立即测试，有问题快速回滚。Nginx改完用nginx -t测试语法，再reload。
备份文件不要存在网站根目录下，会被下载。放在www目录以外，或者用不可猜测的文件名加.htaccess禁止访问。备份文件包含数据库信息，泄露风险大。
HTTPS和HTTP混合内容会导致浏览器安全警告。切换HTTPS后检查页面所有资源链接，图片、CSS、JS都要用HTTPS。数据库批量替换http://为https://。
CDN缓存可能导致修改后看不到效果。CDN后台刷新缓存，或者给静态资源加版本号参数style.css?v=2，强制浏览器加载新版本。
实际操作中还会碰到一些衍生问题，这里一并说明。
问：改完后页面样式乱了怎么办？答：看浏览器控制台有没有CSS文件404或者JS报错。路径错了资源加载不到页面就会乱。检查模板里CSS和JS路径是否正确，相对路径和绝对路径不要搞混。
问：虚拟主机没有服务器权限怎么操作？答：虚拟主机用面板提供的功能，文件管理器改文件，phpMyAdmin管数据库，伪静态在面板设置。大部分Xunruicms操作不需要服务器命令行权限。
技术问题最怕一知半解就动手改配置。Xunruicms的这个功能涉及几个配置项联动，改一个不改另一个就会出问题。这篇文章把关联配置都列出来了，按顺序操作不会漏项。
更新时间：2026-08-27 13:16:33
上一篇：404 Not Found页面未找到错误伪静态/重写方案｜服务器配置错误运维Nginx服务器Z-Blog404修复