[comment]: # ({e2c1904c-e2c1904c})
# 4 Instalação a partir de pacotes

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

[comment]: # ({e4ce52f8-8d855b7c})
#### Visão geral

Os pacotes oficiais do Zabbix 7.0 estão disponíveis no [site do Zabbix](https://www.zabbix.com/download), onde você pode selecionar seu sistema operacional e o componente do Zabbix para gerar as instruções e os comandos de instalação necessários. Certifique-se de consultar as [notas de instalação de pacotes](#package-installation-notes) abaixo e a página [Instalação e configuração](/manual/appendix/install).

Os pacotes estão disponíveis para as seguintes distribuições Linux:

-   Red Hat Enterprise Linux e seus derivados: AlmaLinux, Amazon Linux 2023, CentOS Stream, CentOS, Oracle Linux, Rocky Linux
-   Debian, Ubuntu, Raspberry Pi OS, Raspbian
-   SUSE Linux Enterprise Server, openSUSE Leap

::: noteimportant
Algumas distribuições de SO (em particular, as baseadas em Debian) fornecem seus próprios pacotes do Zabbix.
Esses pacotes **não** são suportados pelo Zabbix e podem estar desatualizados ou sem os recursos e correções de bugs mais recentes.
Recomenda-se usar apenas os pacotes oficiais do [Repositório Oficial do Zabbix](https://repo.zabbix.com/).
Se você instalou o Zabbix anteriormente a partir do repositório do seu sistema operacional, consulte as etapas para [atualizar pacotes do Zabbix a partir dos repositórios do SO](/manual/installation/upgrade/packages#zabbix-packages-from-os-repositories).
:::

Os pacotes suportam banco de dados MySQL/PostgreSQL e servidor web Apache/Nginx.
Observe que o server e o proxy do Zabbix não podem compartilhar o mesmo banco de dados; use nomes de banco de dados diferentes se ambos estiverem instalados no mesmo host.

Se necessário, pacotes separados para Zabbix agent/agent 2, Zabbix get e Zabbix sender estão disponíveis no [Repositório Oficial do Zabbix](https://repo.zabbix.com/zabbix/7.0).

::: noteimportant
Desde o Zabbix 7.0.5, os pacotes do Zabbix agent 2 não estão mais disponíveis para [RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/) devido à incompatibilidade do Go 1.22 (e versões mais recentes) com o GCC 4.4.7 fornecido pelo RHEL 6, o que resulta em erros de compilação.
Observe, porém, que os [pacotes do Zabbix agent](/manual/installation/install_from_packages/rhel) ainda são suportados.
:::

O Zabbix também fornece binários pré-compilados do Zabbix agent para sistemas operacionais não Linux; veja:

-   [Instalação do agent no Windows a partir do MSI](/manual/installation/install_from_packages/win_msi)
-   [Instalação do agent no macOS a partir do PKG](/manual/installation/install_from_packages/mac_pkg)
-   [Binários legados](https://www.zabbix.com/download_agents?version=2.4&os=HPUX&show_legacy=1) (para sistemas mais antigos/menos comuns, como HP-UX, NetBSD, Tru64 e versões mais antigas do SLES)

[comment]: # ({/e4ce52f8-8d855b7c})

[comment]: # ({4baadd08-c1bdf57f})
#### Notas sobre a instalação de pacotes

As seguintes notas se aplicam a todos os sistemas:

-   Se estiver usando PostgreSQL, `DBHost=localhost` (ou um endereço IP) na configuração do Zabbix [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy#dbhost) faz com que o PostgreSQL use um socket de rede em vez de um socket UNIX local; veja [Configuração do SELinux](#selinux-configuration) para instruções relacionadas.
-   Se estiver usando TimescaleDB, veja a configuração adicional do [TimescaleDB](/manual/appendix/install/timescaledb).
-   Se estiver instalando o [Java gateway](/manual/concepts/java) do Zabbix (para monitorar aplicações JMX), veja instruções adicionais de configuração para [sistemas baseados em RHEL](/manual/concepts/java/from_rhel) e [sistemas baseados em Debian](/manual/concepts/java/from_debian_ubuntu).
-   Para executar o agent do Zabbix como root, veja [Executando o agent como root](/manual/appendix/install/run_agent_as_root).

As seguintes notas se aplicam ao RHEL e seus derivados:

-   Se você ativou o repositório EPEL para EL9, que também fornece pacotes do Zabbix, ele deve ser excluído da resolução de pacotes antes de instalar os pacotes oficiais do Zabbix; veja [Instalação acidental de pacotes Zabbix do EPEL](/manual/installation/known_issues#accidental-installation-of-epel-zabbix-packages).
-   Para instalar pacotes do Zabbix em ambientes Red Hat UBI, veja [Pacotes Zabbix para RHEL em ambientes Red Hat UBI](/manual/installation/known_issues#zabbix-packages-for-rhel-on-red-hat-ubi-environments).
-   Para usar [itens de ping ICMP](/manual/config/items/itemtypes/simple_checks), pacotes para `fping` também estão disponíveis no [Repositório Oficial do Zabbix](https://repo.zabbix.com/non-supported).

[comment]: # ({/4baadd08-c1bdf57f})

[comment]: # ({2043bdb5-db311694})
#### Configuração do SELinux

O Zabbix utiliza comunicação entre processos baseada em socket.
Em sistemas onde o Security-Enhanced Linux (SELinux) está habilitado, pode ser necessário adicionar regras SELinux para permitir que o Zabbix crie/utilize sockets de domínio UNIX no diretório SocketDir.
Os arquivos de socket são usados pelo Zabbix server (alerter, preprocessing, IPMI) e pelo Zabbix proxy (IPMI), e estão presentes enquanto o processo está em execução.

Com o SELinux habilitado no modo enforcing, execute os seguintes comandos para habilitar a comunicação entre o Zabbix frontend e o server:

Para RHEL 7 (e posteriores), AlmaLinux, CentOS Stream, Oracle Linux, Rocky Linux 8 (e posteriores):

```bash
setsebool -P httpd_can_connect_zabbix on
```

Se o banco de dados for acessado pela rede (incluindo `localhost` para PostgreSQL), permita também que o Zabbix frontend se conecte ao banco de dados:

```bash
setsebool -P httpd_can_network_connect_db on
```

Para RHEL anterior ao 7:

```bash
setsebool -P httpd_can_network_connect on
setsebool -P zabbix_can_network on
```

Após aplicar as configurações do SELinux, reinicie o Apache:

```bash
systemctl restart httpd
```

Opcionalmente, você pode instalar um pacote pré-definido `zabbix-selinux-policy` do [Repositório Oficial do Zabbix](https://repo.zabbix.com/zabbix/7.0).
Este pacote é fornecido para todas as versões de SO suportadas para simplificar a implantação do Zabbix e evitar que os usuários desativem o SELinux devido à complexidade da configuração.

::: noteimportant
Para máxima segurança, recomenda-se definir configurações personalizadas do SELinux.
:::

O pacote `zabbix-selinux-policy` contém uma política SELinux básica, permitindo que o Zabbix crie e utilize sockets e habilitando a conexão HTTPd ao PostgreSQL (usado pelo frontend).

O arquivo fonte `zabbix_policy.te` contém as seguintes regras:

```ini
module zabbix_policy 1.2;

require {
    type zabbix_t;
    type zabbix_port_t;
    type zabbix_var_run_t;
    type postgresql_port_t;
    type httpd_t;
    class tcp_socket name_connect;
    class sock_file { create unlink };
    class unix_stream_socket connectto;
}

#============= zabbix_t ==============
allow zabbix_t self:unix_stream_socket connectto;
allow zabbix_t zabbix_port_t:tcp_socket name_connect;
allow zabbix_t zabbix_var_run_t:sock_file create;
allow zabbix_t zabbix_var_run_t:sock_file unlink;
allow httpd_t zabbix_port_t:tcp_socket name_connect;

#============= httpd_t ==============
allow httpd_t postgresql_port_t:tcp_socket name_connect;
```

[comment]: # ({/2043bdb5-db311694})

[comment]: # ({d2ded11f-9863c5b8})
#### Pacotes Debuginfo

Os pacotes `Debuginfo` contêm símbolos de depuração para os binários do Zabbix.
Eles não são necessários para a instalação ou operação normal, mas são úteis para solução avançada de problemas.

Observe que os pacotes `Debuginfo` estão disponíveis para as seguintes versões: Red Hat Enterprise Linux 7 e anteriores (incluindo derivados) e SUSE Linux Enterprise Server 15 e anteriores (incluindo derivados).

Para habilitar o repositório `zabbix-debuginfo`:

-   No RHEL 6 ou 7, edite `/etc/yum.repos.d/zabbix.repo` e defina `enabled=1` para a seção `zabbix-debuginfo`:

```ini
[zabbix-debuginfo]
name=Zabbix Official Repository debuginfo - $basearch
baseurl=https://repo.zabbix.com/zabbix/7.0/rhel/7/$basearch/debuginfo/
enabled=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591
gpgcheck=1
```

-   No SUSE, edite `/etc/zypp/repos.d/zabbix.repo` e defina `enabled=1` para a seção `zabbix-debuginfo`:

```ini
[zabbix-debuginfo]
name=Zabbix Official Repository debuginfo
type=rpm-md
baseurl=https://repo.zabbix.com/zabbix/7.0/sles/15/$basearch/debuginfo/
gpgcheck=1
gpgkey=https://repo.zabbix.com/zabbix/7.0/sles/15/$basearch/debuginfo/repodata/repomd.xml.key
enabled=0
update=1
```

Depois de habilitado, instale os pacotes:

-   No RHEL, instale um único pacote com informações de depuração para todos os componentes do Zabbix:

```bash
dnf install zabbix-debuginfo
```

-   No SUSE, instale pacotes debuginfo específicos por componente:

```bash
zypper install zabbix-<component>-debuginfo
```

[comment]: # ({/d2ded11f-9863c5b8})
