chunkloris: bandit

published: May 22, 2026 β€’

part of the chunkloris per-chunk amplification survey. this page is the per-server record for bandit under http/1.1 chunked transfer encoding.

at a glance

  • server: bandit 1.11.1
  • runtime: erlang-otp-27.1.2 / elixir-1.17.3
  • ecosystem: beam
  • concurrency model: actor
  • parser: Bandit.HTTP1.Socket (hand-rolled, pure Elixir)
  • delivery granularity: per-chunk
  • chunk-limit helper: none exposed by the framework
  • verdict: per-chunk β€” the parser/dispatcher boundary delivers one event per wire chunk. cpu cost under paced mode b is measurable per chunk.
  • scaling exponent (mode a): 1.16 (wall time vs N, log-log slope across common cells)
  • scaling exponent (mode b): 0.98

measurements

all cells run on a 1-vcpu docker container. cpu cost is derived from the target container’s cgroup v2 cpu.stat usage_usec delta around each cell.

modeNwall (s)server cpu %Β΅s / chunkbasisok
A-bridge-coalesced50,0002.602101.552.807server-cpu-cgroupβœ“
A-bridge-coalesced100,0005.634100.556.642server-cpu-cgroupβœ“
A-bridge-coalesced250,00016.764100.167.130server-cpu-cgroupβœ“
B-paced-100us50,0005.70469.078.666server-cpu-cgroupβœ“
B-paced-100us100,00010.74565.870.746server-cpu-cgroupβœ“
B-paced-100us250,00027.63974.382.171server-cpu-cgroupβœ“

parser path β€” source citations

  • decoder β€” bandit lib/bandit/http1/socket.ex do_read_chunk!/4 + do_read_chunk_size!/3 β†’ source
  • iodata-flatten note β€” issue #4 'Improve use of iodata' β†’ source

what this means

the parser/dispatcher path on this server delivers one event per chunked-transfer-encoding chunk, so an attacker who sends a body as N one-byte chunks consumes roughly N Γ— (mode-b Β΅s/chunk) of server cpu on a single core. amplification scales linearly with N until the framework’s max_request_body_size (or equivalent) is hit.

what to do today

  • if this server runs as an origin behind nginx with the default proxy_request_buffering on, the per-chunk attack shape does not reach this server β€” nginx delivers one content-length-framed body to the upstream in a single recv().
  • if deployed direct-exposed, behind haproxy with default streaming, or behind any reverse proxy with proxy_request_buffering off, the per-chunk cost reaches this server.
  • there is no framework-level chunk-count limit in the default config; use a frontend buffer, transport-layer rate limiting, or a wrapping middleware that imposes a chunk-count cap before draining the body.

reproducer

the full reproducer for this server is in the paper repo. the docker container pins bandit 1.11.1 and constrains the test container to a single cpu (--cpus=1). the prober script implements mode a (bridge-coalesced) and mode b (paced 100 Β΅s) per the methodology section.

see the draft pdf for the full per-framework discussion.

on this page