快速安装向导

虽然不会图文并茂，但我会尽量写详细点，希望你能看懂。

如果你在安装过程中遇到任何问题，请先查阅 FAQ - 常见问题！

🐳 想要使用 Docker 进行部署？

我们支持！详情请参阅：Wiki - yushijinhun/blessing-skin-docker

☑️ 检查你的机器是否符合安装需求

具体请查看 README - 环境需求。

如果你的虚拟主机 PHP 版本满足不了要求，可以退求其次使用 v2 版本。

如果你在使用 PHP 7.2，请先阅读 Wiki - 在 PHP 7.2 上运行。

Blessing Skin 有自带运行时环境检查（报错以 [Error] 开头），遇到这种情况就说明你的环境不符合需求。

☑️ 下载安装包

首先你要明白，我提供的安装包是由两个部分组成的：

• Blessing Skin 皮肤站本体的源码
• 依赖库以及前端构建文件

如果你直接从 GitHub 上拉取代码是无法直接使用的，因为其中只包含了本体源码，而没有包含依赖库等其他必须的文件。所以，你必须下载完整安装包或者 自行构建（不是所有人都会）。

所以，如果你没有相应的技术基础，请乖乖下载完整安装包。

各版本的完整安装包可以在这里找到：

• [推荐] GitHub releases
• [辣鸡] 百度网盘

注意，你应该下载类似 blessing-skin-server-xxx.zip 的文件，而不是下载 Source Code。

☑️ 解压安装包

解压到你喜欢的地方去，必须保证 index.php 在网站根目录下。

如果想要把皮肤站安装到子目录，请参考 FAQ - 如何将皮肤站安装在子目录？

☑️ 修改 .env 配置文件

！！这一步很重要！！

你需要在这个文件里正确配置你的数据库连接等信息。

具体请参阅 Wiki - 如何填写 .env 配置文件。

☑️ 配置 URL 重写规则（伪静态）

大多数虚拟主机用户的 Web Server 都是 Apache，本程序自带开箱即用的 .htaccess，所以这些用户（包括使用 IIS 的用户）无需进行任何操作，直接进入下一步即可。

如果你使用的是 Nginx 或者其他 Web Server，你需要手动配置 URL 重写规则。

如果你需要将 Blessing Skin 安装在子目录中，请参阅：Wiki - FAQ - 如何将皮肤站安装至子目录。

下面以 Nginx 为例：

1. 找到你的 Nginx 站点配置文件（也就是你这个域名的 server {} 块）
2. 在 server {} 块中适当的地方添加如下规则：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ /\. { deny all; }
location /storage { deny all; }

如果你用的是 lnmp 一键包、某某面板之类的东西添加的站点配置，请阅读 Issue #46 - 图片无法显示 并查看你的配置文件中是不是也有类似的东西。

什么？你不知道你的 nginx.conf 在哪，也不知道该把这一段加在哪里？

你都不知道我怎么知道，真搞不懂的话就换 Apache 吧。

☑️ 测试伪静态是否生效

打开你的浏览器，访问 http://你的皮肤站地址/setup。

如果显示 404 且页面上没有任何 Blessing Skin 字样，就说明伪静态没生效，自己想办法回炉重造。

如果正确显示了安装界面，就可以继续了。

☑️ 运行安装向导

如果上个步骤中你配置的数据库连接信息没出错的话，现在访问皮肤站就可以看到欢迎页面了：

跟着安装向导填写必要信息即可快速完成安装。

如果你在安装向导的最后一步出错了，并且报错像这样的话：

escapeshellarg() has been disabled for security reasons

那就说明你的虚拟主机提供商禁用了某些 Blessing Skin 需要使用的函数，你有两个选择：

1. [方便快捷] 换一家虚拟主机提供商
2. [需要一定动手能力] 👉 Wiki - 手动安装 Blessing Skin

🎉 安装完成

不出意外的话，你已经完成了 Blessing Skin 的安装，尽情使用吧。

如果你在安装过程中遇到任何问题，请先查阅 FAQ - 常见问题，确认你遇到的问题不在此列后，再依照 Wiki - 报告问题的正确姿势 中的要求联系开发者。

---

🚀 下一步，请前往 Wiki - 如何配置皮肤 Mod

只有皮肤站、皮肤 Mod 均正确配置，游戏内才会显示皮肤。