Fluxheim/Tài liệu/Reverse Proxy

Reverse Proxy

Đặt Fluxheim trước máy chủ ứng dụng của bạn. Fluxheim xử lý TLS, header, giới hạn và lựa chọn upstream.

Basic proxy

[[vhosts]]
name = "app"
hosts = ["app.example.com"]

[[vhosts.routes]]
path_prefix = "/"
action = "proxy"
upstreams = ["127.0.0.1:3000"]

lựa chọn route

Tính năngDùng khi
path_exactMột URL cần một tuyến đường chính xác.
path_prefixToàn bộ cây con URL đi vào một phần phụ trợ.
strip_prefixBackend không nên nhận phần prefix công khai.
rewrite_prefixPhần phụ trợ mong đợi một tiền tố nội bộ khác.
methodsMột tuyến đường chỉ nên chấp nhận các phương thức HTTP đã chọn.

Ví dụ viết lại đường dẫn

[[vhosts.routes]]
name = "api"
path_prefix = "/api/"
strip_prefix = "/api/"
rewrite_prefix = "/internal/"

[vhosts.routes.proxy]
upstreams = ["10.0.0.20:8080"]
connect_timeout_secs = 5
read_timeout_secs = 30
send_timeout_secs = 30

CORS cho ứng dụng trình duyệt

Chỉ bật CORS khi các ứng dụng trình duyệt có nguồn gốc đã biết phải gọi tuyến đường này.

[headers.cors]
enabled = true
allow_origins = ["https://app.example.com"]
allow_methods = ["GET", "HEAD", "POST"]
allow_headers = ["authorization", "content-type"]
allow_credentials = true
max_age_secs = 600
  • Fluxheim xử lý cục bộ các yêu cầu CORS preflight hợp lệ; yêu cầu preflight bị từ chối trả về 403 mà không tới ứng dụng.
  • Không kết hợp nguồn gốc ký tự đại diện với thông tin xác thực.
  • CORS không phải là xác thực, ủy quyền hoặc bảo vệ CSRF.

Ghi chú production

  • Giữ ứng dụng trên loopback hoặc mạng riêng.
  • Đặt giới hạn request body trước khi cho phép upload.
  • Use trusted proxy settings only for networks you control.
  • Prefer explicit routes over one large fallback when different paths need different an toànty rules.
Tiếng Việt