TopGit theo dõi nginx/nginx-s3-gateway trên GitHub trong nhóm Developer Tools, đã đạt 761 sao. NGINX S3 Gateway
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
This project provides a working configuration of NGINX configured to act as
an authenticating and caching gateway for to AWS S3 or another S3 compatible
service. This allows you to proxy a private S3 bucket without requiring users
to authenticate to it. Within the proxy layer, additional functionality can be
configured such as:
Listing the contents of a S3 bucket, with marker-based pagination for
directories holding more entries than one S3 response can carry
Providing an authentication gateway using an alternative authentication
system to S3
Caching frequently accessed S3 objects for lower latency delivery and
protection against S3 outages
For internal/micro services that can't authenticate against the S3 API
(e.g. don't have libraries available) the gateway can provide a means
to accessing S3 objects without authentication
Compressing objects (gzip, brotli) from gateway to end user
Protecting S3 bucket from arbitrary public access and traversal
Rate limiting S3 objects
Protecting a S3 bucket with a WAF
Serving static assets from a S3 bucket alongside a dynamic application
endpoints all in a single RESTful directory structure
All such functionality can be enabled within a standard NGINX configuration
because this project is nothing other than NGINX with additional configuration
that allows for proxying S3. It can be used as-is if the predefined
configuration is sufficient, or it can serve as a base example for a more
customized configuration.
If the predefined configuration does not meet your needs, it is best to borrow
from the patterns in this project and build your own configuration. For example,
if you want to enable SSL/TLS and compression in your NGINX S3 gateway
configuration, you will need to look at other documentation because this
project does not enable those features of NGINX.
Usage
This project can be run as a stand-alone container or as a Systemd service.
Both modes use the same NGINX configuration and are functionally equal in terms
features. However, in the case of running as a Systemd service, other services
can be configured that additional functionality such as certbot
for Let's Encrypt support.
Getting Started
Refer to the Getting Started Guide for how to build
and run the gateway.
Directory Structure and File Descriptions
common/ contains files used by both NGINX OSS and Plus configurations
etc/nginx/include/
awscredentials.js common library to read, cache, and fetch credentials (instance
profiles, web identity, STS AssumeRole)
awssig2.js common library to build AWS signature 2
awssig4.js common library to build AWS signature 4, for both proxied client
requests and requests the gateway originates itself
s3gateway.js common library to integrate the s3 storage from NGINX OSS and Plus
utils.js common library to be reused by all of NJS codebases
deployments/ contains files used for deployment technologies such as
CloudFormation
docs/ contains documentation about the project
examples/ contains additional `Dockerfile` examples that extend the base
configuration
jsdoc JSDoc configuration files
oss/ contains files used solely in NGINX OSS configurations
plus/ contains files used solely in NGINX Plus configurations
test/ contains the test runner scripts (run_unit_tests.sh and
run_integration_tests.sh, both driven by make), the
`make test-run` launcher run_gateway.sh, plus the njs
unit tests and bash integration tests they execute
Dockerfile.oss Dockerfile that configures NGINX OSS to act as a S3 gateway
Dockerfile.plus Dockerfile that builds a NGINX Plus instance that is configured
equivelently to NGINX OSS - instance is configured to act as a
S3 gateway with NGINX Plus additional features enabled
Dockerfile.latest-njs Dockerfile that inherits from the last build of the gateway and
then builds and installs the latest version of njs from source
Dockerfile.unprivileged Dockerfiles that inherits from the last build of the gateway and
makes the necessary modifications to allow running the container
as a non root, unprivileged user.
GNUmakefile entry point for all build, test, and lint workflows - run
`make help` for the full target list
package.json Node.js package file used only for generating JSDoc
settings.example Docker env file example
standalone_ubuntu_oss_install.sh install script that will install the gateway as a Systemd service
test.sh deprecated wrapper that forwards to the equivalent make
targets - do not invoke directly
Development
Refer to the Development Guide for more information about
extending or testing the gateway.
Contributing
Please see the contributing guide for guidelines on how to best contribute to this project.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/nginx/nginx-s3-gateway là nguồn chính thức.
nginx/nginx-s3-gateway có những chủ đề gì?
GitHub topics của nginx/nginx-s3-gateway: "docker", "gateway", "nginx", "s3". TopGit xếp repo vào nhóm Developer Tools.
nginx/nginx-s3-gateway có phải mã nguồn mở không?
Có — nginx/nginx-s3-gateway phát hành theo license Apache-2.0, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/nginx/nginx-s3-gateway.
nginx/nginx-s3-gateway có website riêng không?
TopGit chưa ghi nhận URL trang chủ cho nginx/nginx-s3-gateway. Phần README ở tab phía trên thường có link demo, hoặc xem mô tả GitHub của repo.
nginx/nginx-s3-gateway còn đang phát triển không?
Commit gần nhất trên nginx/nginx-s3-gateway là 3 ngày trước (theo timestamp GitHub). Repo có 173 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
nginx/nginx-s3-gateway dùng license gì?
nginx/nginx-s3-gateway phát hành theo license Apache-2.0. Nên mở file LICENSE trên GitHub để xác nhận — license metadata đôi khi lệch với thực tế dự án.
Đọc đầy đủ README ở tab phía trên.
Vẫn đang phân vân về nginx-s3-gateway?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về nginx-s3-gateway.
/nginx-s3-gateway
