Hyperbola

公告

ブログへようこそ！これはサンプルの告知です

标签

Hyperbola

公告

ブログへようこそ！これはサンプルの告知です

Learn More

标签

Database Desktop Development DevOps Hardware High_Availability Hyprland Input_Method Kubernetes Linux Monitoring Networking Virtualization

Hyperbola

公告

ブログへようこそ！これはサンプルの告知です

Learn More

标签

Database Desktop Development DevOps Hardware High_Availability Hyprland Input_Method Kubernetes Linux Monitoring Networking Virtualization

站点统计

文章

25

分类

6

标签

13

总字数

40,141

运行天数

0 天

最后活动

0 天前

692 字

2 分钟

基于 K3s 与 Traefik 部署 Zabbix 7.4 监控平台

2026-08-20

DevOps

Kubernetes

/

DevOps

/

Monitoring

在已经配置好 Traefik、cert-manager、Cloudflare DNS-01 和全局通配符证书的 k3s 上，部署 Zabbix Server、Web、PostgreSQL 数据库和四台 Agent 2。入口与证书基础设施见K3s Traefik 接管 Nginx 公网入口迁移实战。

架构与组件#

flowchart TB U["浏览器"] -->|"HTTPS 443"| T["Traefik"] T --> W["Zabbix Web Service"] W --> WP["Zabbix Web Pod"] WP --> DB["Patroni/HAProxy\n10.0.0.100:5432"] ZS["Zabbix Server Pod"] --> DB A["Agent 2\nserver/wsl/txy/aly"] -->|"主动 10051"| VIP["10.0.0.100:10051"] VIP --> ZS ZS -->|"被动 10050"| A

本篇部署内容：

Zabbix Server 7.4；
Zabbix Web 7.4；
Patroni PostgreSQL 数据库；
四台 Zabbix Agent 2；
Traefik HTTPS Ingress。

分步部署#

入口与证书前置条件#

开始部署前，确认第一篇中的 Traefik 入口基础设施已经就绪：

1
k3s kubectl -n kube-system get certificate/hyperbola-cc-wildcard
2
k3s kubectl -n kube-system get tlsstore/default
3
k3s kubectl -n kube-system rollout status deployment/traefik

证书 Secret 位于 kube-system，由 Traefik TLSStore/default 在 TLS 终止层全局使用；Zabbix namespace 不复制、也不跨 namespace 引用该 Secret。

初始化 Patroni PostgreSQL#

数据库使用写端点 10.0.0.100:5432，不能误用只读端口 5433。

自动化流程：

检查 zabbix-db Secret；
不存在则生成随机应用密码；
从 Patroni 配置读取 superuser 密码；
幂等创建/更新 zabbix role；
幂等创建 zabbix database；
确保数据库 owner 正确；
所有凭据任务设置 no_log: true。

部署 Server 和 Web#

镜像：

zabbix/zabbix-server-pgsql:alpine-7.4-latest；
zabbix/zabbix-web-nginx-pgsql:alpine-7.4-latest。

两个 Deployment 都配置：

数据库 Secret 引用；
readiness probe；
CPU/memory request 与 limit；
IfNotPresent 拉取策略。

配置 Traefik Ingress#

1
apiVersion: networking.k8s.io/v1
2
kind: Ingress
3
metadata:
4
  name: zabbix-web
5
  namespace: zabbix
6
  annotations:
7
    traefik.ingress.kubernetes.io/router.entrypoints: websecure
8
spec:
9
  ingressClassName: traefik
10
  rules:
11
    - host: zabbix.hyperbola.cc
12
      http:
13
        paths:
14
          - path: /
15
            pathType: Prefix
16
            backend:
17
              service:
18
                name: zabbix-web
19
                port:
20
                  name: http

Ingress 不声明 namespace 本地 tls.secretName，HTTPS 由 websecure EntryPoint 和 kube-system/default TLSStore 提供。HTTP→HTTPS 也已在 Traefik EntryPoint 全局处理，不需要 Zabbix 专属 HTTP Ingress。

