[comment]: # translation:outdated

[comment]: # ({91aab3e5-91aab3e5})
# 2 Debian/Ubuntu

[comment]: # ({/91aab3e5-91aab3e5})

[comment]: # ({bb963ccb-d02acea9})
#### 概述

本节提供了使用官方 Zabbix 软件包从 Zabbix **6.4**.x 升级到 Zabbix **7.0**.x 的步骤，适用于 Debian/Ubuntu。

::: notewarning
在升级之前，请务必阅读相关的 [**升级说明**](/manual/installation/upgrade)！
:::

您可能还需要查看 7.0 的 [要求](/manual/installation/requirements)。

::: notetip
在升级过程中，运行两个并行的 SSH 会话可能会很方便，一个会话执行升级步骤，另一个会话监控服务器/代理日志。例如，在第二个 SSH 会话中运行 `tail -f zabbix_server.log` 或 `tail -f zabbix_proxy.log`，实时显示最新的日志文件条目和可能的错误。这对于生产环境实例来说可能是至关重要的。
:::

[comment]: # ({/bb963ccb-d02acea9})

[comment]: # ({93ff8b03-93ff8b03})
#### 升级程序

[comment]: # ({/93ff8b03-93ff8b03})

[comment]: # ({1a3625ec-f8102233})
##### 1 停止 Zabbix 进程

用户需要停止 Zabbix server服务，以确保没有新数据写入数据库。

    # service zabbix-server stop

若需要升级 Zabbix proxy，同样需要先停止 Zabbix proxy 进程。

    # service zabbix-proxy stop

[comment]: # ({/1a3625ec-f8102233})

[comment]: # ({ab13a6a4-ab13a6a4})
##### 2 备份当前的数据库

请用户确认，在升级前备份了数据库，这是非常关键的一步。如果升级失败（因磁盘空间不足、断电或其他意外导致的升级失败），备份的数据库将大有帮助。

[comment]: # ({/ab13a6a4-ab13a6a4})

[comment]: # ({08f5e88f-6c141723})
##### 3 备份配置文件、PHP 文件和 Zabbix 二进制文件

请用户在升级前确认备份了Zabbix 二进制文件、配置文件和 PHP 文件。

配置文件：

     # mkdir /opt/zabbix-backup/
     # cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
     # cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/

PHP 文件和 Zabbix 二进制文件：

     # cp -R /usr/share/zabbix/ /opt/zabbix-backup/
     # cp -R /usr/share/doc/zabbix-* /opt/zabbix-backup/

[comment]: # ({/08f5e88f-6c141723})

[comment]: # ({7d0a639e-31c75b55})
##### 4 更新软件包仓库配置

要继续更新，您当前的仓库包必须卸载。

    rm -Rf /etc/apt/sources.list.d/zabbix.list

然后安装新的仓库配置包。

在 **Debian 12** 上执行：

    wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
    dpkg -i zabbix-release_latest+debian12_all.deb

对于旧版本 Debian，使用如下链接替换 [Zabbix repository](https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/).
对于旧版本 Debian，安装包可能未包含所有组件。
包含所有组件的安装包请查看 [Zabbix 安装包](https://www.zabbix.com/download?zabbix=7.0&os_distribution=debian&os_version=11&components=proxy&db=mysql&ws=).

在 **Ubuntu 24.04** 上执行：

    wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
    dpkg -i zabbix-release_latest+ubuntu24.04_all.deb

在 **Ubuntu 22.04** 上执行：

    wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
    dpkg -i zabbix-release_latest+ubuntu22.04_all.deb

对于旧版本 Ubuntu，使用如下链接替换 [Zabbix repository](https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/).
对于旧版本 Ubuntu，安装包可能未包含所有组件。
包含所有组件的安装包请查看 [Zabbix 安装包](https://www.zabbix.com/download?zabbix=7.0&os_distribution=ubuntu&os_version=20.04&components=agent&db=&ws=).

更新仓库信息。

    apt-get update

[comment]: # ({/7d0a639e-31c75b55})

[comment]: # ({5ca72b55-08c7383c})
##### 5 升级Zabbix组件

升级 Zabbix 组件，可以运行以下命令：

      # apt-get install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent

若使用 PostgreSQL数据库，请在命令中将 `mysql` 替换为 `pgsql`。 若升级proxy，请在命令中将 `server` 替换为 `proxy`。 若升级 Zabbix agent 2，在命令中将 `zabbix-agent` 替换为 `zabbix-agent2`。

与此同时，要使得Apache 能正常升级 Web 前端，还需运行如下命令：

        # apt-get install zabbix-apache-conf

发行版**prior to Debian 10 (buster) / Ubuntu 18.04 (bionic) /
Raspbian 10 (buster)** 不提供 PHP 7.2 或更高版本，而其对Zabbix 前端 5.0又是必要的。 有关安装 Zabbix 前端旧发行版的信息，请查阅[information](/manual/installation/frontend/frontend_on_rhel7)。

[comment]: # ({/5ca72b55-08c7383c})

[comment]: # ({150c8817-455f4e97})
##### 6 审查组件配置参数

请务必查看[升级说明](/manual/installation/upgrade_notes_700)，以检查是否需要更改配置参数。

对于新的可选参数，请参阅[新特性](/manual/introduction/whatsnew700)页面。

[comment]: # ({/150c8817-455f4e97})

[comment]: # ({a393f257-624a8fc7})
##### 7 启动 Zabbix 进程

启动升级后的 Zabbix 组件。

    # service zabbix-server start
    # service zabbix-proxy start
    # service zabbix-agent start
    # service zabbix-agent2 start

[comment]: # ({/a393f257-624a8fc7})

[comment]: # ({760b25a7-49e4f43e})
##### 8 清除浏览器的 Cookies 和缓存

待升级完毕后，可能需要清除浏览器的 Cookies 和缓存，以便 Zabbix 的 Web
界面能正常工作。

[comment]: # ({/760b25a7-49e4f43e})

[comment]: # ({da91ed3b-9bab02f2})
#### 在小版本之间升级

可以升级 7.0.x 的小版本（例如，从 7.0.1 升级到 7.0.3）。这个过程很简单。

要升级 Zabbix 小版本，请运行：

```
sudo apt install --only-upgrade 'zabbix.*'
```

要升级 Zabbix 服务器的小版本，请运行：

```
sudo apt install --only-upgrade 'zabbix-server.*'
```

要升级 Zabbix 代理的小版本，请运行：

```
sudo apt install --only-upgrade 'zabbix-agent.*'
```

或者，对于 Zabbix agent 2，请运行：

```
sudo apt install --only-upgrade 'zabbix-agent2.*'
```

[comment]: # ({/da91ed3b-9bab02f2})