Об этом проекте

FxEmbed — это проект, стоящий за FxTwitter, FixupX и FxBluesky, сервисом, который улучшает отображение ссылок из X/Twitter и Bluesky при публикации на таких платформах, как Discord, Telegram и других. Вместо голой ссылки сервис создаёт более насыщенные встраивания, которые могут включать несколько изображений, видео, опросы, цитируемые публикации, переводы и многое другое. Использование основано на переписывании домена публикуемой ссылки. Для ссылок twitter.com пользователи добавляют «fx» перед доменом; для ссылок x.com добавляют «fixup»; а для ссылок bsky.app добавляют «fx». Переписанная ссылка затем обрабатывается сервисом, который возвращает представление, пригодное для встраивания. Документация, справочник по API и руководство по самостоятельному развёртыванию доступны по ссылкам из README. Проект реализован как Cloudflare Worker, а предоставляемый образ Docker запускает локальную среду выполнения Workers через Wrangler, а не обычный сервер Node.js. Образ основан на node:24-bookworm-slim, поскольку бинарный файл workerd из Wrangler слинкован с glibc и не работает надёжно на Alpine/musl. Для самостоятельного развёртывания README описывает копирование и редактирование файлов конфигурации для пользовательских доменов, брендинга или учётных данных, а затем сборку и запуск с помощью Docker Compose. Worker слушает localhost:8787, и поскольку маршрутизация зависит от заголовка Host, для тестирования конкретного realm необходимо задать этот заголовок. Переменные окружения из .env включаются в сборку на этапе сборки, поэтому изменения списков доменов или другой конфигурации времени сборки требуют пересборки образа. Секреты времени выполнения, такие как CREDENTIAL_KEY и EXCEPTION_DISCORD_WEBHOOK, можно передавать через оболочку или файл .env для Compose. Проект распространяется по лицензии MIT и принимает pull request'ы. В нём указаны заслуги комбайнера нескольких изображений Mosaic и других участников. В отказ от ответственности отмечается, что Twitter, Tweet и X являются товарными знаками X Corp и что проект не связан с X Corp или Twitter.