Skip to content

sing-box v1.12.14.6

Choose a tag to compare

@ZhiShengYuan ZhiShengYuan released this 19 Jan 06:07
· 3453 commits to master since this release

What's New in v1.12.14.6

Multi-Output Logging System

This release introduces a comprehensive multi-output logging system with structured event support:

Core Features:

  • Multi-Output Support: Send logs to multiple destinations simultaneously (HTTP, file, stdout, stderr)
  • JSON Formatting: Structured JSON logs with full metadata capture
  • HTTP Batch Output: Batch POST logs to remote collectors with JWT authentication
  • Structured Events: Rich event data for connections, DNS queries, routing matches, and transfers
  • Backward Compatible: Legacy single-output configurations continue to work

Structured Logging:

  • ConnectionEvent: Connection lifecycle with source/destination details
  • DNSEvent: DNS queries with resolution info
  • RouterMatchEvent: Routing decisions and rule matches
  • TransferEvent: Data transfer statistics

Configuration Example:

{
  "log": {
    "level": "info",
    "outputs": [
      {
        "type": "stdout",
        "format": "formatted",
        "timestamp": true
      },
      {
        "type": "http",
        "format": "json",
        "url": "http://log-collector:8080/logs",
        "jwt_token": "eyJhbGc...",
        "batch_size": 100,
        "flush_interval": "5s",
        "hostname": "proxy-01"
      }
    ]
  }
}

Log Collector:
Separate log collector service available at: https://github.com/KexiChanProjectProxy/sing-box-log-collector

Bug Fixes

  • Fix import cycle between log and adapter packages
  • Fix structured logging fallback for non-multiOutputLogger instances

Full Changelog: v1.12.14.5...v1.12.14.6