qubiccore/bob

Qubic Bob

Qubic Bob 是 Qubic网络 的高性能索引器。它从节点同步tick数据，通过共识和日志事件验证完整性，索引***状态，并通过以下方式暴露数据：

• 🔌 JSON-RPC 2.0 API（HTTP & WebSocket）——类***设计，适用于交易所、dApp和区块浏览器。
• 🌐 REST API——适用于偏好普通HTTP的工具。
• 📡 WebSocket订阅——实时 tickStream、newTicks、logs、transfers。

此镜像在单个容器中集成了 bob + KeyDB + Kvrocks——无需安装额外服务。

---

🚀 快速开始

单行命令

bash
docker run -d --name qubic-bob \
  -p 21842:21842 \
  -p 40420:40420 \
  -e NODE_SEED=your_55_char_lowercase_seed_a_z_only_padded_to_55chars \
  -v qubic-bob-redis:/data/redis \
  -v qubic-bob-kvrocks:/data/kvrocks \
  -v qubic-bob-data:/data/bob \
  qubiccore/bob:latest

Docker Compose

yaml
services:
  qubic-bob:
    image: qubiccore/bob:latest
    container_name: qubic-bob
    restart: unless-stopped
    ports:
      - "21842:21842"     # P2P端口
      - "40420:40420"     # JSON-RPC / REST / WebSocket端口
    environment:
      NODE_SEED: your_55_char_lowercase_seed_a_z_only_padded_to_55chars
      NODE_ALIAS: my-bob-node
      # 完整环境变量列表见docs/DOCKER_ENV.md
    volumes:
      - qubic-bob-redis:/data/redis
      - qubic-bob-kvrocks:/data/kvrocks
      - qubic-bob-data:/data/bob

volumes:
  qubic-bob-redis:
  qubic-bob-kvrocks:
  qubic-bob-data:

验证运行状态

bash
# 启动后等待约30秒，然后执行：
curl -s http://localhost:40420/status | jq
curl -s -X POST http://localhost:40420/qubic \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"qubic_getTickNumber","params":[],"id":1}'

---

📦 可用标签

各版本变更说明见 https://github.com/qubic/core-bob/blob/master/RELEASE_NOTES.md%E3%80%82

---

🖥️ 系统要求

Bob在繁忙网络中对内存需求较高。KeyDB会将近期tick数据保存在内存中，之后迁移到磁盘上的Kvrocks；如果网络吞吐量超过 REDIS_MAXMEMORY，日志中会出现 OOM command not allowed when used memory > maxmemory 错误。详见下方 负载下的调优。

---

🔌 API端点

常用JSON-RPC方法

完整参考：https://github.com/qubic/core-bob/blob/master/docs/QUBIC_JSON_RPC.md · https://github.com/qubic/core-bob/blob/master/docs/REST_API.md · https://gistpreview.github.io/?6912d613bc27ae75126859447fca8acf

---

⚙️ 配置

两种配置方式，按优先级排序：

1. 环境变量（推荐）——完整的39个支持变量见 https://github.com/qubic/core-bob/blob/master/docs/DOCKER_ENV.md%E3%80%82
2. 挂载自定义 bob.json——适用于环境变量不足以满足需求的高级场景。

最常用环境变量

自定义bob.json

bash
docker run -d --name qubic-bob \
  -p 21842:21842 -p 40420:40420 \
  -v ./bob.json:/app/bob.json \
  -v qubic-bob-redis:/data/redis \
  -v qubic-bob-kvrocks:/data/kvrocks \
  -v qubic-bob-data:/data/bob \
  qubiccore/bob:latest

⚠️ 不要对bob.json挂载使用 :ro——入口点在启动时会修补该文件。

完整bob.json参考：https://github.com/qubic/core-bob/blob/master/docs/CONFIG_FILE.MD%E3%80%82

---

💾 卷

无卷的新容器每次重启都会从头开始——适合开发，不适合守护者节点或生产环境索引器。

---

🛠️ 负载下的调优

如果出现 Failed to add log ... OOM command not allowed：

Bob大约每分钟记录一次 KeyDB memory: <已用> / <最大> (XX%) 日志，当使用率超过85%时会立即记录——这是内存压力最清晰的信号。

---

🔧 故障排除

---

🧑‍💻 开发者信息

• 源代码：https://github.com/qubic/core-bob
• 问题跟踪：https://github.com/qubic/core-bob/issues
• 发布：https://github.com/qubic/core-bob/blob/master/RELEASE_NOTES.md · https://github.com/qubic/core-bob/releases
• 从源码构建：见 https://github.com/qubic/core-bob/blob/master/README.md

容器内部操作

bash
# 查看生效配置
docker exec qubic-bob jq . /app/bob.json
docker exec qubic-bob cat /etc/redis/redis.conf
docker exec qubic-bob cat /etc/kvrocks/kvrocks.conf

# 直接操作KeyDB / Kvrocks
docker exec qubic-bob redis-cli ping            # KeyDB（端口6379）
docker exec qubic-bob redis-cli -p 6666 ping    # Kvrocks（端口6666）

# 跟踪bob日志
docker logs -f qubic-bob

---

由Qubic Bob团队精心打造。特别感谢 https://github.com/krypdkat 提供的原始qubicbob项目基础。