メインコンテンツへスキップ

​
概要

laravel-bluesky は Bluesky のリアルタイムストリームに接続するための2つの WebSocket コマンドを提供します。
  • Jetstream — Bluesky 独自のフィルタリング済み WebSocket エンドポイント。JSON 形式で軽量。
  • Firehose — AT Protocol の生のイベントストリーム。DAG-CBOR バイナリ形式で全データを受信。
WebSocket による長時間実行プロセスは VPS や EC2 などの常時起動サーバー または Laravel Cloud のカスタムワーカー が必要です。Laravel Vapor や Vercel などのサーバーレス環境では動作しません。

​
インストール

WebSocket 機能には Workerman が必要です。 
composer require workerman/workerman

​
Jetstream

​
概要

Jetstream は Bluesky が提供するフィルタリング済みの WebSocket サービスです。コレクション種別やユーザー DID でフィルタリングできるため、必要なイベントだけを効率的に受信できます。
特徴説明
データ形式JSON
フィルタリングコレクション・DID でフィルター可能
データ量フィルター次第で軽量
用途投稿・いいね・フォロー等の監視

​
起動方法

# すべてのメッセージを受信（フィルターなし）
php artisan bluesky:ws start

# デバッグ: 受信したすべてのメッセージを表示
php artisan bluesky:ws start -v

​
コレクションフィルター

-C オプションで受信するコレクションを絞り込みます。複数指定可能です。 
# 投稿といいねのみ受信
php artisan bluesky:ws start -C app.bsky.feed.post -C app.bsky.feed.like

# フォローのみ受信
php artisan bluesky:ws start -C app.bsky.graph.follow
主なコレクション:
コレクション内容
app.bsky.feed.post投稿の作成・削除
app.bsky.feed.likeいいね
app.bsky.feed.repostリポスト
app.bsky.graph.followフォロー
app.bsky.graph.blockブロック

​
DID フィルター

-D オプションで特定ユーザーのイベントのみ受信します。 
# 特定ユーザーの投稿のみ受信
php artisan bluesky:ws start -C app.bsky.feed.post -D did:plc:xxx -D did:plc:yyy

​
イベント処理

Jetstream コマンドは受信したメッセージの種別に応じて Laravel イベントを発火します。
イベントクラスタイミング
JetstreamMessageReceived全メッセージ受信時
JetstreamCommitMessageレコードの作成・更新・削除時
JetstreamIdentityMessageハンドル変更などの identity イベント時
JetstreamAccountMessageアカウント有効化・無効化時
イベントリスナーを作成してイベントを処理します。 
php artisan make:listener JetstreamPostListener

namespace App\Listeners;

use Revolution\Bluesky\Events\Jetstream\JetstreamCommitMessage;

class JetstreamPostListener
{
    public function handle(JetstreamCommitMessage $event): void
    {
        // コレクション種別を確認
        $collection = data_get($event->message, 'commit.collection');

        if ($collection !== 'app.bsky.feed.post') {
            return;
        }

        // 操作種別: create / update / delete
        $operation = $event->operation;

        // 投稿者の DID
        $did = $event->message['did'];

        // レコードの内容
        $record = data_get($event->message, 'commit.record');
        $text = data_get($record, 'text', '');

        info("[$operation] $did: $text");
    }
}

​
Firehose

​
概要

Firehose は AT Protocol の生のイベントストリームです。Bluesky ネットワーク上のすべてのレコード操作をバイナリ（DAG-CBOR）形式で受信します。
特徴説明
データ形式DAG-CBOR バイナリ（パッケージが自動デコード）
フィルタリングなし（全データを受信）
データ量非常に大量
用途全データの収集・アーカイブ
DAG-CBOR のデコードはパッケージが自動的に行います。イベントリスナーでは通常の PHP 配列としてデータを受け取れます。

​
起動方法

php artisan bluesky:firehose start

# デバッグ: 受信したメッセージを表示
php artisan bluesky:firehose start -v

​
イベント処理

Firehose コマンドも Laravel イベントを使ってメッセージを処理します。
イベントクラスタイミング
FirehoseMessageReceived全メッセージ受信時（生データ含む）
FirehoseCommitMessageレコードの作成・更新・削除時
FirehoseIdentityMessageidentity イベント時
FirehoseAccountMessageアカウントイベント時
FirehoseSyncMessageリポジトリ同期イベント時
php artisan make:listener FirehosePostListener

namespace App\Listeners;

use Revolution\Bluesky\Events\Firehose\FirehoseCommitMessage;

