---
title: "サーブオプション"
url: https://docs.catalyst.zoho.com/ja/cli/v1/serve-resources/serve-options/
description: "Catalystでは、CLIを使用して、リモートコンソールにデプロイする前にプロジェクトリソースをローカルでテストすることができます。"
last_updated: 2026-08-17T12:16:04Z
service: All Services
type: general
---

# Catalyst Serveオプション

Catalyst CLIは、`catalyst serve`コマンドで使用できるさまざまなオプションを提供しています。

### \--http <port>

デフォルトポート3000以外の任意のポートでリソースをローカルにサーブできます。`-\\-http`オプションを使用して、リソースをサーブするポート番号を指定します。

たとえば、ポート2000からリソースをサーブするには、プロジェクトディレクトリから次のコマンドを実行します：

```sh
 catalyst serve --http 2000 
```

![Catalyst Serve Options](https://catalyst-docs-development.zohostratus.in/images/cli/serve-resources/catalyst_cli_serve_http.webp)

### \--debug <type:port>

Catalystでは、ローカルサーバーをデバッグモードで起動し、ライブサーバーにデバッガーをアタッチできます。プロジェクトのBasic I/OおよびAdvanced I/Oファンクションのコードをデバッグできます。コードの開発に使用するIDEのデバッガーインスタンスにサーバーを関連付けることができます。これにより、ファンクションの実行をデバッグし、コード内のエラーや問題を特定できます。

> **注意:** catalyst serve `--debug`コマンドはJavaおよびNode.jsファンクションでのみ使用可能で、Pythonファンクションではサポートされていません。この目的にはPython IDEを使用し、ローカルデバッガーをアタッチしてください。その後、Pythonファンクションをサーブしてローカルでテストできます。Pythonファンクションのデバッグとサーブの詳細な手順については、[このヘルプページ](https://docs.catalyst.zoho.com/ja/cli/v1/working-with-functions/functions-shell/#debugging-python-functions)を参照してください。

`\--http<port> `オプションと同様に、任意のポートでサーバーを起動することもできます。Basic I/Oファンクションがデバッガーにアタッチされるデフォルトポートは8010で、Advanced I/Oファンクションは8000です。

プロジェクトディレクトリから次のコマンドを実行して、デバッグモードでローカルサーバーを起動できます：

```sh
 catalyst serve --debug <advancedio:name:port,basicio:port> 
```

このオプションを使用する場合、Advanced I/Oファンクションの名前を指定する必要があります。Basic I/Oファンクションの名前は指定する必要はありません。たとえば：

```sh
 catalyst serve --debug advancedio:InvoiceFetch:2000,basicio:4000 
```

これにより、デフォルトポート3000でローカルサーバーが起動されます。リソースがサーブされ、ローカルエンドポイントが表示されます。その後、Advanced I/Oファンクション用にポート2000で、Basic I/Oファンクション用にポート4000でデバッガーをアタッチできます。サーバーはこれらのポートでデバッガーをリッスンします。

![Catalyst Serve Options](https://catalyst-docs-development.zohostratus.in/images/cli/serve-resources/catalyst_cli_serve_debug.webp)

このメッセージが表示されたら、IDEを開き、ファンクションに指定したポートにデバッガーをアタッチします。アタッチ後、CLIは確認メッセージを表示します。これでリソースをテストしてデバッグできます。CLIは、デバッガーがキャッチしたエラーとその詳細を表示します。

### \--proxy<url>

Catalystでは、CLIのサーバーが生成したlocalhost URLに不明なリクエストをプロキシできます。これにより、ファンクションのサーブ中に発生したリクエストをプロキシできます。そのようなリクエストはデフォルトでCatalystコンソールにプロキシされます。

serveコマンドの実行時に、不明なリクエストをプロキシするURLを次のように指定できます：

```sh
 catalyst serve --proxy <url> 
```

### \--only<targets>

このオプションを使用して、すべてのリソースではなく特定のターゲットをサーブできます。たとえば、特定のファンクションやクライアントパッケージのみをサーブできます。

特定のターゲットをサーブするには、以下のように`catalyst serve`コマンドを`-\\-only`オプションとサーブ対象のターゲットとともに実行します：

```sh
 catalyst serve --only client 
```

 ![Catalyst Serve Options](https://catalyst-docs-development.zohostratus.in/images/cli/serve-resources/catalyst_cli_serve_only.webp)

### \--no-watch

Catalyst CLIはデフォルトでライブウォッチモードを提供し、サーブ中のリソースのホットリロードを実行できます。これにより、コードを再コンパイルしたり再サーブしたりすることなく、変更の更新を即座に確認できます。

ただし、ライブウォッチモードを無効にする必要がある場合は、このオプションを使用できます。本番環境用ビルドのサーブ時など、コードを変更する必要がない場合や、更新をライブで反映する必要がない場合に使用できます。

デフォルトのライブウォッチを無効にしてリソースをサーブするには、次のようにします：

```sh
 catalyst serve --no-watch 
```

これにより、サーバーは最初にコードがサーブされたときのみコンパイルします。コードがサーブされた後、サーバーは変更を監視しません。リソースをテストする際に更新はライブで反映されません。

デフォルトのライブウォッチモードを再度有効にする必要がある場合は、サーブセッションを終了し、このオプションを使用せずにコードを再サーブする必要があります。

### \--except<targets>

このオプションを使用して、特定のリソースをサーブから除外できます。たとえば、特定のファンクションやクライアントパッケージを除外できます。

特定のファンクションを除外するには、以下のように`catalyst serve`コマンドを`\--except`オプションとターゲット名とともに実行します：

```sh
 catalyst serve -- except functions:InvoiceGeneration 
```

![Catalyst Serve Options](https://catalyst-docs-development.zohostratus.in/images/cli/serve-resources/catalyst_cli_serve_except.webp)

### \--ignore-scripts

Catalystでは、プロジェクトディレクトリの[ `catalyst.json` ](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/catalyst-json/)ファイルにスクリプトを定義することで、CLIおよびターミナルコマンドの実行を自動化できます。`catalyst serve`コマンドの前後にそれぞれ実行する2つのライフサイクルスクリプトを定義できます：`preserve`、`postserve`。ライフサイクルスクリプトとカスタムスクリプトの詳細については、[スクリプトのヘルプページ](https://docs.catalyst.zoho.com/ja/cli/v1/scripts/introduction/)を参照してください。

`catalyst serve`コマンドの実行時に`\--ignore-scripts`オプションを使用すると、CLIはプロジェクトディレクトリの`catalyst.json`ファイルで`preserve`および`postserve`スクリプトに設定されたアクションを無視します。デプロイプロセスは、これらのライフサイクルスクリプトの実行なしに続行されます。

`\--ignore-scripts`オプションは次のように使用できます：

```sh
 catalyst serve --ignore-scripts 
```

サーブプロセスは前述と同様です。

### \--no-open

serveコマンドを実行してサーバーがコードをホストすると、CLIはデフォルトブラウザに自動的にリダイレクトし、プロジェクト内のクライアントコンポーネントを開きます。この自動リダイレクトを無効にする必要がある場合は、次のようにこのオプションを使用してserveコマンドを実行できます：

```sh
 catalyst serve --no-open 
```

CLIは通常どおり、サーブされたすべてのコンポーネントのlocalhost URLを表示します。必要に応じて、URLにアクセスしてWebクライアントを手動で開くこともできます。

![Catalyst Serve Options](https://catalyst-docs-development.zohostratus.in/images/cli/serve-resources/catalyst_cli_serve_no_open.webp)

このオプションは、クライアントコンポーネントのテストが不要な場合や、本番環境用ビルドのテスト実行時に使用できます。