文档

Grafana 文档

设置

启动 Grafana

企业版开源

启动 Grafana 服务器

本主题包含启动 Grafana 服务器的说明。对于某些配置更改，你可能需要重启 Grafana 服务器才能使其生效。

以下说明将以 grafana 用户（在软件包安装期间创建）启动 grafana-server 进程。

如果你使用 APT 仓库或 .deb 软件包安装，则可以使用 systemd 或 init.d 启动服务器。如果你安装的是二进制 .tar.gz 文件，则直接执行二进制文件。

Linux

以下小节描述了启动和重启 Grafana 服务器的三种方法：使用 systemd、使用 init.d 或直接运行二进制文件。你应该根据你的机器配置选择其中一种方法。

使用 systemd 启动 Grafana 服务器

完成以下步骤，使用 systemd 启动 Grafana 服务器并验证其是否正在运行。

要启动服务，请运行以下命令

sudo systemctl daemon-reload
sudo systemctl start grafana-server

要验证服务是否正在运行，请运行以下命令
bash
```
sudo systemctl status grafana-server
```

配置 Grafana 服务器在启动时使用 systemd 启动

要配置 Grafana 服务器在启动时启动，请运行以下命令

sudo systemctl enable grafana-server.service

在小于 1024 的端口上运行 Grafana

如果你使用 systemd 并想在小于 1024 的端口上启动 Grafana，则必须添加 systemd 单元覆盖。

运行以下命令，在你配置的编辑器中创建覆盖文件。

# Alternatively, create a file in /etc/systemd/system/grafana-server.service.d/override.conf
sudo systemctl edit grafana-server.service

添加以下额外设置以授予 CAP_NET_BIND_SERVICE 能力。

要了解更多关于能力的信息，请参阅 capabilities(7) — Linux 手册页。

[Service]
# Give the CAP_NET_BIND_SERVICE capability
CapabilityBoundingSet=CAP_NET_BIND_SERVICE
AmbientCapabilities=CAP_NET_BIND_SERVICE

# A private user cannot have process capabilities on the host's user
# namespace and thus CAP_NET_BIND_SERVICE has no effect.
PrivateUsers=false

使用 systemd 重启 Grafana 服务器

要重启 Grafana 服务器，请运行以下命令

sudo systemctl restart grafana-server

注意
SUSE 或 openSUSE 用户可能需要先使用 systemd 方法启动服务器，然后使用 init.d 方法配置 Grafana 在启动时启动。

使用 init.d 启动 Grafana 服务器

完成以下步骤，使用 init.d 启动 Grafana 服务器并验证其是否正在运行

要启动 Grafana 服务器，请运行以下命令
bash
```
sudo service grafana-server start
```
要验证服务是否正在运行，请运行以下命令
bash
```
sudo service grafana-server status
```

配置 Grafana 服务器在启动时使用 init.d 启动

要配置 Grafana 服务器在启动时启动，请运行以下命令

sudo update-rc.d grafana-server defaults

使用 init.d 重启 Grafana 服务器

要重启 Grafana 服务器，请运行以下命令

sudo service grafana-server restart

使用二进制文件启动服务器

grafana 二进制 .tar.gz 文件需要工作目录是安装根目录，该目录包含二进制文件和 public 文件夹。

要启动 Grafana 服务器，请运行以下命令

./bin/grafana server

Docker

要重启 Grafana 服务，请使用 docker restart 命令。

docker restart grafana

或者，你可以使用 docker compose restart 命令重启 Grafana。更多信息请参阅 docker compose 文档。

Docker compose 示例

配置你的 docker-compose.yml 文件。例如

version: '3.8'
services:
  grafana:
    image: grafana/grafana:latest
    container_name: grafana
    restart: unless-stopped
    environment:
      - TERM=linux
      - GF_INSTALL_PLUGINS=grafana-clock-panel,grafana-polystat-panel
    ports:
      - '3000:3000'
    volumes:
      - 'grafana_storage:/var/lib/grafana'
volumes:
  grafana_storage: {}

启动 Grafana 服务器

docker compose up -d

这将在分离模式下启动 Grafana 服务器容器，并启动 YAML 文件中指定的两个插件。

要重启正在运行的容器，请使用此命令

docker compose restart grafana

Windows

完成以下步骤，在 Windows 上启动 Grafana 服务器

执行 grafana.exe server；grafana 二进制文件位于 bin 目录中。
我们建议你从命令行运行 grafana.exe server。
如果你想将 Grafana 作为 Windows 服务运行，可以下载 NSSM。
要运行 Grafana，请打开浏览器并访问 Grafana 端口（默认为 https://:3000/）。
注意：默认 Grafana 端口是 3000。此端口在 Windows 上可能需要额外权限。如果它没有出现在默认端口，你可以尝试更改为其他端口。
要更改端口，请完成以下步骤
a. 在 conf 目录中，将 sample.ini 复制为 custom.ini。
注意：你应该编辑 custom.ini，永远不要编辑 defaults.ini。
b. 编辑 custom.ini 并取消注释 http_port 配置选项（; 是 ini 文件中的注释字符），然后将其更改为类似 8080 的值，这应该不需要额外的 Windows 权限。