aoirint_mcping_server

简介

aoirint_mcping_server 是一个用于监控 Minecraft 服务器状态的工具，支持 Bedrock 和 Java 版本(1.20.x)，提供 HTTP JSON API 接口。

主要功能

• 监控多个 Minecraft 服务器状态
• 数据持久化到 PostgreSQL
• 带认证的 Web API（读/写权限分离）

快速部署

使用 Docker Compose

1. 准备环境：

   # 复制配置文件
   cp template.env .env
   # 编辑配置
   nano .env
   

2. 启动服务：

   docker compose up -d
   

3. 应用数据库迁移：

   docker compose run --rm migrate -path=/migrations -database="postgres://postgres:postgres_password@postgres:5432/postgres?sslmode=disable" up
   

开发相关

环境要求

• Python 3.12
• Poetry 包管理器

代码格式化

poetry run ruff check --fix
poetry run ruff format
poetry run mypy .

Docker 镜像

• aoirint/aoirint_mcping_server_web_api
• aoirint/aoirint_mcping_server_java_updater
• aoirint/aoirint_mcping_server_bedrock_updater

---

更多详细信息请参考完整文档或查看 Docker Hub 页面。