跳至主要内容

Ingress 存取

適用場景​

正式環境、多人共用,需要固定網址存取。透過 Ingress 可讓團隊成員無須執行 kubectl 指令即可直接以瀏覽器開啟 K8s Sentinel 管理介面。

前置需求​

叢集需已安裝 Ingress Controller,常見選項包含:

  • nginx-ingress(ingress-nginx)
  • Traefik

請確認 Ingress Controller 已正常運作並取得外部 IP 後,再進行以下設定。

建立 Ingress 資源​

建立一個 YAML 檔案,例如 sentinel-ingress.yaml,內容如下:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: sentinel-ingress
namespace: sentinel-system
annotations:
nginx.ingress.kubernetes.io/rewrite-target: /
spec:
ingressClassName: nginx
rules:
- host: sentinel.example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: sentinel
port:
number: 80

原理: Ingress 是 Kubernetes 的 L7 路由資源,由 Ingress Controller 持續監聽(watch)Ingress 物件的異動,並自動設定 reverse proxy 規則,將外部 HTTP/HTTPS 請求路由至指定的 Service。

套用設定​

將 YAML 套用至叢集並確認資源狀態:

kubectl apply -f sentinel-ingress.yaml
kubectl get ingress -n sentinel-system

成功套用後,kubectl get ingress 輸出應顯示 sentinel-ingress 並列出對應的 host 與 Address。

設定 DNS 或 hosts​

需將 sentinel.example.com 指向 Ingress Controller 的 External IP:

# 確認 Ingress Controller 的 External IP
kubectl get svc -n ingress-nginx

# 若使用 /etc/hosts 進行本地測試(請替換為實際 IP)
echo "192.168.x.x sentinel.example.com" | sudo tee -a /etc/hosts

正式環境應在 DNS 服務商的控制台新增 A Record,將 sentinel.example.com 指向 Ingress Controller 的 External IP。

資訊

生產環境建議搭配 cert-manager 設定 TLS,自動申請與更新 Let's Encrypt 憑證,確保 HTTPS 加密傳輸。設定方式可參考 cert-manager 官方文件。

來源 IP 與登入速率限制(v0.50+)

經由 Ingress 存取時,K8s Sentinel 看到的連線來源是 Ingress Controller 而非真實用戶端。請在 Sentinel 容器設定環境變數 TRUST_PROXY_HEADERS=true,讓登入速率限制與 Audit Log 的來源 IP 改讀 X-Forwarded-For,正確反映真實用戶端位址。未設定時一律以連線本身的位址計算(安全預設,避免偽造的 XFF 繞過限流)。