Refuse, before decoding, input libvips would not load as a source format
check / check (push) Waiting to run

govips picks the libvips loader for the input with DetermineImageType.
The image processor now names the format from that type before decoding,
and refuses with ErrUnsupportedInputFormat, answered 415, any input it
cannot name as one of the six source formats. An SVG whose first bytes
pass the first-bytes check for AVIF therefore never reaches librsvg.
orig is the format named there. README.md and TODO.md say so.

Model: opus-5-5
This commit is contained in:
2026-10-13 03:20:52 +00:00
parent d67b6d5051
commit 6241c6a425
3 changed files with 32 additions and 26 deletions
+6 -5
View File
@@ -191,10 +191,10 @@ path under `/v1/` answers 200, in maintenance mode too.
redirects to, is `localhost`, ends in `.localhost` or `.local`, or has an redirects to, is `localhost`, ends in `.localhost` or `.local`, or has an
address in a blocked network (see `blocked_networks`); 429 over address in a blocked network (see `blocked_networks`); 429 over
`image_requests_per_minute` (below); 415 when the upstream answers with a `image_requests_per_minute` (below); 415 when the upstream answers with a
`Content-Type` that is not one of the source formats (below), or for `orig` of `Content-Type` that is not one of the source formats (below), or with an image
a source pixa cannot save in its own format; 502 when the upstream answered libvips would not load as one of them; 502 when the upstream answered with an
with an error status, and for 5 minutes after that for the same source URL; error status, and for 5 minutes after that for the same source URL; 503 when
503 when pixa is busy or in maintenance mode; 500 for any other failure. pixa is busy or in maintenance mode; 500 for any other failure.
- `GET` or `HEAD` `/v1/e/<token>/<name>` — an image through an encrypted URL - `GET` or `HEAD` `/v1/e/<token>/<name>` — an image through an encrypted URL
(see Encrypted URLs). Needs: nothing but the URL. Answers: 200; 304 when (see Encrypted URLs). Needs: nothing but the URL. Answers: 200; 304 when
`If-None-Match` matches the image's `ETag`; 400 for a token that does not `If-None-Match` matches the image's `ETag`; 400 for a token that does not
@@ -265,7 +265,8 @@ once, is refused with 400.
The source image may be JPEG, PNG, GIF, WebP, AVIF or JPEG XL. The upstream's The source image may be JPEG, PNG, GIF, WebP, AVIF or JPEG XL. The upstream's
`Content-Type` must name its format, and the image's first bytes must match it. `Content-Type` must name its format, and the image's first bytes must match it.
An upstream answering with any other `Content-Type`, SVG included, is refused An upstream answering with any other `Content-Type`, SVG included, is refused
with 415. with 415, and so is an image that libvips would not load as one of these
formats, such as an SVG whose first bytes pass the check for AVIF.
With the format `auto`, pixa chooses the format for each request from its With the format `auto`, pixa chooses the format for each request from its
`Accept` header, in this order: `Accept` header, in this order:
+9 -5
View File
@@ -34,12 +34,16 @@ P2: security: per-origin rate limiting
of the source's own format (closes #68): the upstream fetch no longer accepts of the source's own format (closes #68): the upstream fetch no longer accepts
`image/svg+xml`, which libvips would render. Both image routes answer 415 for `image/svg+xml`, which libvips would render. Both image routes answer 415 for
an upstream `Content-Type` that is not one of the source formats, SVG an upstream `Content-Type` that is not one of the source formats, SVG
included, where they answered 500. `orig` of a source in a format the image included, where they answered 500. Before decoding, the image processor
processor cannot name is `ErrUnsupportedInputFormat`, also answered 415, where refuses with `ErrUnsupportedInputFormat`, also answered 415, any input that
it was saved as JPEG. `README.md` no longer lists SVG. The SVG detection in govips' `DetermineImageType`, which picks the libvips loader, does not name as
a source format. That catches an SVG whose first bytes pass the first-bytes
check for another type, as an XML comment can make them do for AVIF; an SVG
whose first bytes do not pass that check answers 500, as before. `orig` is
always the source's own format, where a source the processor could not name
was saved as JPEG. `README.md` no longer lists SVG. The SVG detection in
`internal/magic` stays: the request path does not call it, and it goes with `internal/magic` stays: the request path does not call it, and it goes with
the unused code of https://git.eeqj.de/sneak/pixa/issues/168. An SVG sent the unused code of https://git.eeqj.de/sneak/pixa/issues/168.
under another image type still fails the first-bytes check and answers 500.
- 2026-10-12 per-client limit on the image routes (closes #236): the new setting - 2026-10-12 per-client limit on the image routes (closes #236): the new setting
`image_requests_per_minute` (`PIXA_IMAGE_REQUESTS_PER_MINUTE`), default 600, `image_requests_per_minute` (`PIXA_IMAGE_REQUESTS_PER_MINUTE`), default 600,
is how many `GET` and `HEAD` requests one client may send to `/v1/image/` and is how many `GET` and `HEAD` requests one client may send to `/v1/image/` and
+17 -16
View File
@@ -137,9 +137,8 @@ var ErrInputDataTooLarge = errors.New("input data exceeds maximum allowed size")
// not supported. // not supported.
var ErrUnsupportedOutputFormat = errors.New("unsupported output format") var ErrUnsupportedOutputFormat = errors.New("unsupported output format")
// ErrUnsupportedInputFormat is returned when the requested format is orig and // ErrUnsupportedInputFormat is returned, before the input is decoded, when
// the input is in a format the processor cannot name, so it cannot be saved // libvips would not load it as one of the source formats.
// in that format.
var ErrUnsupportedInputFormat = errors.New("unsupported input format") var ErrUnsupportedInputFormat = errors.New("unsupported input format")
// ErrTooManyImages is returned when MaxConcurrentProcessing images are being // ErrTooManyImages is returned when MaxConcurrentProcessing images are being
@@ -224,6 +223,16 @@ func (p *ImageProcessor) Process(
return nil, ErrInputDataTooLarge return nil, ErrInputDataTooLarge
} }
// govips picks the libvips loader with DetermineImageType. Input it
// would not load as a source format, such as SVG, which librsvg would
// render, is refused before libvips reads it.
inputFormat := p.detectFormat(vips.DetermineImageType(data))
sourceFormat, err := p.formatFromString(inputFormat)
if err != nil {
return nil, err
}
// Decode image // Decode image
img, err := vips.NewImageFromBuffer(data) img, err := vips.NewImageFromBuffer(data)
if err != nil { if err != nil {
@@ -242,9 +251,6 @@ func (p *ImageProcessor) Process(
origWidth := img.Width() origWidth := img.Width()
origHeight := img.Height() origHeight := img.Height()
// Detect input format
inputFormat := p.detectFormat(img)
// Validate input dimensions to prevent DoS via decompression bombs // Validate input dimensions to prevent DoS via decompression bombs
if origWidth > MaxInputDimension || origHeight > MaxInputDimension { if origWidth > MaxInputDimension || origHeight > MaxInputDimension {
return nil, ErrInputTooLarge return nil, ErrInputTooLarge
@@ -261,14 +267,10 @@ func (p *ImageProcessor) Process(
} }
} }
// orig is the source's own format, and an error when the processor // orig is the source's own format; encode refuses an empty format
// cannot name it; encode refuses an empty format
outputFormat := req.Format outputFormat := req.Format
if outputFormat == FormatOriginal { if outputFormat == FormatOriginal {
outputFormat, err = p.formatFromString(inputFormat) outputFormat = sourceFormat
if err != nil {
return nil, err
}
} }
// Encode to target format // Encode to target format
@@ -412,10 +414,9 @@ func (p *ImageProcessor) acquireSlot(ctx context.Context) (func(), error) {
} }
} }
// detectFormat returns the format string from a vips image. // detectFormat returns the format string for a govips image type.
func (p *ImageProcessor) detectFormat(img *vips.ImageRef) string { func (p *ImageProcessor) detectFormat(imageType vips.ImageType) string {
format := img.Format() switch imageType {
switch format {
case vips.ImageTypeJPEG: case vips.ImageTypeJPEG:
return "jpeg" return "jpeg"
case vips.ImageTypePNG: case vips.ImageTypePNG: