> 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` 変数を次のいずれかとして設定することもできます: `本番`, `staging` または `development`. 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 リストに項目を追加することでファイルやパスを除外できます。以下にいくつかの例があります。 * ディレクトリ内の単一ファイルを除外する: ``` { "exclude": [ ... "./home/testing/app/package.json", ] } ``` * すべての releases サブディレクトリを除外する: ``` { "exclude": [ ... "./home/testing/*/releases", ] } ``` * out フォルダ内およびすべてのサブディレクトリ内のすべての .json ファイルを除外する: ``` { "exclude": [ ... "./out/**/*.json", ] } ``` * スキャン対象からカタログ化ツールを除外する（例: Golang カタログ化ツールを除外）: ``` { "exclude": [ ], "select_catalogers": "-go" } ``` #### 出力チャネル VM スキャナーの出力チャネルを制御したい場合は、インストール時に OUTPUT 変数を次のように指定できます `stdout`, `stderr` または `なし`. 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 使用または削除するカタログ化ツールのカンマ区切りリスト --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 カタログ化ツールを除外する例: ``` /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.