Zabbix trapper 暴露到 10.0.0.100:10051。当前 Service 使用 externalIPs，新 Kubernetes 会产生 deprecated 警告；应规划 kube-vip/MetalLB，但在替代方案上线前不要直接删除。

安装 Agent 2#

1
Server=10.0.0.0/24,10.42.0.0/16
2
ServerActive=10.0.0.100:10051
3
Hostname=server

ServerActive：主动式，Agent 连接 Server 获取检查项并上报；
Server：被动式，允许节点和 Pod 网段访问 10050；
Hostname：必须与 Zabbix Host name 完全一致。

安装仓库后的 apt cache 坑#

安装 zabbix-release 后必须强制刷新缓存：

1
- name: Install Zabbix Agent 2 and plugins
2
  ansible.builtin.apt:
3
    name: "{{ ['zabbix-agent2'] + zabbix_agent2_plugins }}"
4
    state: present
5
    update_cache: true
6
    cache_valid_time: 0

否则 apt 会复用添加仓库之前的缓存，并误报 zabbix-agent2-plugin-postgresql 不存在。

Agent 在线但 UI 没数据#

四台 Agent 均 active、监听 10050，agent.ping 返回 [s|1]，Server 也收到 heartbeat，但日志显示：

1
host [server] not found
2
host [wsl] not found
3
host [txy] not found
4
host [aly] not found

Zabbix 不会根据 heartbeat 自动创建 Host。必须在 UI/API 创建：

Host name	IP	模板
`server`	10.0.0.10	Linux by Zabbix agent active
`wsl`	10.0.0.20	Linux by Zabbix agent active
`txy`	10.0.0.30	Linux by Zabbix agent active
`aly`	10.0.0.40	Linux by Zabbix agent active

默认 Zabbix server Host 与 Hostname=server 不一致，应禁用、删除或修改。

踩坑清单#

Patroni 和数据库密码任务必须 no_log。
新 apt 仓库安装后必须强制刷新 cache。
sudo PATH 缺 /usr/sbin 会让 dpkg 找不到系统工具。
externalIPs 已 deprecated，需要后续替代方案。
Agent heartbeat 成功不代表 Host 自动注册。
默认 Host 名称与 Agent Hostname 不一致。

验收#

1
k3s kubectl -n kube-system get certificate,secret,tlsstore
2
k3s kubectl -n zabbix get deployments,services,ingresses
3

4
k3s kubectl get pods -A \
5
  --field-selector=status.phase!=Running,status.phase!=Succeeded
6

7
systemctl is-active zabbix-agent2
8
/usr/sbin/zabbix_agent2 -t agent.ping
9

10
k3s kubectl -n zabbix logs deployment/zabbix-server \
11
  --since=30m | grep -E 'host .* not found|cannot process heartbeat'

完整顶层 Playbook#

1
---
2
- name: Move host Nginx away from Traefik ports
3
  hosts: server:txy:aly
4
  become: true
5
  gather_facts: false
6

7
  roles:
8
    - role: host_nginx_high_port
9

10
- name: Configure the container registry mirror on k3s nodes
11
  hosts: servers
12
  become: true
13
  gather_facts: false
14
  serial: 1
15

16
  roles:
17
    - role: k3s_registry_mirror
18

19
- name: Restore Traefik and deploy Zabbix Server in k3s
20
  hosts: server
21
  become: true
22
  gather_facts: false
23
  serial: 1
24

25
  roles:
26
    - role: k3s_traefik
27
    - role: zabbix_server_k3s
28

29
- name: Install and configure Zabbix Agent 2 on servers
30
  hosts: servers
31
  become: true
32
  gather_facts: true
33
  environment:
34
    PATH: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
35

36
  roles:
37
    - role: zabbix_agent2

1
ANSIBLE_CONFIG="$HOME/.config/ansible/ansible.cfg" \
2
  ansible-playbook --syntax-check playbook.yml
3

4
ANSIBLE_CONFIG="$HOME/.config/ansible/ansible.cfg" \
5
  ansible-playbook playbook.yml