> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/mashinsukyan/local-vm-scanning/setting-up-the-local-vm-scanner-linux.md). # Linux でローカル VM スキャナーを設定する Aikido VM Scannerは、システムにインストールされる単一パッケージで、依存関係を自動的にスキャンして特定し、環境を詳細に把握できるようにします。 ### 前提条件 * 最小システム要件: RAM 1GB 以上。 * 推奨システム要件: RAM 2GB 以上、CPU 4基。 * システムに sudo / 管理者権限があることを確認してください * お使いのシステムまたはクラウドプロバイダーに適したコマンドを使用してください * root で実行する必要がある場合は、AIKIDO\_TOKEN 環境変数を sudo の後に配置してください。次のようにします：\ `sudo AIKIDO_TOKEN=REPLACE_ME ` ### インストールとアップグレード sudo で実行し、置き換えることを忘れないでください `AIKIDO_TOKEN` を [Aikido のローカル VM スキャンページの有効なトークン](https://app.aikido.dev/settings/integrations/vm-scan-agent). VM 環境（後で Aikido で表示されます）を指定するには、次の `VM_TYPE` 変数も次のいずれかに設定できます： `本番`, `ステージング` または `開発`. VM Scanner Agent は 1 日に 1 回、午前 4:00〜8:00（マシン時刻）のランダムな時刻に実行されます。 インストール後、 **最初のスキャンが自動的に開始されます**。必要に応じて実行したい場合は、手動で次を実行できます： ```bash /opt/aikido-vm-scanner-1.4.4/aikido-vm-scanner ``` #### **Red Hat 系システム向け（RHEL、CentOS、Fedora）** **x86\_64** ``` AIKIDO_TOKEN=REPLACE_ME VM_TYPE=production dnf install -y https://aikido-vm-agent.s3.eu-west-1.amazonaws.com/v1.4.4/aikido-vm-scanner.x86_64.rpm ```
ハッシュaikido-vm-scanner.x86_64.rpm
MD50b7db4a7a77fd57d330c4b7e39b04264
SHA256c56d375445e920d1f8870dc24dba40dfec06a7f7e761df1f916932a17eb98ee5
**aarch64** ``` AIKIDO_TOKEN=REPLACE_ME VM_TYPE=production dnf install -y https://aikido-vm-agent.s3.eu-west-1.amazonaws.com/v1.4.4/aikido-vm-scanner.aarch64.rpm ```
ハッシュaikido-vm-scanner.aarch64.rpm
MD501b289dd41e2a2005ea864fb12f677be
SHA25698c5ab94bd1b307d9670b73e98536dc3e876d7d5583481486fe0de976f178a6f
#### **Debian 系システム向け（Debian、Ubuntu）** {% hint style="warning" %} Debian >= 10 および Ubuntu >= 20.04 をサポートしています。 {% endhint %} **x86\_64** ``` curl -L -O https://aikido-vm-agent.s3.eu-west-1.amazonaws.com/v1.4.4/aikido-vm-scanner.amd64.deb AIKIDO_TOKEN=REPLACE_ME VM_TYPE=production apt-get install -y ./aikido-vm-scanner.amd64.deb ```
ハッシュaikido-vm-scanner.amd64.deb
MD554900ac3e8ec9cd95e893dfd0e1a2de5
SHA256158cc661fe2f55f6254d1ec1dd6f1d6dc053499ef509cb5c59b48f0a1e526754
**aarch64** ``` curl -L -O https://aikido-vm-agent.s3.eu-west-1.amazonaws.com/v1.4.4/aikido-vm-scanner.arm64.deb AIKIDO_TOKEN=REPLACE_ME VM_TYPE=production apt-get install -y ./aikido-vm-scanner.arm64.deb ```
ハッシュaikido-vm-scanner.arm64.deb
MD52121aa77a82767a5ca4b21d4da993c9a
SHA256a0e16051c7bc96e5eb050daed72512df1c2b11b73c4ec7dd66a2ef5a4fe7591f
### 最新バージョン 自動インストールプロセスがあり、リリースされ次第常に最新バージョンを使いたい場合は、インストールリンク内のバージョンを次に置き換えることができます： `最新`: * * * * ### 追加設定 #### トークンの設定 何らかの理由でインストール時に AIKIDO\_TOKEN を設定できない場合は、インストール後に次の 2 つの方法のいずれかでトークンを設定できます： * トークンを次に貼り付ける `/opt/aikido-vm-scanner-1.4.4/.token` * 次の内容を変更する `/opt/aikido-vm-scanner-1.4.4/config.json` : ``` { "api_key": "AIKIDO_TOKEN_HERE", "exclude": [] } ``` #### ホスト名の変更 デフォルトでは、スキャン対象マシンのホスト名を自動的に取得して Aikido に送信し、Virtual Machines タブに表示されるようにします。 報告されるホスト名を変更したい場合は、設定ファイルを使って次のようにできます： ``` { "hostname": "YOUR_HOSTNAME_HERE", "exclude": [] } ``` #### ファイルまたはパスを除外 config.json では、exclude リストに項目を追加することでファイルやパスを除外できます。以下にいくつかの例を示します。 * ディレクトリ内の 1 つのファイルを除外： ``` { "exclude": [ ... "./home/testing/app/package.json", ] } ``` * すべての releases サブディレクトリを除外： ``` { "exclude": [ ... "./home/testing/*/releases", ] } ``` * out フォルダおよびすべてのサブディレクトリ内の .json ファイルをすべて除外： ``` { "exclude": [ ... "./out/**/*.json", ] } ``` * スキャン対象から cataloger を除外する（例：Golang cataloger を除外）： ``` { "exclude": [ ], "select_catalogers": "-go" } ``` #### 出力チャンネル VM スキャナーの出力チャンネルを制御したい場合は、インストール時に OUTPUT 変数を次のように指定できます `標準出力`, `標準エラー出力` または `なし`. rpm x86\_64 の例： ``` AIKIDO_TOKEN=REPLACE_ME VM_TYPE=production OUTPUT=stderr dnf install -y https://aikido-vm-agent.s3.eu-west-1.amazonaws.com/v1.4.4/aikido-vm-scanner.x86_64.rpm ``` {% hint style="info" %} このオプションはディスクログには影響しません。ディスクログはこの設定に関係なく作成されます。 {% endhint %} #### 初回スキャンを無効化 rpm/deb パッケージをインストールすると、自動的に初回スキャンがトリガーされます。\ この機能を無効にしたい場合は、次の `INITIAL_SCAN` パラメータをインストール時に 0 に設定できます。次のようにします： ``` AIKIDO_TOKEN=REPLACE_ME INITIAL_SCAN=0 dnf install -y https://aikido-vm-agent.s3.eu-west-1.amazonaws.com/v1.4.4/aikido-vm-scanner.x86_64.rpm ``` #### CLI パラメータ 何らかの理由でコマンドラインからオンデマンドでスキャンを開始する必要がある場合は、そのスキャンで使用する次の CLI パラメータを指定できます： ``` --api-key string 認証用 API キー --hostname string マシンのホスト名 --select-catalogers string 使用または削除する cataloger のコンマ区切りリスト --vm-type string 仮想マシンの種類 ``` これらの CLI パラメータは config.json で指定されたものより優先されます。 {% hint style="warning" %} 自動スキャンは 1 日に 1 回トリガーされ、そのスキャンでは CLI パラメータではなく設定ファイルが引き続き使用されるため、これらは常に config.json に配置することを推奨します。 {% endhint %} * CLI 経由でカスタムホスト名を設定する例： ``` /opt/aikido-vm-scanner-1.4.4/aikido-vm-scanner --hostname "My Custom VM" ``` * CLI 経由で Golang cataloger を除外する例： ``` /opt/aikido-vm-scanner-1.4.4/aikido-vm-scanner --select-catalogers "-go" ``` ### アンインストール #### 手動アンインストール **Red Hat 系システム向け（RHEL、CentOS、Fedora）** ``` dnf remove -y aikido-vm-scanner ``` **Debian 系システム向け（Debian、Ubuntu）** ``` apt-get remove -y aikido-vm-scanner ``` ### ログ ログは、最後に生成された SBOM とともにこちらで確認できます: `/var/log/aikido-vm-scanner-1.4.4` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.aikido.dev/docs/docs-ja/mashinsukyan/local-vm-scanning/setting-up-the-local-vm-scanner-linux.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.