このプロジェクトについて

FxEmbedは、FxTwitter、FixupX、FxBlueskyの背後にあるプロジェクトで、X/TwitterやBlueskyのリンクがDiscordやTelegramなどのプラットフォームで共有された際の表示を改善するサービスです。単なるリンクではなく、複数の画像、動画、投票、引用投稿、翻訳などを含むリッチな埋め込みを生成します。 使用方法は、共有リンクのドメインを書き換えることに基づいています。twitter.comのリンクには「fx」を、x.comのリンクには「fixup」を、bsky.appのリンクには「fx」をドメインの前に追加します。書き換えられたリンクはサービスによって処理され、埋め込みに適した表現が返されます。 ドキュメント、APIリファレンス、セルフホスティングガイドはREADMEからリンクされています。このプロジェクトはCloudflare Workerとして実装されており、提供されるDockerイメージは、通常のNode.jsサーバーではなく、Wranglerを通じてローカルのWorkersランタイムを実行します。イメージはnode:24-bookworm-slimをベースにしています。これは、Wranglerのworkerdバイナリがglibcにリンクされており、Alpine/muslでは確実に動作しないためです。 セルフホスティングでは、READMEにカスタムドメイン、ブランディング、認証情報用の設定ファイルをコピーして編集し、Docker Composeでビルドして実行する方法が記載されています。ワーカーはlocalhost:8787で待機し、ルーティングはHostヘッダーに依存するため、特定のレルムをテストするにはそのヘッダーを設定する必要があります。.envの環境変数はビルド時にバンドルされるため、ドメインリストやその他のビルド時設定の変更にはイメージの再ビルドが必要です。CREDENTIAL_KEYやEXCEPTION_DISCORD_WEBHOOKなどの実行時シークレットは、シェルまたはComposeの.envファイルで指定できます。 このプロジェクトはMITライセンスの下で提供され、プルリクエストを受け付けています。Mosaicの複数画像コンバイナーや他の貢献者にクレジットを記載しています。免責事項として、Twitter、Tweet、XはX Corpの商標であり、このプロジェクトはX CorpやTwitterとは提携していないと記載されています。