Blessing Skin 是一个开源的 Minecraft 皮肤站,可以上传、管理和分享 Minecraft 皮肤和披风,界面易于使用,具有强大的可扩展性,可支持自定义 Yggdrasil API 外置登录系统。
BS 官方并没有给出容器化部署方案(其实有过但早已不维护),传统 PHP(最好的语言) 部署方案太过繁杂,如需实现 Yggdrasil Connect 提案中的 OAuth 登入方式,需要额外配置一个 Janus 程序(NodeJS)且配置过程更加繁琐。
如果你不追求 Blessing Skin 的拓展性和在协议制定方面的话语权,不妨试试其他优秀项目。
仓库地址:Dainsleif233/skin-docker
这个仓库做了哪些:
配置了容器化 PHP 环境,内置插件市场镜像,自动配置 redis 连接,自动完成 APP 密钥初始化。
构建了 Janus 和 Prisma 客户端,开箱即用。
配置了 FastCGI 和 Janus 代理,上游只需配置反向代理和 Https。
安装 Docker 和 Docker Compose,可参考阿里云官方文档
安装并配置 Web Server,这里强烈推荐 Caddy,配置简单,支持自动 HTTPS。
Caddy 配置示例 以域名 skin.jsumc.fun 和端口 8081 为例
skin.jsumc.fun {
reverse_proxy 127.0.0.1:8081
} 新建一个文件夹用于存放皮肤站相关文件。以 /opt/skin 为例。
下载仓库中的 docker-compose.yml 文件到 /opt/skin 文件夹。
编辑 docker-compose.yml 文件,根据注释修改。
sqlite 用户先用 touch data/skin.db 创建数据库文件。以 data/skin.db 为例。
运行 docker compose up -d 启动容器。
运行 docker compose --profile http up -d 启动 HTTP 容器。
打开网页安装 Blessing Skin,注意 sqlite 数据库填容器内绝对路径。完成后在插件市场安装 Yggdrasil-Connect 插件并启用。在 OpenID 提供者标识符 填入 https://skin.jsumc.fun/api/janus。这里以 skin.jsumc.fun 为例。
运行 docker compose exec skin php artisan yggc:create-personal-access-client --owner=1,其中 1 是个人访问客户端所属的用户的 ID,默认不用改。输入 yes 回车,会得到一个 PASSPORT_PERSONAL_ACCESS_CLIENT_ID=1,这个 1 就是个人访问客户端的 ID。
打开 OAuth2 应用,在刚刚创建的个人访问客户端对应的项目添加回调 URL https://skin.jsumc.fun/yggc/client/public 并确保站点配置中的站点地址(URL)已填写。
运行 docker compose --profile janus up -d 启动 Janus 容器。
打开 data/.env 文件
PASSPORT_PERSONAL_ACCESS_CLIENT_ID=1 填入刚刚得到的个人访问客户端 ID。
BS_SITE_URL=https://skin.jsumc.fun 填入皮肤站的 URL,必须是 HTTPS。
BS_SITE_NAME="JSUCraft Skin" 填入皮肤站的名称,注意有空格就需要用引号括起来。
BS_FAVICON_URL=https://pic.imgdb.cn/item/6725c6e7d29ded1a8c6695b3.jpg 填入皮肤站的图标 URL。
运行 docker compose --profile http --profile janus down 关闭所有容器。
编辑 docker-compose.yml 文件,将 http 和 jsnus 的 profiles 注释掉。
运行 docker compose up -d 启动容器。
要想为每个启动器创建独立的 Client ID,需要在 OAuth2 应用 中创建一个新的应用,应用名为启动器名,回调 URL 中填入 https://skin.jsumc.fun/yggc/client/public,再将新的 Client ID 提交给启动器开发者。
启动器也会自主获取公共 Client ID,只需要在 data/.env 文件中修改 SHARED_CLIENT_ID= 这一行。改成自定义的公共 Client ID,这个 ID 对应的回调 URL 也需要设置为 https://skin.jsumc.fun/yggc/client/public。