Bài 2

proxy_pass và dấu gạch chéo

proxy_pass quyết định đường dẫn mà backend nhận được. Bài này đo bốn cách viết trên cùng một request để xem mỗi cách cho ra đường dẫn nào. Phần khó nằm ở chỗ một dấu gạch chéo ở cuối làm đổi hẳn quy tắc ghép.

Quy tắc

nginx phân biệt hai trường hợp, dựa trên việc proxy_pass có phần đường dẫn hay không:

• Không có phần đường dẫn (chỉ scheme://host:port): request URI được giữ nguyên và gửi thẳng tới backend.
• Có phần đường dẫn, kể cả khi phần đó chỉ là một dấu /: phần request URI khớp với tiền tố của location bị thay bằng phần đường dẫn đó.

Phép thay ở trường hợp thứ hai là thay chuỗi thuần. nginx không chèn thêm dấu phân cách, cũng không chuẩn hoá lại đường dẫn sau khi ghép.

Bốn cách viết, đo trên nginx thật

Bộ đo gồm hai server trong cùng một container nginx:1.27-alpine. Server sau đóng vai backend và trả về đúng $request_uri mà nó nhận, nên không phải suy đoán.

server {
    listen 8080;
    location / { default_type text/plain; return 200 "backend nhan: $request_uri\n"; }
}

server {
    listen 80;
    location /a/ { proxy_pass http://127.0.0.1:8080; }
    location /b/ { proxy_pass http://127.0.0.1:8080/; }
    location /c/ { proxy_pass http://127.0.0.1:8080/goc/; }
    location /d/ { proxy_pass http://127.0.0.1:8080/goc; }
}

Phòng thí nghiệm

Đổi cả ba ô. Thuật toán chạy trên trình duyệt là bản viết lại quy tắc ở trên, đã đối chiếu với nginx 1.27.5 trên đúng bốn dòng của bảng, khớp 4/4.

Khi location là regex

Quy tắc thay tiền tố chỉ áp dụng cho location dạng tiền tố. Với location ~ …, nginx không biết phần nào của URI là tiền tố để thay, nên proxy_pass trong khối regex không được phép có phần đường dẫn. Viết proxy_pass http://backend/api/ trong một khối regex thì nginx từ chối khởi động:

[emerg] "proxy_pass" cannot have URI part in location given by regular
expression, or inside named location, or inside "if" statement, or inside
"limit_except" block

Trong khối regex, cách làm thay thế là gán $uri bằng rewrite trước, rồi proxy_pass tới gốc không kèm đường dẫn.

Tự kiểm tra