密码重置、API调用、远程命令，Zabbix用户必知的几个技巧

news2025/11/4 10:27:30

作者：张思德，Zabbix社区签约专家，2017-2022Zabbix中国峰会讲师
前言
Zabbix版本迭代很快，而且每个版本都会有很多新特性，有时有一个不起眼的小的更新却造成很多老司机翻车，以下主要介绍Zabbix几个常见的知识点。

密码重置
在使用Zabbix 的过程中由于默认密码过于简单，往往会修改密码并配置为自动登录，时间一长往往忘记密码，造成无法登录的情况，这种情况就需要重置密码。Zabbix 的密码存储在数据库中，可通过数据库重置。在Zabbix5.0版本之前，Zabbix 用户密码使用 MD5 加密方式存储，从 5.0 版本开始使用 Bcrypt 加密方式。

BCrypt 是一种跨平台的文件加密工具，使用的是布鲁斯·施内尔在 1993 年发布的 Blowfish 加密算法。它是一种可生成随机盐值的单向 Hash 加密算法，Hash 值中包含了上一步生成的盐值（22 个字符）的不可逆加密算法。同一种明文，每次被加密后的密文都不一样，并且不可反向破解生成明文，破解难度非常大。大大提升了系统的安全性，因此要重置 5.0 以后版本的用户密码就需要注意，不能再使用 MD5 加密方式生成的密码。
可按照以下方法对Zabbix 的 Admin 用户密码进行重置.
MySQL 数据库

mysql -uzabbix -p
use zabbix;
update users SET passwd=‘$2y$10$92nDno4n0Zm7Ej7Jfsz8WukBfgSS/U0QkIuu8WkJPihXBb2A1UrEK’ where userid=1;
quit;
PostgreSQL

su - postgres
psql
\c zabbix;
update users SET passwd=‘$2y$10$92nDno4n0Zm7Ej7Jfsz8WukBfgSS/U0QkIuu8WkJPihXBb2A1UrEK’ where userid=1;
、q
重置后即可使用账号：Admin 密码：Zabbix 登录系统，注意账号 Admin 的 A 为大写，区分大小写。

API 调用
Zabbix提供丰富且完备的API，使用Grafana对接Zabbix API 实现炫酷的大屏及图表是个很流行的操作。在使用Grafana对接Zabbix 数据时需要填写 zabbix 的 API 地址，这一步很多人找不到和无法验证的问题。zabbix的API地址为Zabbix的访问地址+api_jsonrpc.php,如果不确定可以使用curl命令判断.

curl -v http://172.16.66.70:8080/api_jsonrpc.php
使用一个能打开Zabbix 页面的地址，后面加 api_jsonrpc.php，

About to connect() to 172.16.66.70 port 8080 (#0)
Trying 172.16.66.70…
Connected to 172.16.66.70 (172.16.66.70) port 8080 (#0)

GET /api_jsonrpc.php HTTP/1.1
User-Agent: curl/7.29.0
Host: 172.16.66.70:8080
Accept: /

< HTTP/1.1 412 Precondition Failed
< Server: nginx/1.18.0
< Date: Mon, 07 Nov 2022 15:43:59 GMT
< Content-Type: text/html; charset=UTF-8
< Transfer-Encoding: chunked
< Connection: keep-alive
< Access-Control-Allow-Origin: *
< Access-Control-Allow-Headers: Content-Type
< Access-Control-Allow-Methods: POST
< Access-Control-Max-Age: 1000
<

Connection #0 to host 172.16.66.70 left intact
如果看到 HTTP/1.1 412 Precondition Failed 则表示此地址正确，可填入 granfa 插件里的 api 地址。返回其他错误，表示 api 地址填写错误，可尝试添加/zabbix/的后缀比如http://172.16.66.70:8080/zabbix/api_jsonrpc.php
从Zabbix 5.4 开始可在页面上新建 API Token

同时支持配置过期时间、启用、禁用等操作，添加后 Token 只显示一次，建议复制并保存到本地。
在这里插入图片描述

调用 API 时在 Auth 字段直接带入 Token 即可，

{
“jsonrpc”: “2.0”,
“method”: “item.get”,
“params”: {
“countOutput”:“1”,
“filter”: {
“state”: “1”
}
},
“id”: 2,
“auth”: “4fa51a0c8033b452857bf06c35e41295dcb0ee22506b768edb0720d0093e71f2”
}
无需使用账号和密码进行登录后再获取 Token，规范和简化了 Token 管理。

远程命令
Zabbix支持通过ZabbixServer、Zabbix Proxy、Zabbix Agent 在主机上执行自定义命令，利用此特性配合 Trigger Action 可实现简单的故障自愈功能。在Zabbix6.0 之前版本，直接在 Action 的 Operations 选项卡里填入对应的远程命令即可，从 6.0 版本开始，需要先在 Administrators—Scripts 里添加脚本，才能在 Operations 选项卡里选中。
在这里插入图片描述