mcpField
H
huawei-cloud-devbridge-tunnel

huawei-cloud-devbridge-tunnel

github.com/huaweicloudクラウド・DevOps59799 回インストール2 日前に更新
リポジトリ

huawei-cloud-devbridge-tunnel について

Huawei Cloud DevBridge の開発トンネルを管理し、リモートデバイスからローカルサービスへ接続するためのスキルです。中継接続を使うため、ホスト側でパブリックな受信ポートを開く必要はありません。

主な機能

  1. 01トンネルの作成・更新・削除
  2. 02トンネルのポートとプロトコル設定
  3. 03ホストと接続セッションのバックグラウンド起動
  4. 04トンネル URL、プロセス、ログの確認
  5. 05接続と使用量の確認

活用シーン

  1. 01チームでのリモートデバッグと結合テスト
  2. 02開発中のウェブページの関係者との共有
  3. 03ローカル開発中の Webhook 受信
  4. 04スマートフォンなどからローカルサービスへアクセス

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/huaweicloud/huaweicloud-skills --skill huawei-cloud-devbridge-tunnel

インストール後、Claude Code で/huawei-cloud-devbridge-tunnelを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

examples/devbridge-demo/
app.py
references/
acceptance-criteria.md
cli-command-reference.md
cli-installation-guide.md
iam-policies.md
rest-api-reference.md
troubleshooting.md
verification-method.md
scripts/
devbridge_cmd.sh

詳細

Huawei Cloud DevBridge 開発トンネル

Huawei Cloud の中継インフラを介して、ローカルの開発サービスをリモートデバイスに安全に公開する DevBridge 開発トンネルを作成、管理します。

概要

DevBridge は、パブリックな受信ポートを開くことなく、開発者がローカルサービス(Web サーバー、API、デバッグ用エンドポイント)をリモートデバイスに公開できる開発トンネルサービスです。CLI ツール(devbridge)で、トンネル、ポート、ホスト接続、接続セッションを管理します。ホストと接続元はどちらも中継サービスへのアウトバウンド接続を開始するため、ホストデバイスにパブリックな受信ポートは必要ありません。

アーキテクチャ
Developer Device (Host)                    Remote Device (Connect)
┌──────────────────────┐                  ┌──────────────────────┐
│  Local Service :8080 │                  │  localhost:8080      │
│         │            │                  │         ▲            │
│  devbridge host      │                  │  devbridge connect   │
│         │            │                  │         │            │
└─────────┼────────────┘                  └─────────┼────────────┘
          │ Outbound connection                     │ Outbound connection
          ▼                                         ▼
┌─────────────────────────────────────────────────────────────────┐
│              DevBridge Relay Service (Huawei Cloud)              │
│                                                                  │
│  Tunnel (id) ── Port ── API Key / Token ── Access Policy         │
│  Address: https://<tunnelId>.<clusterId>.myhuaweicloud.com       │
└─────────────────────────────────────────────────────────────────┘

2026-09-20 ドメイン変更のお知らせ:DevBridge のトンネルドメインが切り替わり、従来の *.cn-north-4-bridge.myhuaweicloud.com から新しいクラスターのドメイン(例:*.devbridge-s2.hwtunnel.com)に変更されました。旧版のクライアント側(v0.1.x)は接続できなくなりました。v0.2.x を使用し、トンネルを再作成する必要があります。devbridge host の実際の出力に表示される Tunnel URL を使用してください。

ユースケース
  • チームメンバーとのリモートデバッグや統合テスト
  • 開発中のWebページを関係者と共有
  • ローカル開発中にWebhookコールバックを受信
  • モバイルデバイスや他のマシンからローカルサービスにアクセス
  • デモ用にローカルAPIを一時的に公開
ユーザーによる典型的な表現
  • 「ローカルのポート8080をリモートデバイスに公開してください」
  • 「フロントエンドの開発サーバー用に開発トンネルを作成してください」
  • 「テスト用にローカルAPIをチームと共有したいです」
  • 「別のマシンからトンネルに接続してください」
  • 「ローカルの8080ポートをリモートデバイスに公開してください」

