5分钟搞定Grafana域名访问：Nginx+HTTPS最简配置方案

5分钟搞定Grafana域名访问：Nginx+HTTPS最简配置方案

你是否也遇到过这样的场景：在本地服务器上跑着Grafana，用IP加端口访问总觉得不够“正式”，想把它挂到自己的域名下，还得配上那个让人安心的“小绿锁”？更头疼的是，网上的教程要么步骤繁琐，要么配置复杂，光是看那些参数就让人望而却步。别担心，这篇文章就是为你准备的。我们不走弯路，不搞复杂理论，直接瞄准一个目标：用最短的时间、最清晰的步骤，让你手头的Grafana通过Nginx代理，安全、优雅地以HTTPS域名形式对外提供服务。无论你是运维工程师、开发人员，还是正在搭建个人监控系统的技术爱好者，这套“极简配置流程”都能让你在5分钟的核心操作内，完成从零到一的部署闭环。

1. 环境准备与核心概念澄清

在动手之前，我们先花一分钟理清几个关键点，这能帮你避免后续90%的配置错误。很多人配置失败，不是因为技术多难，而是概念没对齐。

首先，明确我们的架构：用户通过浏览器访问 https://your-domain.com/grafana，这个请求首先到达你的Nginx服务器。Nginx的角色是反向代理，它接收到请求后，会将其转发给真正运行Grafana服务的后端服务器（通常是本机的3000端口）。最后，Grafana处理完请求，将结果再通过Nginx返回给用户。这里有两个核心配置需要“握手”成功：

1. Nginx的 proxy_pass：告诉Nginx把请求转发到哪里。
2. Grafana的 root_url：告诉Grafana它自己被访问的“根地址”是什么，这样它生成的链接、跳转才是正确的。

一个常见的误区是只配置了Nginx，却忘了告诉Grafana它已经“搬家”到了子路径（/grafana）下，导致页面CSS/JS加载失败或跳转404。另一个误区是关于SSL证书，我们选择Let‘s Encrypt，因为它免费、自动化程度高，非常适合生产环境。你需要确保：

• 拥有一台公网可访问的服务器（云服务器或拥有公网IP的机器）。
• 拥有一个已解析到该服务器IP的域名（例如 grafana.yourdomain.com 或 yourdomain.com）。
• 服务器上已安装 Nginx 和 Grafana，且Grafana默认运行在 http://localhost:3000。

提示：如果你的Grafana和Nginx不在同一台机器，只需将后续配置中的 localhost 或 127.0.0.1 替换为Grafana服务器的内网IP即可，原理完全相通。

2. 获取SSL证书：Let‘s Encrypt自动化申请

安全是底线，HTTPS不再是可选项而是必选项。我们使用Certbot工具来获取Let‘s Encrypt证书，这个过程几乎是全自动的。

第一步：安装Certbot及其Nginx插件 以Ubuntu/Debian系统为例，操作如下。其他系统请参考 Certbot官方网站 的指引。

sudo apt update
sudo apt install certbot python3-certbot-nginx -y

这里