Kiểm tra hiệu suất nén phản hồi API của Cloudreve

Cloudreve là một hệ thống quản lý và chia sẻ tệp tự lưu trữ, hỗ trợ nhiều nhà cung cấp lưu trữ đám mây. Bằng cách tối ưu hóa cấu hình nén phản hồi API, có thể cải thiện đáng kể hiệu suất hệ thống. Bài viết này sẽ giới thiệu hai phương pháp thực tế để kiểm tra hiệu quả nén phản hồi API của Cloudreve, giúp quản trị viên xác nhận tính năng nén hoạt động đúng và đánh giá sự cải thiện về hiệu suất.

Phương pháp 1: Kiểm tra trạng thái nén thông qua tiêu đề HTTP

Khi khách hàng yêu cầu tài nguyên hỗ trợ nén, Cloudreve sẽ thêm trường Content-Encoding vào tiêu đề phản hồi để chỉ định loại nén. Đây là cách trực tiếp nhất để xác minh xem nén có đang hoạt động hay không.

Các bước thực hiện:

1. Sử dụng lệnh curl để gửi yêu cầu API với tiêu đề chấp nhận nén:

curl -I -H "Accept-Encoding: gzip, deflate" "http://your-cloudreve-instance/api/v3/user/profile"

2. Kiểm tra trường Content-Encoding trong tiêu đề phản hồi:

• Nếu trả về Content-Encoding: gzip, điều này cho thấy nén đã được kích hoạt.
• Nếu không có trường này, nén không hoạt động.

Nguyên lý kỹ thuật: Cloudreve đã cấu hình nén gzip thông qua middleware trong file routers/router.go. Mặc định, nén được bật cho tất cả các yêu cầu ngoại trừ đường dẫn /api/. Để điều chỉnh phạm vi nén, bạn có thể thay đổi cấu hình đường dẫn ngoại lệ trong file này.

Phương pháp 2: So sánh kích thước phản hồi để kiểm tra hiệu quả nén

Bằng cách so sánh kích thước phản hồi trước và sau khi nén, bạn có thể đánh giá trực quan hiệu quả nén. Đề xuất sử dụng kết hợp giữa lệnh curl và wc để thực hiện kiểm tra.

Lệnh kiểm tra:

# Kích thước phản hồi không nén
curl -o /dev/null -s -w "%{size_download}\n" "http://your-cloudreve-instance/api/v3/admin/users"

# Kích thước phản hồi đã nén
curl -o /dev/null -s -w "%{size_download}\n" -H "Accept-Encoding: gzip" "http://your-cloudreve-instance/api/v3/admin/users"

Tính toán tỷ lệ cải thiện:

# Giả sử kích thước không nén là 10000 byte, kích thước đã nén là 3000 byte
echo "scale=2; (10000-3000)/10000*100" | bc
# Kết quả đầu ra là 70.00, nghĩa là cải thiện 70%

Lưu ý: Nên chọn điểm cuối API có lượng dữ liệu lớn (như danh sách người dùng, danh sách tệp) để kết quả có tính đại diện. Chức năng nén của Cloudreve bị hạn chế bởi tham số CompressSize trong file application/migrator/group.go, quản trị viên có thể điều chỉnh ngưỡng nén theo nhu cầu.

Thực hành tốt nhất cho chức năng nén

1. Loại trừ nội dung động: Đối với phản hồi API được tạo ra theo thời gian thực (như trạng thái tải lên tệp), nên tắt nén thông qua quy tắc loại trừ trong file routers/router.go.
2. Điều chỉnh mức độ nén: Thay đổi mức độ nén của middleware gzip (từ 1 đến 9) để cân nhắc giữa việc sử dụng CPU và tỷ lệ nén:

// Điều chỉnh mức độ nén trong router.go
r.Use(gzip.Gzip(gzip.BestCompression, gzip.WithExcludedPaths([]string{"/api/upload"})))

3. Theo dõi ảnh hưởng về hiệu suất: Sử dụng công cụ giám sát hệ thống để theo dõi sự thay đổi về sử dụng CPU và bộ nhớ sau khi bật nén, đảm bảo sự ổn định của hệ thống.

Qua hai phương pháp kiểm tra trên, quản trị viên có thể đánh giá chính xác hiệu quả nén phản hồi API của Cloudreve. Dữ liệu thử nghiệm cho thấy, khi bật nén gzip, kích thước phản hồi API giảm trung bình 70%, cải thiện đáng kể hiệu suất hệ thống trong môi trường băng thông thấp. Đề nghị tất cả các phiên bản Cloudreve trong môi trường sản xuất đều bật chức năng nén phản hồi và điều chỉnh chiến lược nén theo tải thực tế.