Trong hướng dẫn này, chúng ta sẽ đi qua quản lý session trong ứng dụng Next.js sử dụng Upstash Redis bằng cách học "session" nghĩa là gì trong ứng dụng web, tại sao Redis là lựa chọn đầu tiên cho quản lý session, cách thiết lập cơ sở dữ liệu Upstash Redis, và cuối cùng, cách tích hợp nó vào ứng dụng Next.js.
“Session” Là Gì?
Trong một ứng dụng web, “session” là một cơ chế lưu trữ phía máy chủ tạm thời được sử dụng để duy trì trạng thái tương tác của người dùng với ứng dụng qua nhiều yêu cầu HTTP trong một khoảng thời gian nhất định.
Vì HTTP là một giao thức không trạng thái (stateless), nghĩa là mỗi yêu cầu độc lập và không "nhớ" các tương tác trước đó, session cho phép máy chủ theo dõi và lưu trữ dữ liệu đặc thù của người dùng như trạng thái xác thực, tùy chọn, hoặc bất kỳ loại hoạt động nào của người dùng trong thời gian họ ở trên trang web.
Session thường hoạt động bằng cách lưu trữ một session ID duy nhất phía client, thường trong cookie. Máy chủ sử dụng ID này để truy xuất dữ liệu liên quan đến session của người dùng từ kho lưu trữ session, như Redis trong blog này, mỗi khi người dùng tương tác với trang web.
Session trong ứng dụng web là một cách tuyệt vời để xử lý các tương tác và quản lý trạng thái người dùng sau đây:
- Xác Thực Người Dùng: Session giúp xác thực người dùng và ghi nhớ trạng thái đăng nhập của họ qua các trang hoặc thậm chí sau khi làm mới.
- Cá Nhân Hóa: Session cho phép máy chủ lưu trữ và truy xuất dữ liệu như tùy chọn người dùng, trạng thái xác thực, v.v.
- Bảo Mật: Quản lý session đúng cách có thể tăng cường bảo mật ứng dụng, như bảo vệ chống CSRF và đảm bảo người dùng không được ủy quyền không truy cập các khu vực bị hạn chế.
Tại Sao Redis Cho Quản Lý Session?
Tại sao không :)
Có nhiều lý do để sử dụng Redis làm kho lưu trữ session cho quản lý session. Dưới đây là một số lợi ích xuất phát từ cấu trúc của Redis:
-
Kiến Trúc Dữ Liệu: Redis là kho khóa-giá trị (key-value store) trong bộ nhớ. Các cặp khóa-giá trị có thể được lưu trữ trong hash, nơi hash là kiểu bản ghi được cấu trúc như một tập hợp các cặp trường-giá trị. Cấu trúc này hoàn hảo phù hợp với kiểu dữ liệu quản lý session để duy trì tất cả dữ liệu session, như tên người dùng, tùy chọn người dùng v.v. theo định dạng khóa-giá trị trong một hash cho mỗi session người dùng.
-
Hết Hạn Dữ Liệu: Redis có chức năng tích hợp sẵn để xóa dữ liệu hết hạn. Điều này giúp các ứng dụng web giữ các session người dùng bị giới hạn bởi thời gian.
-
Độ Trễ Thấp: Do bản chất "trong bộ nhớ" của nó, Redis cực kỳ nhanh. Đó là lý do nó thường được dùng cho session người dùng và dữ liệu cache.
-
Khả Năng Mở Rộng: Redis được xây dựng để xử lý khối lượng dữ liệu lớn và lưu lượng thông lượng cao.
Ngoài ra, chúng ta có thể đơn giản so sánh Redis với một trong những cách phổ biến nhất để lưu trữ dữ liệu session người dùng, cookie phía client, để quyết định cách nào chúng ta muốn theo dõi trong ứng dụng web. Một số lợi thế của Redis làm kho lưu trữ session so với cookie phía client:
-
Ít dễ bị can thiệp bởi người dùng hơn: Cookie hiển thị cho người dùng và có thể bị thao túng bởi người dùng. Redis cho phép chúng ta bảo vệ dữ liệu người dùng khỏi bị thao túng bởi người dùng.
-
Ít dữ liệu chuyển giữa client và server hơn: Vì chúng ta lưu trữ tất cả thông tin session trong Redis, chúng ta không cần lưu trữ bất cứ thứ gì trên máy client.
-
Chỉ lưu "SessionId" trên máy client: Nếu chúng ta dùng Redis, chúng ta chỉ cần sessionId để lấy cho mỗi yêu cầu để biết yêu cầu này thuộc session nào.
Tạo Cơ Sở Dữ Liệu Upstash Redis
Trước khi nhảy vào thiết lập Upstash Redis, chúng ta nên trước tiên hiểu lợi ích của Upstash Redis. Không có ý nghĩa gì khi sử dụng các công cụ chúng ta sẽ dùng nếu không hiểu tại sao chúng nên được dùng, đúng không?
Hãy xem các lợi ích chính của việc sử dụng Upstash Redis:
-
Không máy chủ (Serverless): Upstash Redis là cơ sở dữ liệu không máy chủ. Bạn không cần duy trì cơ sở hạ tầng, lo lắng về việc mở rộng cơ sở dữ liệu hoặc bất kỳ cấu hình cấp thấp nào. Bạn chỉ cần tạo cơ sở dữ liệu và sử dụng nó.
-
Phân Phối Dữ Liệu Toàn Cầu: Upstash cho phép bạn triển khai instance Redis ở các khu vực gần người dùng của bạn, giảm độ trễ thậm chí hơn nữa. Điều này đặc biệt có lợi cho các ứng dụng phân bố toàn cầu, đảm bảo kho lưu trữ session nhanh và phản hồi tốt bất kể vị trí của người dùng.
-
Trả Theo Sử Dụng (Pay as you Go): Không có giá nhập môn. Bạn chỉ trả cho những gì bạn dùng. Bạn có thể xem chi tiết giá cả.
Ổn, nếu chúng ta không còn câu hỏi nào về tại sao dùng Upstash Redis cho quản lý session, chúng ta có thể tạo cơ sở dữ liệu Upstash Redis.
Chúng ta sẽ tạo cơ sở dữ liệu Redis thông qua bảng điều khiển Upstash.
Hãy tạo cơ sở dữ liệu Redis bằng cách nhấp nút “Create Database”. Hướng dẫn này sẽ chỉ lại một lần nữa việc tạo cơ sở dữ liệu Upstash Redis dễ dàng và nhanh như thế nào.
Trong modal xuất hiện, chúng ta sẽ chọn tên cho cơ sở dữ liệu và chọn khu vực cho nó. Có thể tốt hơn nếu chọn cùng khu vực với dịch vụ của bạn.
Sau khi nhấp nút next, chúng ta sẽ chọn gói định giá. Pay as you go với giới hạn ngân sách tối đa là yêu thích của tôi!
Bây giờ, cơ sở dữ liệu Redis của chúng ta đã sẵn sàng. Chúng ta có thể thấy endpoint cơ sở dữ liệu, mật khẩu để kết nối và cổng của nó trên bảng điều khiển Redis. Chúng ta sẽ cần thông tin này khi muốn kết nối đến cơ sở dữ liệu từ ứng dụng web.

