Standalone（セルフホスト）
Standalone モードは、ADHDev 全体を 1 台のマシン上で実行します。ローカルダッシュボード、ローカルの HTTP/WebSocket API、session-host ランタイムを単一のプロセスにまとめます — アカウント不要、クラウド接続なし、P2P なし、TURN なし。
これは ADHDev の AGPL-3.0 オープンソースサーフェスであり、@adhdev/daemon-standalone として公開されています。
いつ使うか
制御したいものがすべて目の前のマシン上にあるとき、あるいは自分の LAN 経由で直接到達できるマシン上にあるときは、Standalone が正しい選択です。
これはクラウドダッシュボードのセルフホスト版の代替ではありません。Standalone は意図的に次を含んでいません:
- プッシュ通知 — 承認・完了・切断の通知がスマートフォンに届くことはありません
- インターネット越しのリモートアクセス — シグナリングサーバーがないため、ネットワークの外からの接続はありません
- マルチマシンのフリート — 1 つの standalone サーバーは自分のマシンだけを管理します
これらはクラウドの機能です。必要な場合は、クラウドデーモンについて はじめに を参照してください。
起動する
npm install -g adhdev
adhdev standaloneadhdev standalone は薄いラッパーです。CLI の入手元の npm チャンネルに合わせて @adhdev/daemon-standalone パッケージを解決し、起動します。OSS パッケージを直接実行することもできます:
npm install -g @adhdev/daemon-standalone
adhdev-standaloneグローバルに何もインストールせずに実行することもできます:
npx @adhdev/daemon-standaloneその後 http://localhost:3847 を開いてください。
起きるはずのこと: ダッシュボードが読み込まれ、ローカルマシンが表示されます。ログイン画面はありません — Standalone にはアカウントがないからです。
TIP
公開のインストールテスト済み経路は macOS と Windows です。Linux も Standalone では動作するかもしれませんが、サポートされた経路として提示できるほど検証されていません。
ポートとバインド
Standalone サーバーは、ダッシュボードと HTTP/WebSocket API を単一のポートから提供します。デフォルトは 3847 で、127.0.0.1（ループバックのみ）にバインドされます。
adhdev standalone --port 4000LAN アクセス
ネットワーク上の別のデバイスからダッシュボードに到達するには、ループバック以外のアドレスにバインドしてください:
adhdev standalone --host 0.0.0.0 --token <some-secret>--host は明示的なアドレスを受け取ります — IPv4 アドレス、IPv6 アドレス、または localhost。ブール形式はありません。値のない裸の --host や、認識できない値は、頼んでもいないバインドが静かに行われるのではなく、目に見える起動失敗になります。
WARNING
--host 0.0.0.0（または IPv6 の any-address ::）はすべてのインターフェイスにバインドします。Standalone はデフォルトでは認証がないため、そのポートに到達できる人は誰でもあなたのエージェントを完全に制御できてしまいます。公開バインドには必ず --token を組み合わせてください。認証なしで公開バインドした場合、サーバーは起動時に警告を出力します。
--token は、ダッシュボードが接続する前にそのトークンを要求します。これが Standalone にある唯一の認証メカニズムです。
フラグ
| フラグ | 用途 |
|---|---|
--port, -p <port> | HTTP/WS サーバーのポート（デフォルト 3847） |
--host, -H <address> | 明示的なバインドアドレス — IPv4、IPv6、または localhost（デフォルト 127.0.0.1） |
--token <token> | ダッシュボードの使用にこのトークンを要求する |
--dev | プロバイダースクリプトの作成・テスト用の DevConsole を有効にする |
--public <path> | ダッシュボード配布物へのカスタムパス |
--no-open | 起動時にブラウザを開かない |
--help, -h | 使い方を表示する |
Standalone で動作するもの
ダッシュボードが立ち上がれば、ローカルのエージェントサーフェスはクラウドモードと同じように動作します:
- CLI エージェント と ACP エージェント の検出と起動
- ダッシュボードからのチャットの読み取り、メッセージ送信、承認プロンプトへの応答
- セッションの一覧表示、切り替え、ターミナルビュー
- ローカルモードの MCP サーバー（
http://localhost:3847と通信します）
Standalone vs クラウド
| Standalone | クラウド | |
|---|---|---|
| アカウントの要否 | 不要 | 必要 |
| トランスポート | 自分のマシン上での直接 HTTP/WS | P2P WebRTC、ブロックされた NAT には TURN |
| インターネットから到達可能 | 不可 | 可能 |
| ダッシュボードあたりのマシン数 | 1 台 | プラン依存 |
| プッシュ通知 | なし | あり |
| 認証 | 任意の --token | OAuth、API キー、マシンシークレット |
| ライセンス | AGPL-3.0 | プロプライエタリ |
より詳細な設定
OSS リポジトリには、Standalone の内部に関するリファレンスドキュメントがあります — パスワード認証、保存されたホストのデフォルト値、ローカル設定ファイルの場所、ローカル API サーフェス、session-host ランタイム: