You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Readme.md
+5-1Lines changed: 5 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -104,6 +104,8 @@ The above command installs a specified version of imgproxy.
104
104
|**features.server.customRequestHeaders**|`PRO:` list of custom headers that imgproxy will send while requesting the source image, divided by `\;` (can be redefined by IMGPROXY_CUSTOM_HEADERS_SEPARATOR)||
105
105
|**features.server.customResponseHeaders**|`PRO:` list of custom response headers, divided by \; (can be redefined by IMGPROXY_CUSTOM_HEADERS_SEPARATOR)||
106
106
|**features.server.customHeadersSeparator**|`PRO:` string that will be used as a custom headers separator|`\;`|
107
+
|**features.server.requestHeadersPassthrough**|`PRO:` A comma separated list of names of incoming request headers|``|
108
+
|**features.server.requestHeadersPassthrough**|`PRO:` A comma-separated list of names of source image response headers|``|
107
109
|**features.server.enableDebugHeaders**|when true, imgproxy will add X-Origin-Content-Length header with the value is size of the source image.|`false`|
108
110
|**features.server.name**|`PRO:` The Server header value.|`imgproxy`|
109
111
@@ -146,7 +148,7 @@ The above command installs a specified version of imgproxy.
146
148
|**features.compression.gifOptimizeFrames**|`PRO:` when true, enables GIF frames optimization; this may produce a smaller result, but may increase compression time|`false`|
147
149
|**features.compression.gifOptimizeTransparency**|`PRO:` when true, enables GIF transparency optimization; this may produce a smaller result, but may increase compression time|`false`|
148
150
|**features.compression.webpCompression**|`PRO:` The compression method to use. Supported values are lossy, near_lossless, and lossless|`lossy`|
149
-
|**features.compression.avifSpeed**|controls the CPU effort spent improving compression (0-8).|`8`|
151
+
|**features.compression.avifSpeed**|controls the CPU effort spent improving compression (0-8).|`9`|
150
152
151
153
### Detection of WEBP/Avif Support by Browsers
152
154
@@ -344,11 +346,13 @@ The above command installs a specified version of imgproxy.
344
346
|Value|Description|Default|
345
347
|-----|-----------|-------|
346
348
|**features.miscellaneous.baseUrl**|base URL part which will be added to every requestsd image URL.||
349
+
|**features.miscellaneous.urlReplacements**|A list of pattern=replacement pairs, semicolon (;) divided.||
347
350
|**features.miscellaneous.useLinearColorspace**|when true, imgproxy will process images in linear colorspace. This will slow down processing. Note that images won’t be fully processed in linear colorspace while shrink-on-load is enabled (see below)|`false`|
348
351
|**features.miscellaneous.disableShrinkOnLoad**|when true, disables shrink-on-load for JPEG and WebP. Allows to process the whole image in linear colorspace but dramatically slows down resizing and increases memory usage when working with large images|`false`|
349
352
|**features.miscellaneous.stripMetadata**|when true, imgproxy will strip all metadata (EXIF, IPTC, etc.) from JPEG and WebP output images.|`true`|
350
353
|**features.miscellaneous.stripColorProfile**|when `true`, imgproxy will transform the embedded color profile (ICC) to sRGB and remove it from the image.|`true`|
351
354
|**features.miscellaneous.keepCopyright**|when true, imgproxy will not remove copyright info while stripping metadata.|`true`|
355
+
|**features.miscellaneous.stripMetadataDPI**|The DPI metadata value that should be set for the image when its metadata is stripped.|`72.0`|
352
356
|**features.miscellaneous.autoRotate**|when `true`, imgproxy will auto rotate images based on the EXIF Orientation parameter (if available in the image meta data).|`true`|
353
357
|**features.miscellaneous.enforceThumbnail**|When `true` and the source image has an embedded thumbnail, imgproxy will always use the embedded thumbnail instead of the main image.|`false`|
354
358
|**features.miscellaneous.returnAttachment**|when true, response header Content-Disposition will include attachment.|`false`|
Copy file name to clipboardExpand all lines: imgproxy/README.md
+5-1Lines changed: 5 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -107,6 +107,8 @@ The above command installs a specified version of imgproxy.
107
107
|**features.server.customRequestHeaders**|`PRO:` list of custom headers that imgproxy will send while requesting the source image, divided by `\;` (can be redefined by IMGPROXY_CUSTOM_HEADERS_SEPARATOR)||
108
108
|**features.server.customResponseHeaders**|`PRO:` list of custom response headers, divided by \; (can be redefined by IMGPROXY_CUSTOM_HEADERS_SEPARATOR)||
109
109
|**features.server.customHeadersSeparator**|`PRO:` string that will be used as a custom headers separator|`\;`|
110
+
|**features.server.requestHeadersPassthrough**|`PRO:` A comma separated list of names of incoming request headers|``|
111
+
|**features.server.requestHeadersPassthrough**|`PRO:` A comma-separated list of names of source image response headers|``|
110
112
|**features.server.enableDebugHeaders**|when true, imgproxy will add X-Origin-Content-Length header with the value is size of the source image.|`false`|
111
113
112
114
### Imgproxy Security Settings
@@ -156,7 +158,7 @@ The above command installs a specified version of imgproxy.
156
158
|**features.compression.gifOptimizeFrames**|`PRO:` when true, enables GIF frames optimization; this may produce a smaller result, but may increase compression time|`false`|
157
159
|**features.compression.gifOptimizeTransparency**|`PRO:` when true, enables GIF transparency optimization; this may produce a smaller result, but may increase compression time|`false`|
158
160
|**features.compression.webpCompression**|`PRO:` The compression method to use. Supported values are lossy, near_lossless, and lossless|`lossy`|
159
-
|**features.compression.avifSpeed**|controls the CPU effort spent improving compression (0-8).|`8`|
161
+
|**features.compression.avifSpeed**|controls the CPU effort spent improving compression (0-8).|`9`|
@@ -381,11 +383,13 @@ The above command installs a specified version of imgproxy.
381
383
|Value|Description|Default|
382
384
|-----|-----------|-------|
383
385
|**features.miscellaneous.baseUrl**|base URL part which will be added to every requestsd image URL.||
386
+
|**features.miscellaneous.urlReplacements**|A list of pattern=replacement pairs, semicolon (;) divided.||
384
387
|**features.miscellaneous.useLinearColorspace**|when true, imgproxy will process images in linear colorspace. This will slow down processing. Note that images won’t be fully processed in linear colorspace while shrink-on-load is enabled (see below)|`false`|
385
388
|**features.miscellaneous.disableShrinkOnLoad**|when true, disables shrink-on-load for JPEG and WebP. Allows to process the whole image in linear colorspace but dramatically slows down resizing and increases memory usage when working with large images|`false`|
386
389
|**features.miscellaneous.stripMetadata**|when true, imgproxy will strip all metadata (EXIF, IPTC, etc.) from JPEG and WebP output images.|`true`|
387
390
|**features.miscellaneous.stripColorProfile**|when `true`, imgproxy will transform the embedded color profile (ICC) to sRGB and remove it from the image.|`true`|
388
391
|**features.miscellaneous.keepCopyright**|when true, imgproxy will not remove copyright info while stripping metadata.|`true`|
392
+
|**features.miscellaneous.stripMetadataDPI**|The DPI metadata value that should be set for the image when its metadata is stripped.|`72.0`|
389
393
|**features.miscellaneous.autoRotate**|when `true`, imgproxy will auto rotate images based on the EXIF Orientation parameter (if available in the image meta data).|`true`|
390
394
|**features.miscellaneous.enforceThumbnail**|When `true` and the source image has an embedded thumbnail, imgproxy will always use the embedded thumbnail instead of the main image.|`false`|
391
395
|**features.miscellaneous.returnAttachment**|when true, response header Content-Disposition will include attachment.|`false`|
# If enabled then the IAM Role is used for the authentication
862
+
# ENV['IMGPROXY_S3_ASSUME_ROLE_ARN']
863
+
# (3.17+) The AWS IAM Role to Assume
853
864
iamRoleName: ""
854
865
855
866
# ENV['IMGPROXY_S3_REGION']
@@ -1174,6 +1185,14 @@ features:
1174
1185
# base URL prefix that will be added to every requested image URL. For example, if the base URL is `http://example.com/images` and `/path/to/image.png` is requested, imgproxy will download the source image from `http://example.com/images/path/to/image.png`.
1175
1186
baseUrl: ""
1176
1187
1188
+
# ENV['IMGPROXY_URL_REPLACEMENTS']
1189
+
# (3.17+) A list of pattern=replacement pairs, semicolon (;) divided.
1190
+
# imgproxy will replace source URL prefixes matching the pattern with the corresponding replacement.
1191
+
# Wildcards can be included in patterns with * to match all characters except /.
1192
+
# ${N} in replacement strings will be replaced with wildcard values, where N is the number of the wildcard.
1193
+
# See examples at https://docs.imgproxy.net/configuration?id=source-image-urls
1194
+
urlReplacements: ""
1195
+
1177
1196
# ENV['IMGPROXY_USE_LINEAR_COLORSPACE']
1178
1197
# when `true`, imgproxy will process images in linear colorspace. This will slow down processing. Note that images won't be fully processed in linear colorspace while shrink-on-load is enabled (see below).
1179
1198
useLinearColorspace: false
@@ -1190,6 +1209,10 @@ features:
1190
1209
# (v3.5+) When `true`, imgproxy will not remove copyright info while stripping metadata. Default: `true`
1191
1210
keepCopyright: true
1192
1211
1212
+
# ENV['IMGPROXY_STRIP_METADATA_DPI']
1213
+
# (v3.18+, Pro) The DPI metadata value that should be set for the image when its metadata is stripped. Default: 72.0
1214
+
stripMetadataDPI: 72.0
1215
+
1193
1216
# ENV['IMGPROXY_STRIP_COLOR_PROFILE']
1194
1217
# when `true`, imgproxy will transform the embedded color profile (ICC) to sRGB and remove it from the image. Otherwise, imgproxy will try to keep it as is.
0 commit comments