介绍

OpenBMCLAPI是MCBBS下载源的平替，只要是玩我的世界Java版并且使用过PCL２和HMCL启动器的玩家应该都知道MCBBS下载源和OpenBMCLAPI下载源,并且在之前MCBBS关闭服务整改的时间仅有官方源与OpenBMCLAPI下载源可用,因为官方的下载源并未在境内部署镜像服务器,所以在使用官方源时往往会伴随着下载超时与无法下载的问题,此时大量的下载服务都落在OpenBMCLAPI的身上了,但是OpenBMCLAPI作为公益项目并没有那么多的资源来支持服务,所以就需要我的的加入,OpenBMCLAPI的搭建流程如下

Linux搭建教程

OpenBMCLAPI简称OBA，如果是全量节点请保证此目录的有效磁盘空间余量在200GB,并且需要安装Node.js的环境
教程开始
安装运行环境,这里推荐使用Ubuntu系统进行

apt install update
apt install Node.js

安装好Node.js之后可以选择自行编译构建运行程序或直接在Github下载已经构建完毕的程序运行

• 构建教程

    git clone https://github.com/bangbang93/openbmclapi
    #使用Git拉取项目源码
    #若没有Git可使用以下命令安装Git
    apt install git
    cd openbmclapi
    #进入openbmclapi目录
    ## 安装依赖
    npm ci
    ## 编译
    npm run build
    ## 运行
    node dist/index.js

运行后若你看见关于确实.env的报错,那么说明你编译成功了,该设置参数

CLUSTER_ID is not set

此时你需要在当前目录下创建一个名为

.env的文件

并且编辑此文件写入

CLUSTER_ID=xxx
CLUSTER_SECRET=yyy
CLUSTER_IP=somenode.example.com  # 记得修改为你的域名
CLUSTER_BYOC=true
CLUSTER_PUBLIC_PORT=4000 # 公开端口
CLUSTER_PORT=4001 # agent监听端口

此时你还需要使用Nginx开启HTTPS访问，你必须上传的SSL证书并且使用Nginx来监听端口服务和反向代理,配置文件参考如下

 server {
  server_name somenode.example.com
  listen 4000 ssl http2;
  ssl_certificate cert/cer.pem;
  ssl_certificate_key cert/key.pem;
  location / {
    proxy_pass http://localhost:4001;
  }
}

配置好你的CLUSTER_ID以及CLUSTER_SECRET和端口,Nginx服务后,使用bash run.sh来运行服务,首次开启会自动进行文件的同步,你只需再次期间登录监控面板并且绑定您的OBA即可,在文件同步完成之后会自动运行该程序.

Windows搭建教程

自主编译安装
安装所需要的运行环境
Node.js
Git

Git请前往官网安装软件包并按照官方要求就行安装
Node.js请点击Node.js下载官网选择您所对应系统的LTS版本，要求下载Node.js18以上的版本,安装程序一路Next即可.
安装完所需要的环境后找到你需要运行OpenBMCLAPI的位置后,按住Shift+鼠标右键打开Shell窗口使用cd命令进入当前目录

cd <路径>

之后我们使用Git克隆文件

git clone https://github.com/bangbang93/openbmclapi --depth=1

这是是克隆的Github上的文件,超时请使用科学上网工具或选择国内镜像站链接

git clone https://kkgithub.com/bangbang93/openbmclapi --depth=1

接下来，我们使Node.js的包管理器npm下载运行所需的依赖，依次输入并回车

npm ci
npm run build
node dist/index.js

执行完最后一条命令之后如何看到有

CLUSTER_ID is not set

字样的报错,那么就说明你的操作没有任何的问题,接下来只需要创建一个名为

.env

的文件即可,并且写入以下的内容保存

CLUSTER_ID=xxx
CLUSTER_SECRET=yyy
CLUSTER_IP=somenode.example.com  # 记得修改为你的域名
CLUSTER_BYOC=true
CLUSTER_PUBLIC_PORT=4000 # 公开端口
CLUSTER_PORT=4001 # agent监听端口

其中CLUSTER_SECRET和CLUSTER_SECRET需要您加入QQ群后找群主申请获得,保存好文件内容后,需要使用Nginx来进行代理和HTTPS服务,推荐使用宝塔面板来进行操作,登录你的BT面板后,找到网站,然后新建PHP网站,域名则填写

你的域名:你的公开端口

然后保存创建网站,之后点击SSL上传你的证书,不要打开强制HTTPS选项，之后找到配置文件找到listen 443 ssl http2 ;修改成listen 80 ssl http2 ;把listen 80;修改成listen #你的公开端口;之后选择反向代理,添加返现代理目标URL填写

127.0.0.1:你的监听端口

发送域名填写

127.0.0.1:公开端口

最后关闭缓存,然后保存并且开启就好了,返回到目录创建一个名为

start.bat

的文件并且打开修改内容为

@echo off
title OpenBMCLAPI
node dist/index.js

最后保存,双击执行即可完成运行,来运行服务,首次开启会自动进行文件的同步,你只需再次期间登录监控面板并且绑定您的OBA即可,在文件同步完成之后会自动运行该程序.