Đó là xong!
Sử Dụng Upstash Redis Trong Ứng Dụng Nextjs
Hãy xem Redis sẽ hoạt động như thế nào trong cơ sở hạ tầng ứng dụng web:
-
Chúng ta trước tiên nhận yêu cầu từ trình duyệt client không có sessionId.
-
Vì không có sessionId trong yêu cầu, chúng ta tạo một sessionId và tạo một hash trong Redis.
-
Trả về sessionId dưới dạng cookie trong phản hồi đến máy client.
-
Khi nhận được yêu cầu HTTP mới với sessionId, chúng ta truy xuất dữ liệu session cần thiết từ Redis và sử dụng nó khi phản hồi cho client.
Đây là sơ đồ trình tự của dịch vụ và kết nối của nó với Redis để trực quan hóa quy trình tốt hơn:

Nếu mọi thứ ổn, chúng ta có thể tạo ứng dụng Nextjs bằng cách chạy lệnh sau trong terminal trừ khi bạn đã có ứng dụng Nextjs.
npx create-next-app@latest <project-name>
Bây giờ chúng ta cần cài đặt SDK TypeScript Upstash Redis.
cd <project-name> npm install @upstash/redis
Sau khi cài đặt phụ thuộc cần thiết, chúng ta có thể tạo một interface để quản lý session ID trong cookie của trình duyệt người dùng và tương tác với Upstash Redis, kho lưu trữ session của ứng dụng.
Chúng ta sẽ triển khai interface này trong tệp /app/lib/sessionManager.tsx.
import { Redis } from '@upstash/redis' import { cookies } from 'next/headers' export const redis = new Redis({ url: '<UPSTASH-REDIS-URL>', token: 'UPSTASH-REDIS-TOKEN', }) type SessionId = string; type Key = 'userName' | 'sessionStatus'; // other keys of the session data can be added. export async function getSessionId(): SessionId | undefined { const cookieStore = await cookies(); return cookieStore.get("session-id")?.value; } async function setSessionId(sessionId: SessionId): void { const cookieStore = await cookies(); cookieStore.set("session-id", sessionId); } export async function getSessionIdAndCreateIfMissing() { const sessionId = await getSessionId(); if (!sessionId) { const newSessionId = crypto.randomUUID(); await setSessionId(newSessionId); return newSessionId; } return sessionId; } export async function get(key: Key, username: string = "") { const sessionId = await getSessionId(); if (!sessionId) { return null; } return await redis.hget(`session-${username}-${sessionId}`, key); } export async function getAll(username: string = "") { const sessionId = await getSessionId(); if (!sessionId) { return null; } return await redis.hgetall(`session-${username}-${sessionId}`); } export async function set(key: Key, value: string, username: string = "") { const sessionId = await getSessionIdAndCreateIfMissing(); await redis.hset(`session-${username}-${sessionId}`, { [key]: value }); return redis.expire(`session-${username}-${sessionId}`, 900); }
Hãy kiểm tra các hàm này.
-
getSessionId: Chúng ta sẽ lưu session ID trong cookie của trình duyệt người dùng. Hàm này để lấy session ID từ cookie trình duyệt được gửi đến API bên trong cuộc gọi HTTP.
-
setSessionId: Hàm này đặt cookie session ID thành session ID tham số cho trước.
-
getSessionIdAndCreateIfMissing: Hàm này gọi
getSessionIdđể lấy session ID hiện có từ cookie và đặt UUID ngẫu nhiên mới làm session ID mới trừ khi đã có session ID trong trình duyệt của người dùng. Hàm này cũng thêm session ID mới vào cookie để gửi trả về trình duyệt. -
getSessionData: Chúng ta sẽ gọi hàm này để lấy dữ liệu session từ Redis. Nó sẽ lấy dữ liệu session của khóa cho trước từ Upstash Redis và trả về nó.
-
getAllSessionData: Hàm này lấy tất cả dữ liệu session. Nó lấy tất cả các cặp khóa-giá trị của hash session từ Upstash Redis.
-
setSessionData: Chúng ta sẽ đặt các cặp khóa-giá trị của session cho trước trong hàm này.
Vì các hàm tiện ích để quản lý session ID và lưu trữ session qua Upstash Redis, chúng ta có thể triển khai một API sử dụng các hàm này.
API sẽ rất đơn giản. Nó sẽ nhận username từ path. Khi nhận được yêu cầu, nó sẽ trước tiên kiểm tra xem session ID có tồn tại trong cookie không. Nếu không có session ID trong cookie, nó sẽ tạo ID mới và đặt nó trong cookie trong phản hồi. Nếu session ID tồn tại, nó sẽ kiểm tra xem có khóa nào trong Upstash Redis trong hash đại diện cho session không. Nếu không có, nó sẽ tạo các cặp khóa-giá trị trong hash đó.
Hãy code!
API sẽ được tạo bằng cách sử dụng app routers của Nextjs.
Chúng ta nên tạo tệp dưới app/api/user/[username]namedroute.tsx`.
import * as sessionStore from '../../lib/session' export async function GET(request: Request,{ params }: { params: Promise<{ user: string }> }){ const userName = (await params).user; const sessionId = await sessionStore.getSessionIdAndCreateIfMissing(); const sessionStatus = await sessionStore.get('sessionStatus', userName); if(sessionStatus == null) { console.log('There is no active session.'); await sessionStore.set('sessionStatus', 'ACTIVE', userName); } return Response.json({ userName: userName, sessionId: sessionId }); }
Tệp route này sẽ cho phép Nextjs giải quyết yêu cầu được gửi đến <URL>:3000/api/user/<username> đến các phương thức HTTP được định nghĩa bên trong nó.
Bây giờ, chúng ta sẽ thấy nó hoạt động. Hãy chạy ứng dụng Nextjs bằng cách đi đến thư mục gốc từ terminal và chạy lệnh sau:
npm run dev
Bây giờ, chúng ta có thể mở endpoint API, https://localhost:3000/api/user/noah trên trình duyệt. Khi bạn mở nó, bạn nên thấy username và session ID được trả về:
{"userName":"noah","sessionId":"804814dc-10fc-4b0a-a4c1-321f4b54d399"}
Nếu bạn chuột phải và kiểm tra, bạn sẽ thấy session-id được đặt trong cookie bằng cách vào tab “Application”.

Chúng ta cũng có thể kiểm tra Upstash Redis xem session có được tạo trong cơ sở dữ liệu hay không. Để kiểm tra, chúng ta nên quay lại bảng điều khiển Upstash Redis, mở cơ sở dữ liệu Redis và mở tab Data Browser.
Tab Data Browser sẽ hiển thị dữ liệu session như hình dưới.

Kết Luận
Quản lý session trong ứng dụng Next.js với Upstash Redis cung cấp một giải pháp có khả năng mở rộng và hiệu quả. Trong bài blog này, chúng ta đã tạo ứng dụng Nextjs và tích hợp nó với Upstash Redis để sử dụng nó làm kho lưu trữ quản lý session.
Bằng cách thiết lập cơ sở dữ liệu Redis và tích hợp nó liền mạch với Next.js, bạn có thể xử lý lưu trữ session hiệu quả mà không có các phức tạp phía máy chủ truyền thống. Cách tiếp cận này lý tưởng cho các nhà phát triển tìm kiếm hiệu suất và đơn giản trong quản lý session.
Hy vọng hướng dẫn này đã cung cấp một lộ trình rõ ràng để triển khai Upstash Redis như một kho lưu trữ session tin cậy trong ứng dụng Next.js của bạn.