class FirehosePostListener
{
    public function handle(FirehoseCommitMessage $event): void
    {
        // コレクション種別を確認
        if ($event->collection !== 'app.bsky.feed.post') {
            return;
        }

        // 操作種別: create / update / delete
        $action = $event->action;

        // 投稿者の DID
        $did = $event->did;

        // レコードの内容（デコード済み配列）
        $record = $event->record;
        $text = data_get($record, 'value.text', '');

        info("[$action] $did: $text");
    }
}

​
設定

config/bluesky.php で接続先ホストやログ設定を変更できます。 
// Jetstream
'jetstream' => [
    'host' => env('BLUESKY_JETSTREAM_HOST', 'jetstream1.us-west.bsky.network'),
    'max' => env('BLUESKY_JETSTREAM_MAX', 0), // maxMessageSizeBytes (0 = 無制限)
    'logging' => [
        'driver' => env('BLUESKY_JETSTREAM_LOG_DRIVER', 'daily'),
        'days' => 7,
        'path' => env('BLUESKY_JETSTREAM_LOG_PATH', storage_path('logs/jetstream.log')),
    ],
],

// Firehose
'firehose' => [
    'host' => env('BLUESKY_FIREHOSE_HOST', 'bsky.network'),
    'logging' => [
        'driver' => env('BLUESKY_FIREHOSE_LOG_DRIVER', 'daily'),
        'days' => 7,
        'path' => env('BLUESKY_FIREHOSE_LOG_PATH', storage_path('logs/firehose.log')),
    ],
],
.env での設定例: 
BLUESKY_JETSTREAM_HOST=jetstream2.us-east.bsky.network
BLUESKY_JETSTREAM_MAX=1000000

​
Labeler との組み合わせ

Labeler サーバーと Jetstream / Firehose を同時に起動できます。Labeler が受け取ったラベリングリクエストの処理に Jetstream や Firehose のデータを利用できます。 
# Labeler + Jetstream（フォローイベントを監視）
php artisan bluesky:labeler:server start --jetstream -C app.bsky.graph.follow

# Labeler + Firehose（全データを受信）
php artisan bluesky:labeler:server start --firehose
Labeler の詳細は Labeler ページ を参照してください。

​
長時間実行プロセスの運用

WebSocket コマンドは長時間起動し続けるプロセスです。本番環境では Supervisor などのプロセス管理ツールを使用してください。

​
Supervisor 設定例

/etc/supervisor/conf.d/bluesky-jetstream.conf: 
[program:bluesky-jetstream]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/html/artisan bluesky:ws start -C app.bsky.feed.post
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=www-data
numprocs=1
redirect_stderr=true
stdout_logfile=/var/www/html/storage/logs/jetstream-worker.log
stopwaitsecs=3600

# Supervisor を再読み込みして起動
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start bluesky-jetstream:*

​
Laravel Forge のデーモン設定

Laravel Forge を使用している場合は、Daemons セクションからデーモンを追加します。
  • Command: php artisan bluesky:ws start -C app.bsky.feed.post
  • Directory: /var/www/html
  • User: forge

​
Laravel Cloud でのバックグラウンドプロセス設定

WebSocket コマンドは WebSocket クライアント として Bluesky のストリームに接続するため、Laravel Cloud でも動作します。Laravel Cloud のバックグラウンドプロセス（カスタムワーカー）として設定してください。 Laravel Cloud のバックグラウンドプロセス設定で Custom Worker を追加します。 Jetstream の場合: 
php artisan bluesky:ws start
Firehose の場合: 
php artisan bluesky:firehose start
デプロイ時のプロセス停止・再起動などはすべて Laravel Cloud 側で自動的に処理されます。バックグラウンドプロセスの設定以外に追加の設定は不要です。

​
注意事項

  • プロセスが予期せず終了した場合、autorestart=true で自動再起動されます。
  • メモリリークを防ぐため、定期的な再起動を検討してください。
  • 大量のメッセージを受信する Firehose では、リスナー内の処理は非同期（Queue Job）にすることを推奨します。
// リスナーで Queue Job にディスパッチする例

namespace App\Listeners;

use App\Jobs\ProcessFirehosePost;
use Revolution\Bluesky\Events\Firehose\FirehoseCommitMessage;

class FirehosePostListener
{
    public function handle(FirehoseCommitMessage $event): void
    {
        if ($event->collection !== 'app.bsky.feed.post') {
            return;
        }

        // 重い処理は Queue Job に委譲
        ProcessFirehosePost::dispatch($event->did, $event->record, $event->action);
    }
}
Source: src/Console/WebSocket
Last modified on April 25, 2026