> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin のブラウザプレビュー

> Devin のマシン上で動作しているウェブアプリを非公開リンクから開けます。プレビュー URL、アクセス、複数ポート、ポートトンネリング、スリープ中のセッションの仕組みについて説明します。

ブラウザプレビューとは、Devin のマシン上で動作している Webアプリケーションにアクセスするための非公開リンクです。Devin はセッション内で開発サーバーを起動すると、そのポートを公開し、Web ブラウザで開けるリンクを共有できます。

プレビューは技術スタックを問わず利用できます。ポート上で HTTP を提供するものであれば、Devin でプレビューできます。アプリとそのデータは Devin のマシン上に保持され、サードパーティのサービスに何かがアップロードされることはありません。

> [!NOTE]
>
> このページでは、Devin セッションにおけるプレビューについて説明します。Devin Desktop でローカル開発サーバーをプレビューする方法については、[Devin Desktop プレビュー](https://docs.devin.ai/ja/desktop/previews.md)を参照してください。

## プレビューを開く

Devin は、あなたに確認してほしいアプリを起動すると、プレビューを開きます。例えば「アプリをプレビューして」のように依頼して、プレビューを開かせることもできます。

Devin はチャットに **Open preview** カードを投稿します。カードをクリックすると、セッションの **プレビュー** タブでアプリが開きます。新しいブラウザタブでプレビューを開く場合は、Cmd キーまたは Ctrl キーを押しながらカードをクリックするか、カードを中クリックします。

Slack から開始したセッションでは、スレッドに **Open preview** リンクが投稿されます。

## プレビュー URL

プレビュー URL は次のような形式です。

```
https://<name>--<id>.preview.devinapps.com
```

名前の部分は、Devin がプレビューに付けた名前に由来します。id はランダムに生成されるため、URL が推測されることはありません。

URL はセッションに紐付いています。Devin がアプリを再起動したり、別のポートに移したりしても、URL は変わりません。別のセッションのプレビューには、別の URL が割り当てられます。

プレビュー URL では、別の構文を使って、Devin がマシン上で公開している各ポートを個別に指定することもできます。

```
https://<port>--<devin-id>.preview.devinapps.com
```

これらのポートは Devin が公開する必要がありますが、いったん公開されると、誰でもアクセスできるようになります。

## プレビューを開けるユーザー

プレビューは非公開です。パブリックなインターネットには一切公開されません。

プレビューの URL を開くには、Devin にサインインしている必要があります。サインイン後は、プレビューへのアクセス権はそのセッションのアクセス設定に従います。セッションにメッセージを送信できるユーザーであれば、そのプレビューを開くことができます。

デフォルトでは、組織内で Devin セッションを利用できるすべてのユーザーが対象となるため、チームメイトにリンクを送るだけでそのまま開いてもらえます。セッションがオーナーのみ、または特定のユーザーに制限されている場合は、それらのユーザーだけがプレビューを開けます。それ以外のユーザーには、プレビューを利用できない旨のページが表示されます。

## プレビュータブでできること

プレビュータブは小さなブラウザのように動作します。進む、戻る、再読み込み、ズーム、ページ内検索の各ボタンに加え、デスクトップ、タブレット、モバイルの幅を切り替えるデバイスサイズ切り替え機能を備えています。

ページ上の要素に注釈を付けて、Devin に変更内容を伝えることもできます。セッションで「選択」ボタンを使用する場合は、要素をクリックするか領域をドラッグし、メモを追加してチャットに送信するだけです。Devin は、選択された要素とあなたのメモを受け取ります。

## 複数のポートを使用するアプリ

プレビューでは、あるポートでフロントエンドを、別のポートでバックエンド API を動かすなど、複数のポートを扱えます。Devin はプレビューを開く際にそれらのポートをすべて一覧表示し、プレビューは最初のポートで開きます。ポートを切り替えるには、プレビュータブの **Ports** メニューを利用します。

フロントエンド側でプレビュー URL を意識する必要はありません。ページが `http://localhost:8000` を呼び出すと、プレビューはそのリクエストを Devin のマシン上のポート 8000 に転送します。これは、プレビューがインストールする Service Worker があなたのブラウザ内でリクエストを書き換えることで実現されており、WebSocket 接続も同様に処理されます。リクエストはプレビュー自体のアドレス上で完結するため、CORS 設定を変更する必要はありません。

この仕組みで接続できるのは、Devin がプレビュー用に公開したポートのみです。

## アプリからの見え方

サーバーからは、リクエストは `localhost` から送られてきたように見えます。プレビューはリクエストがアプリに届く前に `Host` ヘッダーと `Origin` ヘッダーを `localhost` に設定するため、ホスト名をチェックする開発サーバーも追加の設定なしで動作します。Devin も、アプリの実行時とテスト時のどちらでも引き続き `localhost` を利用します。

ただし、自分のコンピューターでアプリを実行する場合とは、いくつかの点で動作が異なります。

* **Service Worker。** プレビューは独自の Service Worker を利用するため、アプリ側で Service Worker を登録することはできません。アプリが PWA の場合は、開発時に Service Worker を無効にするか、ポートの自動書き換えが機能しない場合があることを許容してください。
* **クッキー。** プレビュータブ内でアプリが設定したクッキーは、プレビューを別のブラウザタブで開いたときに設定されたクッキーとは別々に保持されます。そのため、一方でアプリにサインインしても、もう一方で再度サインインが必要になる場合があります。
* **アイデンティティプロバイダーによるサインイン。** ブラウザが開いているのは `localhost` ではなくプレビュー URL です。Microsoft Entra ID、Okta、Google などのプロバイダーでは、リダイレクト URL として `localhost` しか登録されていない場合、サインインが拒否されます。[ポートのトンネリング](#tunneling-ports)を参照してください。
* **HTTPS 開発サーバー。** ブラウザに表示されるのは、サーバーの証明書ではなく Devin の証明書です。[HTTPS ループバック](#https-loopback)を参照してください。

## ポートのトンネリング

一部のサービスは、ブラウザが実際に `localhost` 上にある場合にしか動作しません。代表的な例が、アイデンティティプロバイダーを介したサインインです。プロバイダーは登録済みのリダイレクト URL しか受け付けず、ほとんどの開発環境では `http://localhost:<port>` が登録されています。プレビューには独自の URL があるため、プロバイダーに拒否されてしまいます。

このような場合は、Devin のマシンから手元のコンピューターへポートをトンネルできます。これにより、アプリはブラウザ上で `http://localhost:<port>` として開かれ、自分のコンピューターで実行している場合と同じように扱われるため、プロバイダーにも受け付けられます。

ポートをトンネルする方法は 2 つあります。

* **Devin Desktop：** Devin Desktop でセッションを開き、そこからポートをフォワードします。
* **SSH：** `devin forward <session> 3000` を実行するか、`devin ssh` または通常の `ssh` に `-L 3000:localhost:3000` を渡します。[ポートのフォワード](https://docs.devin.ai/ja/cli/ssh.md#forward-ports)を参照してください。

トンネルにアクセスできるのはトンネルを実行しているコンピューターだけなので、チームメイトに共有できるリンクにはなりません。共有にはプレビューを、`localhost` が必要な場合にはトンネルを利用してください。

プレビューを使い続けたい場合は、セッションのプレビュー URL をプロバイダーのリダイレクト URL リストに追加するか、プロバイダーを経由しない開発用のサインイン手段をアプリに用意してください。また、Devin は自身のブラウザで `localhost` にサインインすることもできます。[Interactive Browser](https://docs.devin.ai/ja/work-with-devin/devin-session-tools.md#interactive-browser)を参照してください。

## HTTPS ループバック

ポートで HTTPS を提供する開発サーバーは、追加のセットアップなしでプレビューで動作します。Devin はそのポートが HTTPS で通信していることを検出し、HTTPS で接続します。

ブラウザからはあなたのサーバーの証明書は見えません。プレビュー URL は Devin の証明書を使って提供されます。開発サーバーへの接続は Devin のマシン上で行われ、そこではあなたの証明書はチェックされないため、自己署名の開発用証明書でも警告は表示されません。

これが影響するのは、ブラウザに特定の証明書が提示されることを前提とするアプリなど、ごく限られたケースのみです。

## スリープ中のセッション

セッションがアイドル状態になると、Devin のマシンはスリープします。手動で復帰させる必要はありません。プレビューを開くとマシンが復帰し、アプリは同じ URL で再び利用できるようになります。最初のページの読み込みには数秒かかる場合があります。

プレビューを利用している間はマシンが稼働し続け、最後のリクエストから約 5 分後に再びスリープします。

セッションが archive されるか終了すると、プレビューは利用できなくなります。

## プレビューとDevin Apps

プレビューは1つのセッションに紐づいています。作業途中の内容の確認、変更のレビュー、Devinが作成したもののチームメンバーへの共有などに使うものです。ほとんどの作業はプレビューだけで十分です。

一方、Devin Appsは別の用途向けです。セッションの作業が完了した後もチームで使い続ける社内ツールやダッシュボードなどのアプリを想定しています。そうしたアプリを構築している場合は、プレビューを[Devin App](https://docs.devin.ai/ja/product-guides/devin-apps.md)として公開するようDevinに依頼できます。Devin Appsはプレビューと同じくDevin のマシンから配信されますが、固定のURLと、独自の充実した共有設定が用意されています。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.