DiagramPreview
進階預覽Live previewExportDeveloper tool

Nginx 配置視覺化

視覺化 nginx server、location、proxy_pass、upstream 关系。

範例
預覽結果就緒
预览结果会显示在这里。

下一步可以繼續

把目前預覽結果帶到相關工具,繼續轉換、排查或匯出。

設計規範產生器

產生 Markdown 設計規範、檢查交接缺漏,並以流程圖補充說明。

開啟
AI 圖表生成器

用自然語言提示詞生成 Mermaid 圖表。

開啟
Mermaid AI 修復器

用 AI 修復 Mermaid 語法並提升圖表可讀性。

開啟

使用方法

  1. 1粘贴包含 server、upstream、location 的聚焦 nginx 配置。
  2. 2检查 upstream、proxy_pass 目标,以及重复或过宽的 location。
  3. 3确认正则 location、前缀 location、兜底路由是否符合预期。
  4. 4导出图用于 PR、runbook 或交接文档。

常見場景

Nginx 路由 review反向代理文档AI nginx 配置校验入口迁移说明location 规则调试

常見問題

Nginx 图里应该优先看什么?

先看 server_name、upstream、过宽的前缀 location、正则 location,以及 proxy_pass 是否按预期保留或改写 URI。

它能模拟所有 nginx 匹配规则吗?

不能。它主要可视化常见 server/location/upstream/proxy 关系,精确运行时匹配仍应通过 nginx 或专门路由测试确认。

为什么适合检查 AI 生成配置?

AI 输出经常看起来合理但漏掉边界情况,可视化后更容易发现过宽 location、缺失 upstream 和意外 proxy 目标。

Nginx Config Visualizer 会把 server、upstream、location、proxy_pass 和路由关系画出来,不需要逐行读完整配置。

它适合检查 AI 生成 nginx 片段、迁移 review、反向代理文档,以及排查为什么某个路径被错误 location 接管。

部署到生产入口或边缘代理前,可以用图和源码一起解释路由行为。

Demo:部署前解释反向代理关系

API 网关或边缘代理 review 时,大家最关心哪个路径到哪个 upstream。图能直接展示关系,不必每个人都读 nginx 语法。

  • 多个域名共用文件时,按 server_name 分组查看。
  • 特别关注 catch-all location,它可能遮住更具体的路由。
  • 把 proxy_pass 目标和 Docker Compose/Kubernetes 服务名对照。
upstream api_backend {
  server api:8080;
}
server {
  server_name example.com;
  location /api/ { proxy_pass http://api_backend; }
  location /assets/ { root /var/www; }
}

这个示例应生成 server 节点、upstream 节点,以及 /api/ 和 /assets/ 两条路由。

调试方法:上线前检查路由优先级

Nginx 事故常来自 location 优先级、proxy header 或 rewrite 规则。预览工具应帮助你在发布前看清路径匹配顺序。

  • 对比 exact、prefix、regex location 的实际匹配优先级。
  • 后端依赖 host、scheme、client IP 时重点检查 proxy_set_header。
  • 缓存、gzip、静态资源块应和 API proxy 分开 review。
location = /health { return 200; }
location /api/ { proxy_pass http://api:8080; }
location ~* \.(js|css|png)$ { expires 30d; }

Nginx 配置視覺化 檢查清單

當你需要在文件、PR、事故復盤或交接材料發布前檢查原始內容時,可以使用 Nginx 配置視覺化。視覺化 nginx server、location、proxy_pass、upstream 关系。

匯出前建議檢查標籤是否可讀、關係是否和原始內容一致、範例是否包含敏感資訊,以及修改輸入後預覽是否仍然成立。

限制與排查

如果預覽失敗,先把輸入縮小到最小完整範例,確認格式語法,再逐段加回內容。

請把預覽結果視為 review 介面,而不是正式事實來源。進入文件或維運流程前仍需要人工確認。

可測試的範例輸入

  • Reverse proxy: server { server_name api.example.com; location / { proxy_pass http://api_backend; } } upstream api_backend { server api-1:8080; server api-2:8080; }
  • Load balance: upstream web { server web-1:3000; server web-2:3000; } server { server_name example.com; location / { proxy_pass http://web; } }
  • Static site: server { server_name docs.example.com; location / { root /usr/share/nginx/html; } }

工具完成度

進階預覽

進階解析

此工具會從開發者輸入中提取結構與關係,適合除錯與文件 review;複雜邊界仍建議回到原始碼確認。

分級不是品質分數,而是說明目前工具更適合穩定匯出、深度除錯、快速解析,或 AI 輔助生成。