프로젝트 소개

FxEmbed는 FxTwitter, FixupX, FxBluesky를 뒷받침하는 프로젝트로, Discord, Telegram 등에서 X/Twitter와 Bluesky 링크가 공유될 때 표시되는 방식을 개선하는 서비스입니다. 단순한 링크 대신 여러 이미지, 동영상, 투표, 인용 게시물, 번역 등을 포함할 수 있는 더 풍부한 임베드를 생성합니다. 사용 방식은 공유 링크의 도메인을 다시 쓰는 것을 기반으로 합니다. 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 헤더에 의존하므로 특정 realm을 테스트하려면 해당 헤더를 설정해야 합니다. .env의 환경 변수는 빌드 시 번들로 포함되므로 도메인 목록이나 기타 빌드 시 구성 변경에는 이미지를 다시 빌드해야 합니다. CREDENTIAL_KEY 및 EXCEPTION_DISCORD_WEBHOOK 같은 런타임 시크릿은 셸 또는 Compose .env 파일을 통해 제공할 수 있습니다. 이 프로젝트는 MIT 라이선스로 제공되며 풀 리퀘스트를 받습니다. Mosaic 다중 이미지 결합기와 기타 기여자들에게 감사를 표합니다. 면책 조항에서는 Twitter, Tweet 및 X가 X Corp의 상표이며 이 프로젝트가 X Corp 또는 Twitter와 제휴 관계가 없음을 명시합니다.