バージョン要件

項目要件
CLI バージョンv0.2.x(公式チャンネルからインストール。例:0.2.1-release / 0.2.2-release)
認証API Key(devbridge auth login --api-key または環境変数 HW_API_KEY)または対話型ログイン
トンネルドメイン新しいクラスターのドメイン(devbridge-s2.hwtunnel.com など)。devbridge host の出力に表示されます
旧バージョンv0.1.x はサポート対象外です。AK/SK 認証フラグは削除され、旧ドメインには接続できません

動的コマンド適応レイヤー

重要 — トンネル/ポート/ホストに関するすべての操作は、直接 devbridge コマンドを実行せず、db_* ラッパー関数(scripts/devbridge_cmd.sh で定義)を経由する必要があります。例外は devbridge auth と devbridge version のみです。

DevBridge CLI のフラグはリリースごとに変更される場合があります。適応レイヤーは実行前に devbridge <command> --help で利用可能なフラグを動的に確認するため、v0.2.x の範囲でスキルのバージョン非依存性を確保します。また、実行後のエラー回復も行い、cobra エラーを解析して、名前が変更されたフラグ、新たに必須になったパラメーター、名前が変更されたコマンドから自動的に回復します。自動回復に失敗した場合は、devbridge <command> --help を実行するよう提案とともにエラーを表示します。

適応レイヤー関数
関数置き換えるコマンド用途
db_init—CLI がインストール済みであること(v0.2.x 以降)、認証済みであることを確認します(DEVBRIDGE_API_KEY/HW_API_KEY を使って自動ログインします)
db_createdevbridge createトンネルを作成し、トンネル ID のみを返します(標準出力)
db_port_createdevbridge port createポートを作成します(ポート、プロトコル、匿名フラグに対応します)
db_hostdevbridge hostバックグラウンドでホストを開始し、PID(標準出力)とトンネル URL(標準エラー出力)を返します
db_host_bgdevbridge host + nohup bash -cバックグラウンドでホストします(旧式の別名です。代わりに db_host を使用してください)
db_connectdevbridge connectバックグラウンドで接続を開始し、PID(標準出力)を返します
db_listdevbridge listトンネルを一覧表示します
db_showdevbridge showトンネルの詳細を表示します
db_updatedevbridge updateトンネルを更新します
db_deletedevbridge deleteトンネルを削除します
db_delete_alldevbridge delete-allすべてのトンネルを削除します
db_port_listdevbridge port listポートを一覧表示します
db_port_deletedevbridge port deleteポートを削除します(ポートフラグに対応します)
db_limitsdevbridge limitsクォータ/使用状況/残高を表示します
db_echodevbridge echo診断用エコーサービスを開始します
db_pingdevbridge pingURI に ping を実行して接続をテストします
db_versiondevbridge versionCLI のバージョンを表示します
db_auth_statusdevbridge auth status認証状態を確認します
db_auth_logindevbridge auth loginログインします(対話形式または --api-key)
db_tunnel_url—ホストのログからトンネルの公開 URL を取得します(信頼できる情報源です。手動で組み立てないでください)
db_processes—実行中のホスト/接続プロセスを一覧表示します
db_process_stop—PID を指定してホスト/接続プロセスを停止します
db_process_logs—PID を指定してプロセスログを取得します

前提条件

重要 — 前提条件の確認中にユーザーへ確認を求めないでください。 db_init は通知せず自動的に次の処理を行います:(1)CLI が見つからない場合はインストールする、(2)v0.1.x の場合はアップグレードする(旧ドメインでは接続できません)、(3)認証を確認する、(4)DEVBRIDGE_API_KEY または HW_API_KEY 環境変数を使って自動ログインする。確認に失敗した場合のみ、出力を表示してください。

