在反向代理后运行 Grafana

Grafana Labs Team
由 Grafana Labs 团队撰写

上次更新于 2025 年 1 月 17 日

高级

简介

在本教程中，您将配置 Grafana 在反向代理后运行。

当在代理后运行 Grafana 时，您需要配置域名，以告知 Grafana 如何正确渲染链接和重定向。

  • 在 Grafana 配置文件中，将 server.domain 改为您将要使用的域名
bash 
[server]
domain = example.com
  • 重启 Grafana 以使更改生效。

配置反向代理

配置 nginx

nginx 是一个高性能的负载均衡器、Web 服务器和反向代理。

  • 在您的 nginx 配置文件的 http 部分内部，添加以下内容
nginx 
# This is required to proxy Grafana Live WebSocket connections.
map $http_upgrade $connection_upgrade {
  default upgrade;
  '' close;
}

upstream grafana {
  server localhost:3000;
}

server {
  listen 80;
  root /usr/share/nginx/html;
  index index.html index.htm;

  location / {
    proxy_set_header Host $host;
    proxy_pass http://grafana;
  }

  # Proxy Grafana Live WebSocket connections.
  location /api/live/ {
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_set_header Host $host;
    proxy_pass http://grafana;
  }
}
  • 重新加载 nginx 配置。
  • 导航到运行 nginx 的机器的 80 端口。您将看到 Grafana 登录页面。

对于使用 WebSocket 连接的 Grafana Live，您可能需要提高 nginx 的 worker_connections 选项的值，该值默认为 512。默认值限制了与 Grafana Live 的最大并发连接数。

此外，请注意，上述配置仅在 location / 的 proxy_pass 值为字面字符串时有效。如果您想在此处使用变量，则必须改为使用 重写规则。欲了解更多信息，请参阅 GitHub 问题 #18299。

要配置 nginx 以在 子路径 下提供 Grafana，请更新 location 块

nginx 
# This is required to proxy Grafana Live WebSocket connections.
map $http_upgrade $connection_upgrade {
  default upgrade;
  '' close;
}

upstream grafana {
  server localhost:3000;
}

server {
  listen 80;
  root /usr/share/nginx/www;
  index index.html index.htm;

  location /grafana/ {
    proxy_set_header Host $host;
    proxy_pass http://grafana;
  }

  # Proxy Grafana Live WebSocket connections.
  location /grafana/api/live/ {
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_set_header Host $host;
    proxy_pass http://grafana;
  }
}

为每个 location 块添加重写规则

 rewrite  ^/grafana/(.*)  /$1 break;

注意

如果 nginx 正在执行 TLS 终止，则必须相应地设置 root_url 和 protocol 配置。如果您从 https://example.com/grafana/ 提供 Grafana，则 root_url 为 https://example.com/grafana/ 或 https://%(domain)s/grafana/，且在 Grafana 配置文件的 server 部分中将相应的 domain 配置值设置为 example.com。将 protocol 设置为 http。

配置 HAProxy

要配置 HAProxy 以在 子路径 下提供 Grafana

bash 
frontend http-in
  bind *:80
  use_backend grafana_backend if { path /grafana } or { path_beg /grafana/ }

backend grafana_backend
  server grafana localhost:3000
  # Requires haproxy >= 1.6
  http-request set-path %[path,regsub(^/grafana/?,/)]
  # Works for haproxy < 1.6
  # reqrep ^([^\ ]*\ /)grafana[/]?(.*) \1\2

  server grafana localhost:3000

配置 IIS

注意

要使用 IIS，必须安装 URL Rewrite 模块。

要配置 IIS 以在 子路径 下提供 Grafana，请在 IIS 管理器 中为父网站创建 Inbound Rule，设置如下

  • 模式: grafana(/)?(.*)
  • 勾选 Ignore case 复选框
  • 重写 URL 设置为 https://:3000/{R:2}
  • 勾选 Append query string 复选框
  • 勾选 Stop processing of subsequent rules 复选框

这是在 web.config 中生成的重写规则

xml 
  <rewrite>
      <rules>
          <rule name="Grafana" enabled="true" stopProcessing="true">
              <match url="grafana(/)?(.*)" />
              <action type="Rewrite" url="https://:3000/{R:2}" logRewrittenUrl="false" />
          </rule>
      </rules>
  </rewrite>

有关更详细的说明，请参阅 IIS URL 重写教程。

配置 Apache

要使用 Apache 作为代理，请确保其正确安装和配置。

  1. 确保 Apache 代理模块 mod_proxy 已安装并启用。要启用，请运行以下命令
bash 
a2enmod proxy
a2enmod proxy_http
  1. 要配置代理，请编辑站点配置文件。为此，在 <VirtualHost> 部分内部，添加以下代码
bash 
  ProxyPreserveHost on
  ProxyPass / http://your_grafana_server:3000
  ProxyPassReverse / http://your_grafana_server:3000
  1. 最后，重启 Apache 以使设置生效。

重启后，导航到您的 Apache 服务器的 80 端口，您将被重定向到 Grafana。

要在子路径中配置托管的 Grafana，请将子路径替换为以下代码（假设您的 Grafana 实例位于子路径 your_path 下）

bash 
  ProxyPreserveHost on
  ProxyPass /your_path http://your_grafana_server:3000
  ProxyPassReverse /your_path http://your_grafana_server:3000
  ProxyPass / http://your_grafana_server:3000/your_path
  ProxyPassReverse / http://192.168.250.5:3000/your_path

请注意，包含 your_path 的行必须出现在引用根路径 (/) 的行之前，才能使其正常工作。

配置 Traefik

Traefik 云原生应用代理。

使用 Docker provider 和以下标签配置路由和域或子域服务。

yaml 
labels:
  traefik.http.routers.grafana.rule: Host(`grafana.example.com`)
  traefik.http.services.grafana.loadbalancer.server.port: 3000

部署到 子路径

yaml 
labels:
  traefik.http.routers.grafana.rule: Host(`example.com`) && PathPrefix(`/grafana`)
  traefik.http.services.grafana.loadbalancer.server.port: 3000

使用文件 provider 的示例。

yaml 
http:
  routers:
    grafana:
      rule: Host(`grafana.example.com`)
      service: grafana
  services:
    grafana:
      loadBalancer:
        servers:
          - url: http://192.168.30.10:3000
yaml 
http:
  routers:
    grafana:
      rule: Host(`example.com`) && PathPrefix(`/grafana`)
      service: grafana
  services:
    grafana:
      loadBalancer:
        servers:
          - url: http://192.168.30.10:3000

在子路径下提供 Grafana 的替代方法

注意

只有在您不通过反向代理配置处理子路径服务时才需要此项。

如果您不想或无法使用反向代理处理从 子路径 提供 Grafana，可以将配置变量 server_from_sub_path 设置为 true。

  1. 在 root_url 的末尾包含子路径。
  2. 将 serve_from_sub_path 设置为 true
bash 
[server]
domain = example.com
root_url = %(protocol)s://%(domain)s:%(http_port)s/grafana/
serve_from_sub_path = true