[comment]: # aside: 3

[comment]: # ({2c8167b3-e2c1904c})
# パッケージからのインストールに関する注意

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

[comment]: # ({b582c5af-8d855b7c})
#### 概要

Zabbix 8.0 の公式 **プレリリース** パッケージは [Zabbix website](https://www.zabbix.com/download?zabbix=8.0&os_distribution=alma_linux&os_version=10&components=server_frontend_agent&db=mysql&ws=apache) で入手できます。ここでは、インストール手順とコマンドを生成するために、使用するオペレーティングシステムと Zabbix コンポーネントを選択できます。

以下の [パッケージのインストールに関する注意事項](#package-installation-notes) に加えて、[インストールとセットアップ](/manual/appendix/install) のページも参照してください。

パッケージは、以下の Linux ディストリビューションで利用できます。

-   Red Hat Enterprise Linux およびその派生版: AlmaLinux、Amazon Linux 2023、CentOS Stream、CentOS 7、Oracle Linux、Rocky Linux
-   Debian、Ubuntu、Raspberry Pi OS、Raspbian
-   SUSE Linux Enterprise Server、openSUSE Leap

::: noteimportant
一部の OS ディストリビューション（特に Debian ベースのディストリビューション）は、独自の Zabbix パッケージを提供しています。
これらのパッケージは Zabbix によって **サポートされておらず**、古い場合や最新の機能・バグ修正が含まれていない場合があります。
[Zabbix Official Repository](https://repo.zabbix.com/) の公式パッケージのみを使用することを推奨します。
以前に OS のリポジトリから Zabbix をインストールした場合は、[OS リポジトリから Zabbix パッケージをアップグレードする手順](/manual/installation/upgrade/packages#zabbix-packages-from-os-repositories) を参照してください。
:::

パッケージは MySQL/PostgreSQL データベースおよび Apache/Nginx Web サーバーをサポートしています。
Zabbix サーバーとプロキシは同じデータベースを共有できないことに注意してください。両方を同じホストにインストールする場合は、異なるデータベース名を使用してください。

必要に応じて、Zabbix エージェント/エージェント 2、Zabbix get、Zabbix sender 用の個別パッケージが [Zabbix Official Repository](https://repo.zabbix.com/zabbix/8.0/stable) で利用できます。

Zabbix は、Linux 以外のオペレーティングシステム向けに Zabbix エージェントの事前コンパイル済みバイナリも提供しています。詳細は以下を参照してください。

-   [MSI からの Windows エージェントのインストール](/manual/installation/install/win_msi)
-   [PKG からの macOS エージェントのインストール](/manual/installation/install/mac_pkg)
-   [レガシーバイナリ](https://www.zabbix.com/download_agents?version=2.4&os=HPUX&show_legacy=1)（HP-UX、NetBSD、Tru64、旧バージョンの SLES など、古い/あまり一般的でないシステム向け）

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

[comment]: # ({33328630-dc3de2e8})
#### パッケージインストールの注意事項

以下の注意事項はすべてのシステムに適用されます:

-   PostgreSQLを使用する場合、Zabbix [サーバー](/manual/appendix/config/zabbix_server)/[プロキシ](/manual/appendix/config/zabbix_proxy#dbhost)の設定で`DBHost=localhost`（またはIPアドレス）を指定すると、PostgreSQLはローカルのUNIXソケットではなくネットワークソケットを使用します。関連するセットアップ手順については[SELinuxの設定](#selinux-configuration)を参照してください。
-   TimescaleDBを使用する場合は、追加の[TimescaleDBセットアップ](/manual/appendix/install/timescaledb)を参照してください。
-   Zabbix [Javaゲートウェイ](/manual/concepts/java)（JMXアプリケーションの監視用）をインストールする場合は、[RHEL系システム](/manual/concepts/java/from_rhel)および[Debian系システム](/manual/concepts/java/from_debian_ubuntu)の追加セットアップ手順を参照してください。
-   Zabbixエージェントをrootとして実行する場合は、[エージェントをrootで実行する](/manual/appendix/install/run_agent_as_root)を参照してください。

以下の注意事項はRHELおよびその派生製品に適用されます:

-   EL9用にEPELリポジトリを有効にしている場合、EPELリポジトリもZabbixパッケージを提供しているため、公式Zabbixパッケージをインストールする前にパッケージ解決から除外する必要があります。[EPEL Zabbixパッケージの誤インストール](/manual/installation/known_issues#accidental-installation-of-epel-zabbix-packages)を参照してください。
-   Red Hat UBI環境でZabbixパッケージをインストールする場合は、[Red Hat UBI環境でのRHEL用Zabbixパッケージ](/manual/installation/known_issues#zabbix-packages-for-rhel-on-red-hat-ubi-environments)を参照してください。
-   [ICMP pingアイテム](/manual/config/items/itemtypes/simple_checks)を使用する場合、`fping`用のパッケージも[Zabbix公式リポジトリ](https://repo.zabbix.com/third-party)で利用可能です。

[comment]: # ({/33328630-dc3de2e8})

[comment]: # ({d731fd80-7e862504})
#### SELinuxの設定

Zabbixはソケットベースのプロセス間通信を使用します。
Security-Enhanced Linux（SELinux）が有効になっているシステムでは、ZabbixがSocketDirディレクトリ内でUNIXドメインソケットを作成/使用できるようにSELinuxルールを追加する必要がある場合があります。
ソケットファイルはZabbixサーバー（alerter、preprocessing、IPMI）およびZabbixプロキシ（IPMI）によって使用され、プロセスが実行中の間存在します。

SELinuxがenforcingモードで有効になっている場合、Zabbixフロントエンドとサーバー間の通信を有効にするには、以下のコマンドを実行します。

RHEL 7（以降）、AlmaLinux、CentOS Stream、Oracle Linux、Rocky Linux 8（以降）の場合：

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

データベースにネットワーク経由でアクセスする場合（PostgreSQLの`localhost`を含む）、Zabbixフロントエンドがデータベースに接続できるようにします。

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

RHEL 7以前の場合：

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

SELinuxの設定を適用した後、Apacheを再起動します。

```bash
systemctl restart httpd
```

オプションとして、[Zabbix公式リポジトリ](https://repo.zabbix.com/zabbix/8.0/stable)から事前定義された`zabbix-selinux-policy`パッケージをインストールできます。
このパッケージは、すべてのサポートされているOSバージョンで提供されており、Zabbixの導入を簡素化し、設定の複雑さからSELinuxを無効にすることを防ぎます。

::: noteimportant
最大限のセキュリティを確保するために、カスタムSELinux設定を行うことを推奨します。
:::

`zabbix-selinux-policy`パッケージには、Zabbixがソケットを作成・使用できるようにし、HTTPdからPostgreSQLへの接続（フロントエンドで使用）を有効にする基本的なSELinuxポリシーが含まれています。

ソースの`zabbix_policy.te`ファイルには、以下のルールが含まれています。

```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]: # ({/d731fd80-7e862504})

[comment]: # ({71fa111b-664f0553})
#### Debuginfoパッケージ

Debuginfoパッケージには、Zabbixバイナリ用のデバッグシンボルが含まれています。  
通常のインストールや運用には必要ありませんが、高度なトラブルシューティングに役立ちます。

`zabbix-debuginfo` リポジトリを有効にするには、次のようにします。

-   RHEL 7 では、`/etc/yum.repos.d/zabbix.repo` を編集し、`zabbix-debuginfo` セクションで `enabled=1` を設定します。

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

-   SUSE では、`/etc/zypp/repos.d/zabbix.repo` を編集し、`zabbix-debuginfo` セクションで `enabled=1` を設定します。

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

有効化したら、パッケージをインストールします。

-   RHEL では、すべてのZabbixコンポーネント向けのデバッグ情報を含む単一のパッケージをインストールします。

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

-   SUSE では、コンポーネントごとのdebuginfoパッケージをインストールします。

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

[comment]: # ({/71fa111b-664f0553})

[comment]: # ({58e91f3a-b2259b50})
#### 不安定リリースリポジトリの有効化

[comment]: # ({/58e91f3a-b2259b50})

[comment]: # ({b4905f83-9e4d6713})
以下の手順は、Zabbixのマイナーバージョンのリリース候補で使用される、不安定なZabbixリリースリポジトリ（デフォルトでは無効）を有効にするためのものです。

まず、zabbix-releaseパッケージを最新バージョンにインストールまたはアップデートしてください。rcパッケージをシステムで有効にするには、以下の操作を行います。

[comment]: # ({/b4905f83-9e4d6713})

[comment]: # ({05bf7fe3-05fb2800})
##### Red Hat Enterprise Linux

`zabbix-unstable`リポジトリのenabled=1を設定するために、`/etc/yum.repos.d/zabbix.repo`ファイルを開きます。

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

[comment]: # ({/05bf7fe3-05fb2800})

[comment]: # ({0df3de7c-f13e36b3})
##### Debian/Ubuntu

`/etc/apt/sources.list.d/zabbix.list` を開き、「Zabbix unstable repository」のコメントを外します。

```ini
# Zabbix unstable repository
deb https://repo.zabbix.com/zabbix/8.0/unstable/debian bullseye main
deb-src https://repo.zabbix.com/zabbix/8.0/unstable/debian bullseye main
```

[comment]: # ({/0df3de7c-f13e36b3})

[comment]: # ({48cbd395-37a29df2})
##### SUSE

`zabbix-unstable`リポジトリのenable=1を設定するために、`/etc/zypp/repos.d/zabbix.repo`ファイルを開きます。

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

[comment]: # ({/48cbd395-37a29df2})