Nginx反向代理实战：如何将指定子目录路径(如/ais)优雅转发到Docker容器

在日常的运维与开发中，我们经常需要在同一域名下（例如 `wiki.lib00.com`）部署多个不同的服务。比如，将根路径 `/` 指向主网站，而将特定的子目录 `/ais` 转发到后端的 AI 应用容器，同时不影响其他路径（如 `/xxxx`）。本文将由 DP@lib00 为您详细解析如何通过 Nginx 优雅地实现这一需求。 ## 核心 Nginx 配置 针对指定路径转发，最关键的点在于 `proxy_pass` 目标地址末尾的斜杠以及如何处理路径前缀。以下是优化版的 Nginx 配置。在这个例子中，我们将 `hub.wiki.lib00.com/ais` 反向代理到内部的 Docker 容器 `172.18.0.14:7860`： ```nginx server { listen 443 ssl; server_name hub.wiki.lib00.com; # ... 其他 SSL 和日志配置 ... # 针对 /ais 的专属转发规则 location ^~ /ais/ { # 核心技巧：末尾的 / 会将请求路径中的 "/ais/" 剥离掉再转发 # 示例：访问 hub.wiki.lib00.com/ais/test -> 转发到 172.18.0.14:7860/test proxy_pass http://172.18.0.14:7860/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; # WebSocket 支持 (AI WebUI 必备) proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "Upgrade"; # 针对 AI 流式输出的优化 proxy_buffering off; proxy_read_timeout 600s; } # 其他路径的默认处理 (例如 /xxxx) location / { # 默认站点的处理逻辑 proxy_pass http://127.0.0.1:8080; } } ``` --- ## 配置关键点深度解析 ### 1. `proxy_pass` 末尾的“魔法斜杠” 这是 Nginx 反向代理中最容易踩坑的地方： * **带末尾斜杠** (`http://172.18.0.14:7860/`)：Nginx 会**剥离**掉 `location` 匹配到的部分。请求 `/ais/api` 会被转发为 `/api`。对于大多数默认运行在根路径的 AI 工具（如 Gradio、Streamlit 等），这是**强烈推荐**的做法。 * **不带末尾斜杠** (`http://172.18.0.14:7860`)：Nginx 会将完整的请求路径追加到后端。请求 `/ais/api` 会被转发为 `/ais/api`。如果你的后端服务并不识别 `/ais` 前缀，就会直接报错。 ### 2. `location` 的优先级控制 使用 `^~ /ais/` 前缀是为了提升匹配优先级。`^~` 告诉 Nginx，如果该前缀匹配成功，就停止搜索其他正则表达式（如 `location ~ \.php$`），确保针对该子目录的请求被精准拦截，不会被其他通用规则误伤。 ### 3. WebSocket 与大模型流式输出优化 现代 AI 应用（如 ChatGPT UI、Stable Diffusion WebUI）大量依赖 WebSocket 进行双向通信。因此，`Upgrade` 和 `Connection` 请求头是必不可少的。 此外，如果你接入的是大语言模型（LLM），其回复通常是逐字生成的（流式输出）。此时必须设置 `proxy_buffering off;` 关闭 Nginx 的缓冲机制。如果不关闭缓冲，Nginx 会等待后端生成完所有内容后才发送给客户端，导致前端页面一直卡顿。 ### 4. 避坑指南：静态资源 404 问题 在配置好上述代理后，你可能会发现访问 `hub.wiki.lib00.com/ais` 时页面框架能打开，但 CSS/JS 等静态资源全部报 404 错误。 **原因**：后端应用内部使用了绝对路径（如 `/assets/style.css`）来加载资源，经过浏览器解析后，请求变成了根目录下的 `hub.wiki.lib00.com/assets/style.css`，从而脱离了 `/ais/` 的匹配规则。 **解决方案**：遇到这种情况，通常需要在后端 AI 应用的启动参数或环境变量中显式指定基础路径。例如，在 FastAPI 中配置 `root_path="/ais"`，或在 Gradio 启动参数中设置 `root_path`，让应用知道自己运行在子目录下，从而生成正确的相对静态资源链接。