macOS 与 Windows 桌面安装

桌面形态适合做什么

学习仪表盘、验证数据源、做演示 demo——这些场景不需要一台服务器，本机跑一个实例最方便。桌面形态与服务器形态功能完全一致，差别只在「谁负责把它拉起来」以及数据放在哪里。生产部署请回到Docker 与 Docker Compose或发行版包安装。

macOS：Homebrew 安装

brew install grafana
brew services start grafana

然后打开 http://localhost:3000，用 admin / admin 登录。常用管理命令：

brew services stop grafana     # 停止并取消自启
brew services info grafana     # 查看运行状态
brew upgrade grafana           # 升级到新小版本

安装前缀与数据目录因芯片而异：Apple Silicon 通常在 /opt/homebrew，Intel 机型在 /usr/local，用 brew --prefix grafana 查看实际位置。

macOS：官网安装包

不想用 Homebrew 的话，官方下载页提供 macOS 安装包，双击安装后按提示启动；不同小版本的启动方式可能略有差异，以实际界面为准。

Windows：ZIP 免安装

从官方下载页获取 Windows 的 ZIP 包，解压后在前台运行：

cd C:\tools\grafana\bin
.\grafana-server.exe

出现监听日志后访问 http://localhost:3000。数据与日志默认落在解压目录下的 data 子目录里，把整个目录拷贝走就等于搬走了整个实例。

注意： ZIP 形态关窗即停。想让它在 Windows 上开机自启，可以用系统服务管理工具把 grafana-server.exe 注册为服务，或用任务计划以登录时启动代替；官方下载页如提供安装包形态，优先按官方说明安装为服务，以实际页面为准。

与服务形态的差异速查

常见坑

• 端口被占：3000 被本机其他 dev server 占用时，改配置文件里的 http_port 并重启，见配置文件 grafana.ini。
• 路径里有中文或空格：Windows 解压路径建议纯英文，老版本对非 ASCII 路径的静态资源处理偶有问题。
• 想「恢复出厂」：停掉服务、删掉数据目录再启动，即回到全新实例——删之前确认没有要留的仪表盘。

下一步

• 玩明白了要上服务器：Docker 与 Docker Compose或Debian / Ubuntu 安装。
• 想理解本机那些配置项，读配置文件 grafana.ini。
• 升级本机实例前，看升级与回滚。