source <skill_directory>/scripts/devbridge_cmd.sh
db_init

v0.2.x では API Key のみサポートされます:--access-key / --secret-key / --security-token(AK/SK)パラメーターは削除されています。AK/SK でログインしようとしないでください(旧バージョンのスキルの使用方法は v0.2.x では無効です)。API Key は DevBridge 管理ページで作成します:https://devstation.connect.huaweicloud.com/space/devbridge/apikey。

自動化環境では API Key を使用してください(references/iam-policies.md を参照)。API Key は DevBridge 管理ページで作成します:https://devstation.connect.huaweicloud.com/space/devbridge/apikey。

インストールスクリプトに関する注意:非対話型/ヘッドレス環境では、インストールスクリプトに必ず -s(サイレント)を渡してください:... | bash -s -- -s。指定しない場合、スクリプトが /dev/tty から「上書きしますか?」と尋ね、ターミナルがない環境で失敗することがあります。

GitCode のプライベートリポジトリからのインストール:npx skills add は GitCode トークン認証をサポートしていません。プライベートリポジトリからスキルをインストールする場合は、まず git clone してから手動でコピーしてください:

git clone https://oauth2:<token>@gitcode.com/<org>/<repo>.git /tmp/repo
cp -r /tmp/repo/skills/devtools/devbridge/huawei-cloud-devbridge-tunnel/ ~/.agents/skills/huawei-cloud-devbridge-tunnel/
権限/認証エラーへの対処

DevBridge コマンドが無効または不足している認証情報が原因で失敗した場合:

  1. devbridge auth status を確認します。ログインしていない場合は、ログインします(対話形式または --api-key)。
  2. API Key を使用している場合は、有効期限切れや削除済みでないことを確認します。API Key 管理ページで再作成し、HW_API_KEY を介して設定してください。
  3. 手順については references/iam-policies.md を参照してください。
  4. 実行を一時停止し、認証情報が更新されたことをユーザーが確認するまで待ってから再試行してください。
システム要件
  • Bash と curl、または PowerShell 5.1 以降
  • x86-64 または ARM64 アーキテクチャ
  • DevBridge のインストール元へのアクセス
  • ~/.huawei ディレクトリへの書き込み権限

ワークフロー

重大 — トンネル作成中は確認を一切行いません。 一連の処理(CLI の確認 → 適応レイヤーの読み込み → 認証の確認 → トンネルの作成 → ポートの設定 → ホスティングの開始)を、ユーザーとのやり取りを一切挟まずに完全自動で実行してください。手順の途中でユーザーにパラメーターの確認を求めたり、処理を中断したりしないでください。すべて完了してから結果を提示してください。唯一の例外はトンネル名の競合です。名前がすでに存在するため db_create が失敗した場合は、続行する前に「既存のトンネルを再利用しますか?」という yes/no の選択肢を提示してください。

デフォルトパラメーター
パラメーターデフォルト値
トンネル名dev-tunnel-<random>(例:dev-tunnel-3847)
説明開発トンネル
有効期限72(時間)— CLI のデフォルト値。範囲は 1~720
ポート8080
プロトコルauto(選択肢:http / https / auto)
匿名アクセス拒否(--deny-anonymous は CLI のデフォルトです。匿名アクセスを許可するようユーザーが明示的に求めた場合のみ -a を使用してください)

セキュリティの変更点:匿名アクセスはデフォルトで拒否されます。以前のスキルバージョンとは異なり、デフォルトで --anon allow を指定しないでください。匿名アクセスを許可するのは、ユーザーが明示的に要求した場合、またはコンテンツが明らかに公開されている場合のみです。

パラメーターの解決

