huawei-cloud-devbridge-tunnel について
Huawei Cloud DevBridge の開発トンネルを管理し、リモートデバイスからローカルサービスへ接続するためのスキルです。中継接続を使うため、ホスト側でパブリックな受信ポートを開く必要はありません。
主な機能
- 01トンネルの作成・更新・削除
- 02トンネルのポートとプロトコル設定
- 03ホストと接続セッションのバックグラウンド起動
- 04トンネル URL、プロセス、ログの確認
- 05接続と使用量の確認
活用シーン
- 01チームでのリモートデバッグと結合テスト
- 02開発中のウェブページの関係者との共有
- 03ローカル開発中の Webhook 受信
- 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.pyreferences/acceptance-criteria.mdcli-command-reference.mdcli-installation-guide.mdiam-policies.mdrest-api-reference.mdtroubleshooting.mdverification-method.mdscripts/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_create | devbridge create | トンネルを作成し、トンネル ID のみを返します(標準出力) |
db_port_create | devbridge port create | ポートを作成します(ポート、プロトコル、匿名フラグに対応します) |
db_host | devbridge host | バックグラウンドでホストを開始し、PID(標準出力)とトンネル URL(標準エラー出力)を返します |
db_host_bg | devbridge host + nohup bash -c | バックグラウンドでホストします(旧式の別名です。代わりに db_host を使用してください) |
db_connect | devbridge connect | バックグラウンドで接続を開始し、PID(標準出力)を返します |
db_list | devbridge list | トンネルを一覧表示します |
db_show | devbridge show | トンネルの詳細を表示します |
db_update | devbridge update | トンネルを更新します |
db_delete | devbridge delete | トンネルを削除します |
db_delete_all | devbridge delete-all | すべてのトンネルを削除します |
db_port_list | devbridge port list | ポートを一覧表示します |
db_port_delete | devbridge port delete | ポートを削除します(ポートフラグに対応します) |
db_limits | devbridge limits | クォータ/使用状況/残高を表示します |
db_echo | devbridge echo | 診断用エコーサービスを開始します |
db_ping | devbridge ping | URI に ping を実行して接続をテストします |
db_version | devbridge version | CLI のバージョンを表示します |
db_auth_status | devbridge auth status | 認証状態を確認します |
db_auth_login | devbridge 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 コマンドが無効または不足している認証情報が原因で失敗した場合:
devbridge auth statusを確認します。ログインしていない場合は、ログインします(対話形式または--api-key)。- API Key を使用している場合は、有効期限切れや削除済みでないことを確認します。API Key 管理ページで再作成し、
HW_API_KEYを介して設定してください。 - 手順については references/iam-policies.md を参照してください。
- 実行を一時停止し、認証情報が更新されたことをユーザーが確認するまで待ってから再試行してください。
システム要件
- 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が失敗した場合:
db_listを実行し、既存のトンネルを探します。- 使用状況を確認します(ユーザーには提示しません):
db_port_list <tunnelId>(ポートが設定されているか)、ps aux | grep "devbridge host <tunnelId>" | grep -v grep(ホストが実行中か)、ps aux | grep "devbridge connect <tunnelId>" | grep -v grep(接続セッションが実行中か)。- トンネルの詳細と使用状況を提示します:アクティブ(ホストが実行中/セッションがアクティブ — 再利用すると競合する可能性があります)、アイドル(ポートは設定済みだが、アクティブなプロセスはない — 安全に再利用できます)、または空(ポートなし — セットアップが必要です)。
- 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_create | dev-tunnel-<random> | 最大 128 文字 | トンネル名。 |
-d | db_create, db_update | 开发隧道 | 中国語の文字、数字、英字のみ(スペース不可)、最大 64 文字 | トンネルの説明。 |
-e | db_create, db_update, host | 72(時間) | 1~720 時間 | 有効期限。 |
-n | db_update | None | — | 新しいトンネル名。 |
-s | token | 必須 | host または connect | トークンのスコープ。 |
-p | db_port_create, db_port_delete | 8080 | 1~65535 | ポート番号(CLI では --port-number)。 |
--protocol | db_port_create | auto | http、https、auto | プロトコル。 |
-a / --allow-anonymous | db_port_create | 未設定(拒否) | — | 匿名アクセスを許可します。 |
--deny-anonymous | db_port_create | デフォルト | — | 匿名アクセスを拒否します(CLI のデフォルト)。 |
-k / --api-key | host、connect | None | — | API キー認証を使用し、トークンの発行をスキップします。 |
-t / --token | host、connect | None | — | 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
ベストプラクティス
- 認証を自動で確認し、ユーザー操作を求めない — 認証状態を通知せずに確認し、未認証の場合にのみログイン方法を案内します。自動化には
HW_API_KEYによる API キーの使用をおすすめします。 - 適切な有効期限を設定する — 作業セッションに必要な最短の有効期限を使用します(デフォルトは 72 時間、最大 720 時間)。
- デフォルトで匿名アクセスを拒否する — ユーザーが明示的に要求した場合、またはコンテンツが明示的に公開されている場合にのみ、
-aで許可します。 - 繰り返し作業には永続トンネルを使用する — トンネルを一度作成し、
db_host <tunnelId>で再利用します。 - 利便性のためにデフォルトのトンネルを設定する —
devbridge set <tunnelId>を使用すると、トンネル ID を繰り返し指定せずに済みます。 - 使用後にクリーンアップする — Host/Connect のプロセスを停止し、不要になったトンネルを削除します。
- 管理インターフェースを公開しない — 管理パネル、デバッグエンドポイント、データを変更する API では、常に匿名アクセスを無効にしてください。
- 本番環境では使用しない — 開発トンネルは、開発、デバッグ、一時的な共有のみを目的としています。
- CLI を v0.2.x にアップグレードしておく — 2026-09-20 のドメイン切り替えにより古いクライアントは無効になりました。旧バージョンでは接続できません。
参考ドキュメント
- CLI インストールガイド — DevBridge CLI のインストール、PATH の設定、動作確認。
- API キーとアクセス — API キーの管理、認証方法、権限エラーへの対処。
- 検証方法 — インストール、設定、機能を段階的に検証する方法。
- 受け入れ基準 — スキルテストの合否基準。
- CLI コマンドリファレンス — すべてのパラメーターを含む CLI コマンドの完全なリファレンス。
- REST API リファレンス — トンネルとポートをプログラムから管理するための REST API。
- トラブルシューティング — よくある問題と解決方法。
注意事項
セキュリティ
- 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 バージョンと互換にします。バージョンの固定は不要です。