Docker搭建Minecraft AArch64 Server指北
这篇文章也同时发表在我的Github Pages上。
介绍
开始之前，先分别介绍本文所涉及的几个名词。
Minecraft：《我的世界》（英语：Minecraft，港台译作“当个创世神”）是一款沙盒游戏，最初由瑞典游戏设计师马库斯·阿列克谢·泊松（别名Notch）单独开发，随后由2009年成立的瑞典公司Mojang开发并发行。玩家可以在一个随机生成的3D世界内，以带材质贴图的立方体为基础进行游戏。游戏中的其他特色包括探索世界、采集资源、合成物品及生存冒险等。游戏有多种模式，生存模式中玩家必须维持生命并采集资源来打造自己的世界；创造模式中玩家拥有无限的资源并可飞行，大多数玩家会使用此模式来建造大型建筑；冒险模式中玩家可在其他玩家定制的地图中游玩。游戏的Java版以其强大的第三方拓展模块（mod）而知名，它们可为游戏添加各种新的对象、角色和功能。(来源：维基百科)
Blessing Skin: Blessing Skin 是一款能让用户上传、管理和分享 Minecraft 皮肤和披风的皮肤站Web 应用程序。与修改游戏材质包不同的是，所有人都能在游戏中看到各自的皮肤和披风（当然，前提是玩家们要使用同一个皮肤站）。Blessing Skin 是一个开源的 PHP 项目，这意味着可以自由地在你的服务器上部署它。(来源：Blessing Skin GitHub主页 项目作者：@printempw)
authlib-injector：简单来讲，就是通过运行时修改 authlib 实现游戏外登录，并为 Yggdrasil 服务端的实现提供规范。Mojang（开发Minecraft的公司）在代码中写死了登录中必须要访问他们的官方服务器，authlib-injector通过在Minecraft服务器运行时替换相关的字节码为自己的服务器地址，让用户可以访问自己的私有服务器。(来源：authlib-injector GitHub主页）
Yggdrasil API for Blessing Skin：是Blessing Skin的一个插件，基本实现了 Yggdrasil API 规范，可与 authlib-injector 等 authlib hook 配合使用实现外置登录系统。（来源：Yggdrasil API for Blessing Skin GitHub主页）
编排
镜像
因为服务器是aarch64架构，也要考虑Docker镜像的架构，否则在错误的架构上运行容器就会出现类似exec format error的提示。
经过测试，编排中可以直接使用的Docker Hub aarch64架构镜像有以下几个，其中itzg/minecraft-server:multiarch镜像其实有很多配置项，具体配置可以参考它的项目主页，本文仅以运行原生Minecraft Server为例。mariadb:latest和redis:4.0用于存储皮肤站的相关数据：
itzg/minecraft-server:multiarch
mariadb:latest
redis:4.0
皮肤站使用了php的相关依赖，在Docker Hub上翻了翻，并没有现成的镜像可以使用，于是根据已有的nginx-php-fpm镜像edofede/nginx-php-fpm:latest自己构建了一个，Dockerfile如下：
FROM edofede/nginx-php-fpm:latest RUN sed -i "s@http://dl-cdn.alpinelinux.org/@https://repo.huaweicloud.com/@g" /etc/apk/repositories \ && apk update \ && apk --no-cache add \ php7-pdo \ php7-openssl \ php7-mbstring \ php7-tokenizer \ php7-gd \ php7-ctype \ php7-fileinfo \ php7-zip \ php7-session \ php7-pdo_mysql \ php7-iconv EXPOSE 80
保存好Dockerfile之后在同一目录构建镜像koi/nginx-php-fpm:latest：
docker build -t koi/nginx-php-fpm .
数据和配置
数据目录结构如下：
$ tree -L 1 . ├── blessing-skin-server ├── data ├── docker-compose.yml ├── mysql └── nginx
blessing-skin-server：从项目Release页面下载所需版本发布包，并解压到此目录。需要说明的是，Yggdrasil API插件可以不用先安装，可以等配置好服务启动之后在皮肤站的插件市场中在线安装。
皮肤站默认配置文件为.env，可以复制一份模板文件
cp .env.example .env
配置mysql的用户、密码、数据库等相关数据。
data：Minecraft Server运行时挂载，存储相关配置。需要提前下载好authlib-injector-1.1.26-41a7a47.jar和minecraft_server.1.15.2.jar到data目录，注意需要对应两个jar包在下文中docker-compose.yml中的名称。
mysql：存储皮肤站的用户数据库。
nginx：存储皮肤站的nginx配置，配置文件名为default，不可修改文件名称（nginx容器通过软链使用此配置）。详细配置内容如下：
server {
listen 80 default_server;
listen [::]:80 default_server;
root /var/www/public;
index index.html index.htm index.php;
server_name _;
location / {
try_files $uri $uri/ /index.php?$query_string;
autoindex on;
}
location ~ \.php$ {
fastcgi_split_path_info ^(.+?\.php)(/.*)$;
if (!-f $document_root$fastcgi_script_name) {
return 404;
}
fastcgi_pass unix:/run/php/php7.0-fpm.sock;
fastcgi_param PATH_TRANSLATED $document_root$fastcgi_script_name;
include fastcgi_params;
}
location ~ /\.ht {
deny all;
}
location = /404.html {
internal;
}
}这里没有使用域名，也没有启用HTTPS，有需要的话可以自己修改。
docker-compose.yml
直接上yaml配置文件，一目了然。
Minecraft service的JVM_XX_OPTS环境变量中有个host:port，host修改成你自己的服务器地址就好，port对应skin-website service中的port，另外修改mysql的用户密码为你配置在.env中的用户和密码。
注意修改服务器的安全策略，放通皮肤站(port端口)和Minecraft Server(25565端口)的访问。
version: '3' services: db: image: mariadb restart: always volumes: - ./mysql:/var/lib/mysql environment: MYSQL_ROOT_PASSWORD: xxx MYSQL_DATABASE: blessingskin MYSQL_USER: koi MYSQL_PASSWORD: xxx redis: image: redis:4.0 restart: always skin-website: image: koi/nginx-php-fpm:latest ports: - "port:80" volumes: - ./nginx:/etc/nginx/sites-available - ./blessing-skin-server:/var/www restart: always links: - db - redis depends_on: - db - redis minecraft: image: itzg/minecraft-server:multiarch ports: - "25565:25565" volumes: - ./data:/data environment: EULA: "TRUE" VERSION: "1.15.2" TYPE: "CUSTOM" CUSTOM_SERVER: "/data/minecraft_server.1.15.2.jar" JVM_XX_OPTS: "-javaagent:/data/authlib-injector-1.1.26-41a7a47.jar=http://host:port/api/yggdrasil" restart: always links: - skin-website
运行
根据Blessing Skin的安装指南，首次运行时需要生成app key，在docker-compose.yml文件所在目录执行以下命令
docker run -it --rm -v ./blessing-skin-server:/blessing-skin-server koi/nginx-php-fpm:latest cd /blessing-skin-server && php artisan key:generate
即可生成app key.
进入到docker-compose.yml文件所在目录，执行
docker-compose up -d
查看服务状态：
$ docker-compose ps Name Command State Ports -------------------------------------------------------------------------------------------------------------- minecraft_db_1 docker-entrypoint.sh mysqld Up 3306/tcp minecraft_minecraft_1 /start Up (healthy) 0.0.0.0:25565->25565/tcp, 25575/tcp minecraft_redis_1 docker-entrypoint.sh redis ... Up 6379/tcp minecraft_skin-website_1 /entrypoint.sh Up 0.0.0.0:8080->80/tcp
容器minecraft_minecraft_1的State为Up (healthy)时，说明Minecraft服务器已经正常启动。
此时没有问题的话，就能进入皮肤站主页（即host:port），确认相关配置并注册用户和你的Minecraft角色了，同时也不要忘了在插件市场中启用Yggdrasil API插件。
Play
使用支持authlib-injector登录的客户端，比如HMCL，添加对应的api地址，如下图所示：
进入游戏后，就可以添加你的Server，进入属于“你的世界”，快去通知朋友们一起玩耍吧！
- 点赞
- 收藏
- 关注作者
评论（0）