Go OpenBmclAPI

Golang 版的 OpenBmclAPI

注: 本仓库部分代码按照 https://github.com/bangbang93/openbmclapi 编写, 非官方, 不保证稳定性/时效性

特性

使用协程/多线程, 超高的文件同步速度
不依赖大量的三方包, 体积小巧
静态文件, 无需配置任何依赖
得益于 Golang 强大的跨平台编译器, 支持大部分主流平台/处理器
内置一个实时更新的状态面板
支持一些小众的奇怪需求
~~更好的压榨节点~~

FAQ

Q: 没有适合我的平台的程序怎么办?
A: 检查 Go Platform Values, 如果您的系统/架构存在, 那么可以发个 issue

Q: 版本号格式
A: v<openbmclapi 版本>-<go-openbmclapi 构建计数>, 例: v1.6.7-60

安装

无依赖直接运行

从 github release 找到适合您服务器平台的程序并下载到节点服务器上
配置配置文件, 可以直接使用与bangbang93的openbmclapi相同的环境变量配置, 也可以从config.yaml进行配置 (下文有讲)
运行程序

从docker运行

可直接运行仓库目录下的docker-run.sh文件, 运行之前请确保存在craftmine/go-openbmclapi:latest镜像, 或网络连通
也可使用docker build -t craftmine/go-openbmclapi:latest .手动编译镜像

从`systemd`运行 (仅Linux)

确保systemd是您的启动进程

执行

sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/LiterMC/go-openbmclapi/HEAD/service/installer.sh)"

配置/opt/openbmclapi/config.json配置文件
使用systemctl start go-openbmclapi.service启动服务
- 使用systemctl reload go-openbmclapi.service可重新加载配置文件
- 使用systemctl stop go-openbmclapi.service停止服务
- 使用journalctl -f --output cat -u go-openbmclapi.service实时监听日志

从源代码运行

下载本仓库 (可以使用git clone https://github.com/LiterMC/go-openbmclapi.git)
确保您的服务器上装有go 1.21+
cd进入本仓库
配置配置文件或环境变量
使用go run .运行本程序

配置

使用配置文件

注意: 配置文件指定的值会被环境变量的值 (如果存在) 覆盖掉

配置文件应为运行目录下的config.yaml文件, 使用yaml格式解析
例:

# 是否打印调试日志, 默认为否
debug: false
# 是否打印访问信息, 默认为否 (这个选项对于压缩日志文件十分有用)
record_serve_info: false
# 是否禁用 https
nohttps: false
# 是否仅从主服务器下载文件
noopen: false
# 实际开放的公网主机名, 同 CLUSTER_IP
public_host: example.com
# 实际开放的公网端口, 同 CLUSTER_PUBLIC_PORT
public_port: 8080
# 要监听的本地端口, 同 CLUSTER_PORT
port: 4000
# CLUSTER_ID
cluster_id: ${CLUSTER_ID}
# CLUSTER_SECRET
cluster_secret: ${CLUSTER_SECRET}
# 文件同步间隔 (分钟)
sync_interval: 10
# 同步文件时最多打开的连接数量
download_max_conn: 64
# 连接超时限制（秒），网不好就调高点
connect_timeout: 10
# 服务器上行限制
serve_limit:
  # 是否启用上行限制
  enable: false
  # 最大连接数量
  max_conn: 16384
  # 上行速率限制 (KiB/s), 0 表示无限制
  upload_rate: 0

## 特殊要求: 重定向到 OSS
oss:
    # 是否启用该功能
    enable: false
    list:
          # 镜像文件夹路径
        - folder_path: oss_mirror
          # 镜像网络路径
          redirect_base: https://oss.example.com/base/paths
          # 跳过生成measure文件夹
          skip_measure_gen: false

## 特殊要求: 劫持 bmclapi 以加速同一局域网请求
hijack_port:
    # 是否启用该功能
    enable: false
    # 劫持代理监听的主机名
    server_host: ""
    # 劫持代理监听的端口
    server_port: 8090
    # 在该路径下生成伪bmclapi路径结构
    # 注: 该路径下为指向cache文件夹的软连接, 不会占用大量磁盘空间
    # **不建议手动修改该路径内的内容**
    path: __hijack
    # 用于绕过DNS劫持的DNS服务器 (从bmclapi同步时使用)
    anti_hijack_dns: 8.8.8.8:53

onelittlechildawa/go-openbmclapi