轻量级、高性能的 Go 原生日志数据库 (The SQLite for Logs)

NanoLog 是一个专为云原生设计的轻量级日志存储引擎。它不像 Elasticsearch 那样沉重，也不像 Plain Text 那样难以检索。它定位为日志界的 SQLite：单二进制文件、极致性能、内置管理面板。

• 🚀 极速启动：单二进制文件，0 运行时依赖，Docker 镜像仅约 20MB。
• 💾 列式存储：自研 .nano 格式，搭配 ZSTD 压缩，存储成本仅为原始 JSON 的 10%。
• 🔍 混合查询：内存 (MemTable) + 磁盘 (Columnar Storage) 混合检索，支持秒级逻辑查询。
• 🎨 管理面板：内嵌式 Vue 3 控制台，支持用户管理、API 密钥管理及系统配置。
• 🌐 多语言支持：原生支持中/英文切换，完美解决大屏展示与国际化需求。
• 🛡️ 安全加固 (Security at Rest)：
  • 静态加密：核心元数据 .nanolog.sys 采用 AES-GCM 算法强制加密。
  • 密码重置：内置命令行工具，支持在忘记密码时快速重置管理员权限。
  • RBAC 权限：内置角色访问控制，SuperAdmin 专属管理权限。
  • Bcrypt 散列：用户密码采用 Bcrypt 强散列，杜绝明文存储。

docker run -d \
  -p 8080:8080 \
  -v $(pwd)/data:/root/data \
  --name nanolog \
  cofferstech/nanolog:latest

git clone https://github.com/coffersTech/nanolog.git
cd nanolog/server

# 单机模式 (开发测试推荐)
./run.sh standalone --port 8080

# Console 模式 (聚合查询多个 Ingester)
./run.sh console --port 8000 --data-nodes=http://localhost:8081,http://localhost:8082

# Ingester 模式 (日志存储节点)
./run.sh ingester --port 8081 --data ./data_1

1. 系统初始化: 启动后访问 http://localhost:8080，系统会提示进入初始化模式。
2. 创建管理员: 设置第一个 SuperAdmin 账号。系统会加密保存并锁定。
3. 安全提示: 如果密钥是自动生成的，控制台会打印醒目的 WARNING。请及时备份 .nanolog.key。

从 v0.3.x 开始，任何向 /api/ingest 推送数据的请求都必须在 Header 中携带 API Key。

Header: Authorization: Bearer <YOUR_API_KEY>

# 向 Ingester 节点推送日志
curl -X POST http://localhost:8081/api/ingest \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{"level":"INFO", "msg":"Hello NanoLog"}'

1. 添加依赖:

<dependency>
    <groupId>tech.coffers</groupId>
    <artifactId>nanolog-spring-boot-starter</artifactId>
    <version>0.1.1</version>
</dependency>

2. 配置配置项:

nanolog:
  server-url: http://localhost:8080
  api-key: sk-xxxxxxx
  service: order-api

1. 安装 SDK:

pip install nanolog-sdk

2. 配置 Logger:

from nanolog import NanoLogHandler
import logging

logger = logging.getLogger("my_app")
logger.addHandler(NanoLogHandler(
    server_url="http://localhost:8080",
    api_key="sk-xxxx",
    service="my-service"
))

logger.info("Hello from Python")

1. 获取模块:

go get github.com/coffersTech/nanolog/sdks/go/nanolog

2. 使用 slog:

import (
    "log/slog"
    "github.com/coffersTech/nanolog/sdks/go/nanolog"
)

handler := nanolog.NewHandler(nanolog.Options{
    ServerURL: "http://localhost:8080",
    APIKey:    "sk-xxxx",
    Service:   "go-service",
})
logger := slog.New(handler)

logger.Info("Hello from Go")

NanoLog 提供了强大的分布式扩展能力，支持真正的读写分离，单个 console 节点可管理数十个 ingester 存储节点。V0.5.0 版本引入了 高性能 Nginx 模板，支持 Keepalive 长连接与集群域名自动注入。

docker-compose -f docker-compose-distributed.yml up -d

在启动 console 节点时，使用 --data-nodes 指定后端数据节点：

./nanolog --role=console --data-nodes="http://node-1:8080,http://node-2:8080"

将 SDK 的 server-url 直接指向任意一个 Ingester 节点以获得最高写入性能：

nanolog:
  server-url: http://localhost:8081  # 指向 Ingester 端口
  api-key: sk-xxxxxxx

项目提供了完整的分布式部署配置：

docker-compose -f docker-compose-distributed.yml up -d

端口分配：

使用 Nginx 实现路由分流与负载均衡：

upstream ingesters {
    server ingester-1:8080;
    server ingester-2:8080;
}

server {
    listen 80;
    
    # SDK 写入 → 轮询分发到 Ingester 集群
    location /api/ingest {
        proxy_pass http://ingesters;
    }
    
    # 管理 API → Console 节点
    location /api/system, /api/users, /api/tokens {
        proxy_pass http://console:8080;
    }
    
    # 聚合查询 → Console 节点
    location /api/search, /api/stats, /api/histogram {
        proxy_pass http://console:8080;
    }
    
    # Web UI → Console 节点
    location / {
        proxy_pass http://console:8080;
    }
}

nanolog:
  server-url: http://your-nginx-lb:8088  # 指向 Nginx 负载均衡器
  api-key: sk-xxxxxxx

NanoLog - 让日志存储回归简单。
如果你喜欢这个项目，请给一个 ⭐️ Star！