{"id":18147241,"url":"https://github.com/hanadalee/ngx_http_unzstd_filter_module","last_synced_at":"2026-05-02T06:39:32.831Z","repository":{"id":260138342,"uuid":"880405749","full_name":"HanadaLee/ngx_http_unzstd_filter_module","owner":"HanadaLee","description":"A filter that decompresses responses with Content-Encoding: zstd for clients that do not support zstd encoding method","archived":false,"fork":false,"pushed_at":"2025-03-09T16:18:28.000Z","size":43,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-09T17:23:20.642Z","etag":null,"topics":["nginx","nginx-module","zstd","zstd-zstandard-compress-decompress"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HanadaLee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-29T17:02:37.000Z","updated_at":"2025-03-09T16:18:32.000Z","dependencies_parsed_at":"2025-03-09T17:31:20.800Z","dependency_job_id":null,"html_url":"https://github.com/HanadaLee/ngx_http_unzstd_filter_module","commit_stats":null,"previous_names":["hanadalee/ngx_http_unzstd_filter_module"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HanadaLee%2Fngx_http_unzstd_filter_module","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HanadaLee%2Fngx_http_unzstd_filter_module/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HanadaLee%2Fngx_http_unzstd_filter_module/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HanadaLee%2Fngx_http_unzstd_filter_module/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HanadaLee","download_url":"https://codeload.github.com/HanadaLee/ngx_http_unzstd_filter_module/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247553046,"owners_count":20957394,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nginx","nginx-module","zstd","zstd-zstandard-compress-decompress"],"created_at":"2024-11-01T22:06:02.799Z","updated_at":"2026-05-02T06:39:32.826Z","avatar_url":"https://github.com/HanadaLee.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Name\nngx_http_unzstd_filter_module is a filter that decompresses responses with “Content-Encoding: zstd” for clients that do not support “zstd” ([Zstandard compression](https://facebook.github.io/zstd/)) encoding method. The module will be useful when it is desirable to store data compressed to save space and reduce I/O costs.\n\n# Table of Content\n\n- [Name](#name)\n- [Table of Content](#table-of-content)\n- [Status](#status)\n- [Synopsis](#synopsis)\n- [Installation](#installation)\n- [Directives](#directives)\n  - [unzstd](#unzstd)\n  - [unzstd\\_force](#unzstd_force)\n  - [unzstd\\_buffers](#unzstd_buffers)\n- [Author](#author)\n- [License](#license)\n# Status\n\nThis Nginx module is currently considered experimental. Issues and PRs are welcome if you encounter any problems.\n\n# Synopsis\n\n```nginx\nserver {\n    listen 127.0.0.1:8080;\n    server_name localhost;\n\n    location / {\n        # enable zstd decompression for clients that do not support zstd compression\n        unzstd on;\n\n        proxy_pass http://foo.com;\n    }\n}\n```\n\n# Installation\n\nTo use theses modules, configure your nginx branch with `--add-module=/path/to/ngx_http_unzstd_filter_module`. Several points should be taken care.\n\n* You can set environment variables `ZSTD_INC` and `ZSTD_LIB` to specify the path to `zstd.h` and the path to zstd shared library represently.\n* static library will be tried prior to dynamic library, since this Nginx module uses some **advanced APIs** where static linking is recommended.\n* System's zstd bundle will be linked if `ZSTD_INC` and `ZSTD_LIB` are not specified.\n\n# Directives\n\n## unzstd\n\n**Syntax:** *unzstd on | off;*\n\n**Default:** *unzstd off;*\n\n**Context:** *http, server, location*\n\nEnables or disables decompression of zstd compressed responses for clients that lack zstd support.\n\n## unzstd_force\n\n**Syntax:** *unzstd_force string ...;*\n\n**Default:** *-*\n\n**Context:** *http, server, location*\n\nDefines the conditions for forced brotli decompression. If at least one value in the string parameter is not empty and not equal to \"0\", forced zstd decompression is performed. But it will not try to decompress responses that do not contain the response header Content-Encoding: zstd.\n\n## unzstd_buffers\n\n**Syntax:** *unzstd_buffers number size;*\n\n**Default:** *unzstd_buffers 32 4k | 16 8k;*\n\n**Context:** *http, server, location*\n\nSets the number and size of buffers used to decompress a response. By default, the buffer size is equal to one memory page. This is either 4K or 8K, depending on a platform.\n\n# Author\n\nHanada im@hanada.info\n\nThis module is based on [ngx_http_gunzip_module](https://nginx.org/en/docs/http/ngx_http_gunzip_module.html), one of nginx core modules and [ngx_unbrotli](https://github.com/clyfish/ngx_unbrotli), a nginx module for brotli decompression.\n\n# License\n\nThis Nginx module is licensed under [BSD 2-Clause License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhanadalee%2Fngx_http_unzstd_filter_module","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhanadalee%2Fngx_http_unzstd_filter_module","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhanadalee%2Fngx_http_unzstd_filter_module/lists"}