各パラメーターについて、ユーザーが値を明示的に指定した場合はその値を使用してください。それ以外の場合はデフォルト値を使用してください。確認を求めず、設定を自動的に適用して続行してください。

  • トンネル名:ユーザーが名前を指定した場合(例:「my-api という名前のトンネルを作成」→ my-api)
  • ポート:ユーザーがポート番号を指定した場合(例:「3000 ポートを公開」→ 3000)
  • 説明:ユーザーが説明を指定した場合(例:「説明はバックエンド API」→ バックエンドAPI)
  • 有効期限:ユーザーが時間を指定した場合(例:「有効期限は24時間」→ 24)。それ以外は 72
  • プロトコル:ユーザーがプロトコルを指定した場合(例:「https を使う」→ https)。それ以外は auto
  • 匿名アクセス:ユーザーが「匿名アクセスを許可」または「インターネットから直接アクセス」と指定した場合は -a。それ以外は拒否(デフォルト)
クイック作成フロー(ユーザーが詳細を指定せずに「トンネルを作成」と言った場合)
source <skill_directory>/scripts/devbridge_cmd.sh
db_init
TUNNEL_NAME="dev-tunnel-$((RANDOM % 9000 + 1000))"
TUNNEL_ID=$(db_create "$TUNNEL_NAME" -d "开发隧道" -e 72)
db_port_create "$TUNNEL_ID" -p 8080 --protocol auto
db_host "$TUNNEL_ID"                  # 输出 PID 和 Tunnel URL 到 stdout
TUNNEL_URL=$(db_tunnel_url "$TUNNEL_ID")
echo "Tunnel ID: $TUNNEL_ID"
echo "Tunnel URL: $TUNNEL_URL"

注意:匿名アクセスはデフォルトで禁止されています。 上記の手順で作成したトンネルでは、デフォルトで --deny-anonymous が設定され、インターネット経由のアクセスには authentication required が返されます。インターネットから直接アクセスする必要がある場合(Web サービスを外部ユーザーに公開する場合など)は、db_port_create に -a を追加してください:

db_port_create "$TUNNEL_ID" -p 8080 --protocol auto -a   # 匿名アクセスを許可
完全なワークフロー(ユーザーが具体的なパラメーターを指定した場合)
ステップ 1:DevBridge CLI のインストールまたは更新
devbridge version
# 下载安装脚本到临时文件再执行(避免管道直接执行)
curl -fsSL https://gitcode.com/CloudDeveloperDepartment/devbrige/releases/download/latest/install.sh -o /tmp/devbridge_install.sh
bash /tmp/devbridge_install.sh -s
devbridge version
ステップ 2:適応レイヤーの読み込みと認証
export PATH="$HOME/.huawei/bin:$PATH"
source <skill_directory>/scripts/devbridge_cmd.sh
db_init
devbridge auth status 2>/dev/null || devbridge auth login --api-key "$HW_API_KEY"
ステップ 3:トンネルの作成
# <name> = user-specified or "dev-tunnel", <description> = user-specified or "开发隧道", <expiration> = user-specified or 72
# Note: description only allows Chinese characters, digits, and letters (no spaces), max 64 characters
db_create <name> -d "<description>" -e <expiration>

トンネル名の競合への対応 — 確認を省略しない唯一の例外です。 "This tunnel name is already in use" というエラーで db_create が失敗した場合:

  1. db_list を実行し、既存のトンネルを探します。
  2. 使用状況を確認します(ユーザーには提示しません):db_port_list <tunnelId>(ポートが設定されているか)、ps aux | grep "devbridge host <tunnelId>" | grep -v grep(ホストが実行中か)、ps aux | grep "devbridge connect <tunnelId>" | grep -v grep(接続セッションが実行中か)。
  3. トンネルの詳細と使用状況を提示します:アクティブ(ホストが実行中/セッションがアクティブ — 再利用すると競合する可能性があります)、アイドル(ポートは設定済みだが、アクティブなプロセスはない — 安全に再利用できます)、または空(ポートなし — セットアップが必要です)。
  4. yes/no の選択肢を提示します:「トンネル名はすでに存在し、現在の状態は <active/idle/empty> です。既存のトンネルを再利用しますか?」
    • yes — 既存のトンネルを再利用し、ステップ 4 に進みます(すでにアクティブな場合はステップ 5 をスキップします)。
    • no — 新しいトンネル名を尋ねて再試行します。
