在反向代理后面运行 Grafana

Grafana Labs Team
由 Grafana Labs 团队提供

上次更新时间：2024 年 3 月 19 日

高级

简介

在本教程中，您将配置 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/，其中相应的 domain 配置值在 Grafana 配置文件的 server 部分中设置为 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(/)?(.*)
  • 选中 忽略大小写 复选框
  • 将重写 URL 设置为 https://127.0.0.1:3000/{R:2}
  • 选中 附加查询字符串 复选框
  • 选中 停止处理后续规则 复选框

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

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

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

配置 Traefik

Traefik 云原生应用程序代理。

使用 Docker 提供程序和以下标签配置域名或子域路由的路由器和服务。

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

使用文件提供程序的示例。

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