快速安装向导 - prinsss/blessing-skin-server GitHub Wiki
虽然不会图文并茂,但我会尽量写详细点,希望你能看懂。
如果你在安装过程中遇到任何问题,请先查阅 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 为例:
- 找到你的 Nginx 站点配置文件(也就是你这个域名的
server {}
块) - 在
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 需要使用的函数,你有两个选择:
- [方便快捷] 换一家虚拟主机提供商
- [需要一定动手能力] 👉 Wiki - 手动安装 Blessing Skin
🎉 安装完成
不出意外的话,你已经完成了 Blessing Skin 的安装,尽情使用吧。
如果你在安装过程中遇到任何问题,请先查阅 FAQ - 常见问题,确认你遇到的问题不在此列后,再依照 Wiki - 报告问题的正确姿势 中的要求联系开发者。
Wiki - 如何配置皮肤 Mod
🚀 下一步,请前往只有皮肤站、皮肤 Mod 均正确配置,游戏内才会显示皮肤。