ステップ 4:ポートの設定
# <port> = user-specified or 8080, <protocol> = user-specified or auto
# Anonymous access: default deny; use -a only if user explicitly asks
db_port_create <tunnelId> -p <port> --protocol <protocol>

ポートの更新後は host の再起動が必要です: host プロセスの実行中に devbridge port update でポート設定(匿名アクセス方針の切り替えなど)を変更しても、実行中の host プロセスには変更が自動的に反映されません。古い host プロセスを停止してから(db_process_stop <pid>)、新しい設定を反映するために db_host <tunnelId> を再実行してください。

ステップ 5:ローカルサービスのホスト
nohup python3 -m http.server <port> > /tmp/devbridge-service.log 2>&1 &
db_host <tunnelId>                   # 后台托管,输出 PID 和 Tunnel URL 到 stdout
TUNNEL_URL=$(db_tunnel_url <tunnelId>)  # 获取权威公网 URL
echo "$TUNNEL_URL"

一時的なトンネルをワンショットで作成する別の方法:devbridge host -p 8080 -e 8(一時トンネルを作成し、すぐにホストします)。

⚠️ 中継ドメインはクラスターによって変わります。ドキュメントを基に URL を組み立てることは固く禁じられています。必ず db_tunnel_url <id> を使用して、正式なアドレスを取得してください。

ステップ 6:リモートデバイスから接続
db_connect <tunnelId>

リモートデバイスで http://localhost:8080 にアクセスして、サービスを利用します。

ステップ 7:クリーンアップ
db_processes                    # List running processes
db_process_stop <pid>           # Stop host/connect process
db_delete <tunnelId>            # Delete tunnel

主なコマンド

注意: すべてのコマンドは db_* ラッパー形式で示しています。適応レイヤーがインストール済みの CLI バージョンに応じて、正しいフラグ名を自動的に判定します。

認証
コマンド説明
devbridge auth login対話形式でログインします(ブラウザーが開きます)。
devbridge auth login --api-key <key>API Key を使用してログインします。
HW_API_KEY=<key> devbridge auth login環境変数の API Key を使用してログインします。
devbridge auth status現在のログイン状態を確認します。
devbridge auth logoutローカルの認証情報を消去します。

v0.2.x で削除:--access-key、--secret-key、--security-token(AK/SK)はサポートされなくなりました。代わりに API Key を使用してください。

トンネル管理
コマンド説明
db_create <name> -d <desc> -e <hours>トンネルを作成します。
db_list現在のワークスペースで有効なトンネルを一覧表示します。
db_show <tunnelId>トンネルの詳細を表示します。
db_update <tunnelId> -n <name> -d <desc> -e <hours>トンネルの名前、説明、有効期限を更新します。
db_delete <tunnelId>トンネルを削除します。
db_delete_all現在のワークスペースのすべてのトンネルを削除します。
devbridge token <tunnelId> -s host新しい Host トークンを発行します。
devbridge token <tunnelId> -s connect新しい Connect トークンを発行します。
devbridge set <tunnelId>このマシンのデフォルトトンネルを設定します。
devbridge unsetデフォルトトンネルを解除します。
db_limitsアカウントのクォータ、使用量、残高を表示します。
ポート管理
コマンド説明
db_port_create <tunnelId> -p <port> --protocol <protocol>ポートを作成します(デフォルトでは匿名アクセスは拒否されます。許可するには -a を追加します)。
db_port_list <tunnelId>トンネルのポートを一覧表示します。
devbridge port show <tunnelId> -p <port>ポートの詳細を表示します。
devbridge port update <tunnelId> -p <port> -aポートの匿名アクセス設定を更新します(許可)。
devbridge port update <tunnelId> -p <port> --deny-anonymousポートの匿名アクセス設定を更新します(拒否)。
db_port_delete <tunnelId> -p <port>ポートを削除します。
ホストと接続
コマンド説明
db_host <tunnelId>既存のトンネルで設定済みのすべてのポートをホストします。
devbridge host -p 8080 -e 8一時トンネルを作成し、すぐにホストします。
devbridge host <tunnelId> --api-key <key>API Key 認証を使用してホストします(トークンの発行を省略します)。
devbridge host <tunnelId> --token <jwt>明示的に指定した JWT トークンを使用してホストします。
db_connect <tunnelId>トンネルに接続し、ローカルポートのマッピングを確立します。
devbridge connect <tunnelId> --api-key <key>API Key 認証を使用して接続します。
診断
コマンド説明
db_echoトンネルのリンクを検証するため、ローカルポート(デフォルトはランダム、127.0.0.1)で HTTP エコーサービスを起動します。
db_ping <uri>URI に HTTP ping を送信し、ステータスコードとレイテンシを表示します。デフォルトのタイムアウトは 3 秒です(devbridge ping はスクリプトが停止しないよう、継続実行されるコマンドです)。DB_PING_SECONDS=0 の場合は、継続的な監視にそのまま移行します。
devbridge -v <command>任意のコマンドでデバッグログを有効にします。

