[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8},"actionData","errors","root",{"_108":109,"_110":-5,"_111":112,"_113":114},"routes/pages/tag.$tagName",{"_9":10,"_11":12,"_13":12,"_14":12,"_15":16,"_17":18,"_19":20,"_21":22,"_23":24,"_25":26,"_27":28},"posts",[29],"page",1,"totalPages","totalItems","perPage",12,"siteUrl","https://lazypandatech.com","routeTag","stream","canonicalUrl","https://lazypandatech.com/tag/stream","humanTag","Stream","adClient","ca-pub-2711385747041353","adSlot","3475181432",{"_30":31,"_32":33,"_34":35,"_36":37,"_38":39,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":57,"_21":58,"_59":60,"_61":62,"_63":43,"_64":65,"_66":67,"_68":43,"_69":70,"_71":72,"_73":74,"_75":51},"id","zq6ltied9ap2hja","title","Read, download or stream document from S3 using AWS Lambda and Nodejs","slug","stream-document-aws-using-nodejs","author","LazyPanda","date","2024-03-13","heroUrl","https://assets.lazypandatech.com/aws-s3-file-stream-1780737989996.png","heroAlt","","tags",[106,107,24],"body","

When building modern web applications, serving sensitive user documents directly from your server's local directory is a major security risk that also bloats your deployments. The industry standard is to retrieve these files dynamically from cloud storage on demand. In this guide, we will explore how to securely read file from s3 in aws lambda nodejs to build an efficient, serverless document-delivery pipeline.

To make this guide easier to discover and more relevant for readers, it now naturally covers aws lambda, node.js s3, s3 stream, lambda s3 stream, node s3 stream, and s3 getobject stream.

$\"amazon-s3-bucket-pdf-read\"$

Amazon Simple Storage Service (S3) is one of the oldest and most reliable services on AWS. It is a highly scalable object storage service that allows you to store and retrieve data from anywhere on the web via a secure API over HTTPS.

Our Goal: Secure File Retrieval in React

In this tutorial, we will retrieve a PDF document stored securely in an Amazon S3 bucket and download or render it inside a React client application. To bridge the frontend and storage layers securely, we will use a Node.js middleware running on AWS Lambda. This prevents us from exposing sensitive cloud credentials directly to the browser.

Step 1: Store and Upload Your Files to AWS S3

To get started, your file needs to reside in an S3 bucket. You can upload files manually through the AWS Console using drag-and-drop, or handle uploads programmatically. If you need to build a client-side upload feature, feel free to check out my previous guide on how to build a serverless backend to handle S3 uploads.

Step 2: Set Up Your Node.js and Lambda Serverless Backend

Next, we will configure a serverless Node.js backend using AWS Lambda and API Gateway. Below is a sample serverless.yml configuration to define your service, HTTP endpoints, CORS headers, and IAM permissions. Note that we grant the Lambda function s3:GetObject permissions specifically for your bucket's target directory.

service: download-file plugins: - serverless-offline - serverless-deployment-bucket custom: headers: - Content-Type provider: name: aws runtime: nodejs18.x region: ap-south-1 profile: default deploymentBucket: name: <your-deployment-bucket> serverSideEncryption: AES256 functions: readBooks: handler: <your-handler-path> events: - http: path: read-books method: post cors: true headers: '${self:custom.headers}' private: false iamRoleStatements: - Effect: Allow Action: - 's3:GetObject' Resource: 'arn:aws:s3:::publicdocument/documents/*'

To interact with AWS S3 and Lambda in your TypeScript environment, install the following required dependencies:

npm i aws-lambda @types/aws-lambda aws-sdk

When designing an architecture to serve assets, you have two primary approaches to choose from. Let's analyze both options to understand why one is vastly superior for production applications.

Option 1: Download the Complete File in Node.js (Not Recommended)

In this approach, the Lambda function fetches the entire file from S3 into memory and sends the raw buffer back to the client. If you choose a direct download s3 lambda pattern to fetch files this way, you will quickly hit severe platform bottlenecks. Consider these critical AWS Lambda constraints before choosing this path:

Lambda has a strict payload size limit of 6MB for synchronous request-response invocations.
The default Lambda function timeout is 30 seconds (and API Gateway has a hard limit of 29 seconds).
Buffering large files in memory can dramatically increase your execution costs and latency.

async servePDFStream() { const fileName = this.requestBody.fileName; const foldername = 'document'; const params = { Bucket: 'publicdocument', Key: `${foldername}/${fileName}`, }; const s3 = new AWS.S3({region: process.env.AWS_REGION}); const { Body } = await s3.getObject(params).promise(); return Body; }

Option 2: Generate an S3 Pre-signed URL (Recommended)

Instead of forcing a heavy node.js s3 operation to pipe raw data through your serverless function, a better alternative is to generate a secure, temporary S3 pre-signed URL. This URL acts as a short-lived authorization token, allowing the browser to download the file directly from S3 safely.

While a direct s3 stream works wonders for processing file content on the fly, pre-signed URLs are highly performant for direct client downloads, handle files of any size, and automatically expire after a period you define:

async servePDFStream() { const fileName = this.requestBody.fileName; const foldername = 'document'; const params = { Bucket: 'publicdocument', Key: `${foldername}/${fileName}`, }; const s3 = new AWS.S3(); const signedUrlExpireSeconds = 60 * 2; const url = s3.getSignedUrl('getObject', { Bucket: params.Bucket, Key: params.Key, Expires: signedUrlExpireSeconds }); return url; }

Important Security Note: Never bundle the aws-sdk library directly into your client-side application. To access S3 securely, your code needs your AWS Access Key ID and Secret Access Key. Storing these credentials on the client side exposes them to anyone inspecting your bundle. Always handle S3 authorization on your server-side middleware.

Step 3: Download and Render the Pre-signed URL in React

Once your React application receives the pre-signed URL from your backend API, you can download the file or load it into a document viewer. For security and control, you can fetch the file as a Blob using an XMLHttpRequest and render it using a library like PDF.js on a canvas element. This ensures the document remains secured and is not directly shareable via a standard URL copy-paste action across environments.

const downloadPDFFromURL = (url) => { const xhrObj = new XMLHttpRequest(); xhrObj.open(\"GET\", url, true); xhrObj.respblob\"; xhrObj.addEventListener(\"loadstart\", loadStartFunction, false); xhrObj.addEventListener(\"progress\", progressFunction, false); xhrObj.addEventListener(\"error\", downloadError, false); xhrObj.addEventListener(\"timeout\", downloadTimeout, false); xhrObj.addEventListener(\"abort\", downloadAbort, false); xhrObj.onreadystatechange = async (event) => { try { if (xhrObj && xhrObj.status === 400) { setloading(false); } else { if (xhrObj && xhrObj.readyState === XMLHttpRequest.DONE) { if (isMobile) { const blobData = new Blob([xhrObj.response], { type: \"application/pdf\" }); showPDFInViewer(blobData); } else { const pdfData = await convertBlobToBase64(xhrObj.response); loadPDFWithBlob(pdfData); } } } } catch (error) { console.error(\"File download exception: \", error); setloading(false); } }; xhrObj.send(null); }; const loadStartFunction = (event) => { console.log(\"File download started\"); }; const progressFunction = async (event) => { if (event.lengthComputable) { const progress = Math.round((event.loaded / event.total) * 100) + \"%\"; setprogressTxt(progress); } }; const downloadError = () => { console.log(\"Network Error!\"); }; const downloadTimeout = () => { console.log(\"Network Timeout!\"); }; const downloadAbort = () => { console.log(\"Upload Aborted!\"); }

Optimizing Performance and Access Control

Reading files directly from an Amazon S3 bucket for every single request can quickly become costly and introduce latency. While write operations must hit S3 directly, read requests for static assets can be heavily optimized using a Content Delivery Network (CDN). In this section, we will look at how to leverage Cloudflare to cache these assets efficiently.

Configure Cache Rules in Cloudflare

To prevent redundant S3 lookups, you can set up specific page or cache rules in Cloudflare:

Navigate to the Cache Rules option under the Caching tab in your Cloudflare dashboard.
Click Create Rule and configure a custom filter expression to match your document paths.
Set the Cache Eligibility to \"Bypass Cache\" if your documents require strict, real-time access control via your Lambda middleware, or configure it to eligible if you want Cloudflare to edge-cache public assets.
Configure the Browser TTL to respect the Origin TTL or override it with a custom value. If your documents rarely change, setting a longer TTL will dramatically reduce load times for your end-users.

$\"cf-cache-rule-custom\"$

Key Takeaways

Secure Your Credentials: Never bundle the AWS SDK or raw IAM credentials within your client-side React code to avoid severe security leaks.
Leverage Pre-signed URLs: Bypassing the 6MB AWS Lambda payload limit via short-lived S3 pre-signed URLs keeps your serverless functions fast and cost-effective.
Enhance Client-Side UX: Fetch documents securely as Blobs on the frontend to render them dynamically within custom viewers, preventing direct URL sharing.
Optimize with Caching: Use a CDN like Cloudflare to cache non-sensitive documents and reduce expensive S3 read operations.

Next Steps

Implementing secure file downloads doesn't have to bottleneck your system's performance. Whether you are learning how to stream files from s3 using nodejs or choosing the highly optimized pre-signed URL approach, shifting this authorization logic to serverless middleware keeps your infrastructure secure. Update your S3 CORS policies, deploy the serverless stack described above, and start delivering high-performance, secure document delivery to your users today.

Enjoy streaming!

","status","published","publishedAt","2026-06-06 09:36:26.950Z","createdBy","bvnwzsaaejxf2qp","metaDescription","Learn how to download file from s3 using aws lambda nodejs. Securely stream large files and read documents from Amazon S3 without local server storage.","keywords",[90,91,92,93,94,95,96,97,98,99],"https://lazypandatech.com/blog/stream-document-aws-using-nodejs","ogTitle","Stream and Download S3 Files Using Node.js and AWS Lambda","ogDescription","Efficiently retrieve, download, and stream large files from Amazon S3 using AWS Lambda and Node.js streams without consuming local server memory.","ogImage","twitterTitle","Stream S3 Files with AWS Lambda and Node.js Streams","twitterDescription","Avoid server bloating. Discover how to safely read, download, and stream private documents from Amazon S3 using Node.js and AWS Lambda functions.","twitterImage","jsonLd",{"_76":77,"_78":79,"_36":80,"_81":39,"_82":55,"_83":33,"_84":85,"_86":87,"_56":88,"_89":58},"relatedLinks",[],"created","2026-06-02 16:16:57.352Z","updated","@context","https://schema.org","@type","BlogPosting",{"_78":105,"_102":37},"datePublished","description","headline","image",{"_78":104,"_89":41},"isPartOf",{"_78":101,"_102":103,"_89":18},[90,91,92,93,94,95,96,97,98,99,100],"url","aws lambda","node.js s3","s3 stream","lambda s3 stream","node s3 stream","s3 getobject stream","download s3 lambda","stream s3 file","how to stream files from s3 using nodejs","stream large files from s3 using lambda","download s3 object using nodejs stream","WebSite","name","LazyPandaTech Blog","ImageObject","Person","NodeJs","AWS","commit","345d355","user","analyticsEnabled","true","ga4MeasurementId","G-T1LQ6R6VY5"]

Stream Articles

Read, download or stream document from S3 using AWS Lambda and Nodejs