常见问题

解答关于 NDPR 的常见问题

基础问题

Q: NDPR 是什么？

NDPR (NDPReforged) 是一款企业级 Minecraft 服务器联合封禁系统，支持多服务器统一封禁管理。

Q: 支持哪些服务端？

服务端支持状态
MCDR 2.8+✅ 已支持
Velocity 3.0+✅ 已支持
Spigot/Paper🔄 开发中
Fabric/Forge🔄 开发中

Q: 如何获取 API Token？

  • 配置管理员密钥 (config/http_key.json)
  • 使用 Key 生成 Token：
    • Bash
    KEY_HASH=$(echo -n "admin" | sha256sum | cut -d' ' -f1) curl -X POST http://localhost:5030/token/get \ -H "Content-Type: application/json" \ -d "{\"uuid\":\"server-001\",\"mail\":\"you@example.com\",\"key\":\"$KEY_HASH\"}"

    技术问题

    Q: API 返回 401 错误？

    可能原因：

  • Token 不存在或已失效
  • Key 哈希计算错误
  • 缺少必要权限

    • 解决方法：

  • 重新生成 Token
  • 检查 Key 哈希计算
  • 授予上传权限

    • Q: 封禁数据不同步？

    检查：

  • 所有服务器是否使用相同 Token
  • 同步间隔是否合理
  • 网络连接是否正常

    • Q: 如何实现实时封禁？

  • 方案一：使用 MCDR/Velocity 插件
  • 方案二：定时轮询 v1 接口
  • 方案三：使用 Webhook（开发中）

    • Q: 支持离线模式吗？

    支持。设置 online: false 即可使用离线模式封禁：

    Bash
    curl -X POST http://localhost:5030/bans/add \ -H "Content-Type: application/json" \ -d '{"token": "your_token", "player_id": "player", "online": false}'

    部署问题

    Q: 数据库连接失败？

  • 检查 MySQL 服务是否运行
  • 验证 config/sql_config.json 配置
  • 检查数据库用户权限

    • Q: 端口被占用？

    默认端口说明
    5030API 服务
    5020v1 兼容

    修改端口：编辑对应配置文件

    Q: 如何升级 NDPR？

    Bash
    # 备份数据 # 停止服务 # 更新代码 git pull # 重启服务 python core.py

    计费与支持

    Q: NDPR 是免费的吗？

    NDPR 是开源项目，可以免费使用。

    Q: 如何获取支持？

  • GitHub Issues
  • QQ 交流群
  • Discord 频道

    • <div class="custom-block tip">

    <div class="custom-block-title">没有找到答案？</div>

    请查看 故障排除 页面或提交 Issue。

    </div>