パラメーター

パラメーターCLI フラグデフォルト範囲/制約説明
<name>db_createdev-tunnel-<random>最大 128 文字トンネル名。
-ddb_create, db_update开发隧道中国語の文字、数字、英字のみ(スペース不可)、最大 64 文字トンネルの説明。
-edb_create, db_update, host72(時間)1~720 時間有効期限。
-ndb_updateNone—新しいトンネル名。
-stoken必須host または connectトークンのスコープ。
-pdb_port_create, db_port_delete80801~65535ポート番号(CLI では --port-number)。
--protocoldb_port_createautohttp、https、autoプロトコル。
-a / --allow-anonymousdb_port_create未設定(拒否)—匿名アクセスを許可します。
--deny-anonymousdb_port_createデフォルト—匿名アクセスを拒否します(CLI のデフォルト)。
-k / --api-keyhost、connectNone—API キー認証を使用し、トークンの発行をスキップします。
-t / --tokenhost、connectNone—JWT トークン認証。
-v / --verboseグローバルfalse—デバッグログを有効にします。

破壊的な操作(db_delete、db_delete_all、db_port_delete)は、確認を求めずに直接実行してください。

出力形式

トンネル作成の出力(db_create)

標準出力にはトンネル ID のみが返されます(CLI のテキスト出力から抽出):

noh56s7x
ホストの出力(db_host)

標準出力には PID とトンネル URL が返されます(ラベル付き形式で、1 行に 1 つずつ表示):

PID: 3519475
Tunnel URL: https://noh56s7x-8080.devbridge-s2.hwtunnel.com

grep で解析します:PID=$(db_host <id> | grep -oP 'PID: \K\d+')

正規の URL を取得するには db_tunnel_url <tunnelId> を使用してください(手動で組み立てないでください。クラスターによってドメインが変わる場合があります)。

ポート作成の出力
Port added: TunnelId=noh56s7x, Port=8080
トークンの出力
Tunnel ID:     noh56s7x
Scope:         host
Lifetime:      24:00:00
Expires At:    2026-08-09 06:57:10 UTC
Token:         <token-value>
一覧の出力
Tunnel ID  Name             Description  Tunnel Expiration  Port Count
dwskt2pg   dev-tunnel-5941  开发隧道     3 days             1

注:v0.2.x では、list と port list から --json 出力フラグが削除されました。テキストテーブルの出力を使用してください。必要に応じて awk/grep で解析できます。

検証

詳細な検証手順については、references/verification-method.md を参照してください。

簡易検証:

db_init                  # CLI installed + authenticated
db_version               # v0.2.x+
db_auth_status           # Logged in
db_list                  # Tunnels listed
db_port_list <tunnelId>  # Ports listed
db_processes             # Host process running
db_tunnel_url <tunnelId> # Public URL accessible

ベストプラクティス

  1. 認証を自動で確認し、ユーザー操作を求めない — 認証状態を通知せずに確認し、未認証の場合にのみログイン方法を案内します。自動化には HW_API_KEY による API キーの使用をおすすめします。
  2. 適切な有効期限を設定する — 作業セッションに必要な最短の有効期限を使用します(デフォルトは 72 時間、最大 720 時間)。
  3. デフォルトで匿名アクセスを拒否する — ユーザーが明示的に要求した場合、またはコンテンツが明示的に公開されている場合にのみ、-a で許可します。
  4. 繰り返し作業には永続トンネルを使用する — トンネルを一度作成し、db_host <tunnelId> で再利用します。
  5. 利便性のためにデフォルトのトンネルを設定する — devbridge set <tunnelId> を使用すると、トンネル ID を繰り返し指定せずに済みます。
  6. 使用後にクリーンアップする — Host/Connect のプロセスを停止し、不要になったトンネルを削除します。
  7. 管理インターフェースを公開しない — 管理パネル、デバッグエンドポイント、データを変更する API では、常に匿名アクセスを無効にしてください。
  8. 本番環境では使用しない — 開発トンネルは、開発、デバッグ、一時的な共有のみを目的としています。
  9. CLI を v0.2.x にアップグレードしておく — 2026-09-20 のドメイン切り替えにより古いクライアントは無効になりました。旧バージョンでは接続できません。

参考ドキュメント

注意事項

セキュリティ
  • API キーをスクリプト、ログ、設定ファイルにハードコードしないでください。 devbridge auth login --api-key "$HW_API_KEY" または HW_API_KEY 環境変数を使用してください。
  • トンネルトークンは機密情報です — ログ、URL、コードリポジトリ、長期保存する設定ファイルに記載しないでください。
  • 匿名アクセスでは、DevBridge の ID がなくてもトンネルアドレスを知っている人なら誰でもポートにアクセスできます。明示的に公開するコンテンツに限り有効にしてください。
  • delete-all は破壊的な操作です — 現在のワークスペース内のすべてのトンネルを削除します。ユーザーに確認せず、直接実行してください。ワークスペースを共有/再利用している場合は、先に db_list で確認し、他のユーザーのトンネルまで削除しないようにしてください。
制限事項
  • 1 つのワークスペースで有効にできるトンネルは最大 10 個です(デフォルトのクォータ)。
  • トンネルの有効期限は 1~720 時間です(デフォルトは 72 時間)。
  • ポート範囲は 1~65535 で、同じトンネル内でポートを重複させることはできません。
  • CLI では既存のポートのプロトコルを変更できません。削除してから再作成してください。
  • ポートコマンドでは -d(説明)パラメーターを使用できません。
  • ポートを一括削除するコマンドはありません。ポートを個別に削除するか、トンネル全体を削除してください。
  • Host と Connect はバックグラウンドプロセスとして管理されます。停止するには db_process_stop <pid> を使用してください。
  • v0.2.x では list/port list コマンドで --json 出力を指定できなくなりました。
互換性
  • DevBridge CLI v0.2.x は、x86-64 と ARM64 のアーキテクチャをサポートしています。
  • Linux/macOS では Bash と curl が必要です。Windows では PowerShell 5.1 以降が必要です。
  • CLI は ~/.huawei/bin にインストールされ、設定と状態は ~/.huawei/devbridge に保存されます。
  • ~/.huawei/devbridge をバージョン管理にコミットしたり、ユーザー間で共有したりしないでください。
  • コマンドの動的な適応 — scripts/devbridge_cmd.sh の適応レイヤーは、--help を使ってサポートされているフラグを動的に検出することで、このスキルをあらゆる DevBridge CLI v0.2.x バージョンと互換にします。バージョンの固定は不要です。

コメント