| 자료 유형 | 모듈 |
|---|---|
| 간단한 소개 | youtube등 다양한 SNS/멀티미디어 서비스들의 주소를 붙여넣으면 자동으로 첨부되도록 합니다. |
| 설치 경로 | ./modules/oembed |
| 코어 지원 범위 | Rhymix 2.1 이상 |
| PHP 지원 범위 | PHP 8.4 이상 |
| 자료 구분 | 공개 자료 MIT |
| 저장소 URL | https://github.com/zodkr/rx-module-oembed |
에디터에 주소를 붙여넣으면 URL카드로 변환하거나, 첨부, 동영상으로 바로 변환해주는 모듈입니다.
- 코어 Remote 사용을 통한 프록시 등 일부 기능 사용 가능
- 일부 보안문제 해결(SSRF, 서버를 경유한 리퀘스트 공격)
- 쉬운 Provider 임베드 제공을 위한 화이트리스트 체크 및 제안기능
공식 지원 Provider
- X(Twitter)
비공식 지원 Provider(1.0.1 기준)
- Vimeo
- Chzzk
- Dailymotion
- Jsfiddle
- Codepen
- SOOP
Provider 추가 문의 및 자료 관련 문의는 Github 저장소로 문의주시기 바랍니다.
1.0.4
- Youtube Shorts 관련 Embed 비율 변환 추가
- IPv4 지원환경에서 IPv6로 리퀘스트가 잘못 넘어가던 문제 해결
- X(Twitter) 관련 URL 패턴 추가
![11080f7f-449e-4ef1-934c-5318856c7038.png [File Size:624.4KB/Download:6]](/files/download/link/1939790/a3c2a3b9923a1838e845f5434e2ce8ed/11080f7f-449e-4ef1-934c-5318856c7038.png){kind=link}
에카
Lv. 4
댓글 18
보안관련 수정이 있습니다. 특히 기존 preview 모듈 사용자분들에게 영향이 있을 수 있는 패치가 있으니 꼭 1.0.2버전을 받아서 적용해주시기 바랍니다.
유튭 테스트 해봤는데, 잘 되네요.... 동영상 많이 올리는 게시판에 유용하겠어요...
감사합니다~
유튜브 쇼츠 링크는 작동이 안되나요?
쇼츠 비율에 맞게 작업해두었었는데 어느새 풀린 모양입니다.
추후 시간이 될때 수정 및 테스트해서 올려보겠습니다.
프리뷰는 삭제해야하나요?
프리뷰 없으면 썸네일을 불러올수가 없어서서요
프리뷰 모듈과 기능이 중복되는 모듈이다보니 에디터에 중복으로 처리되는것을 방지하기위해 무조건 프리뷰 모듈은 같이 사용하시면 안됩니다.
썸네일 관련 작업이 조금 이루어지긴 했는데, 실제로 작동하지 않는것으로 보여서 해당 부분도 체크해보겠습니다.
답변 감사합니다. 기존에 모듈로 잘 사용하겠습니다. 감사합니다. 그리고 썸네일부분 기대하겠습니다 :)
1.0.4 업데이트를 진행했습니다.
IPv4 및 IPv6 모두 지원하는 환경에서 일부 썸네일이 첨부되지 않던 문제였는데, 해결된것으로 확인됩니다.
안녕하세요.
oembed 설치 및 기존 프리뷰 모듈 삭제를 했습니다. 이후 개인적인 문제( 영상 영역 부분이 레이아웃 css와 충돌, 화면이 많이 깨져 보이는 문제 )로
다시 oembed 폴더를 삭제 후 기존 프리뷰 모듈 소스 그대로 업로드 하였습니다.
이후 다시 프리뷰 모듈상태에서 유튜브 동영상 썸네일이 생성되지 않는 문제를 발견하고 원인을 찾고 있는데요. 혹시 oembed 설치 후 삭제 시 파일 부분만 삭제를 하면 되는 부분인지 아니면 디비나 기타 설정부분에서 링크 프리뷰 모듈에 영향을 끼치는 부분이 혹시 있을 지 문의드립니다.
링크 프리뷰 모듈이 정상적으로 작동되는 다른 사이트에서는 코드가 아래처럼 보이는데요.
<img data-autoattach="success" src="/files/attach/images/2026/05/15/dcce39dde7974d48d008ea0477c325e1.jpg" />
썸네일이 생성되지 않는 ( 에디터내 자동 파일첨부가 안되는 ) 저의 경우
<img src="https://i.ytimg.com/vi/dpeAk8_oRNs/maxresdefault.jpg" /> 의 형태로 신규 등록 게시물과 기존 게시물 소스가 바뀌어 있는 데 oembed 혹시 연관이 있는 부분일까요?
안녕하세요, oembed는 별도로 본문 컨텐츠의 내용을 개입하지 않습니다.
실제 개입하는 부분은 있지만, 해당부분은 섬네일 파일의 컨텐츠 내 존재여부를 체크하고 파일을 삽입/삭제하는것이기 때문에 별개의 작업입니다.
에디터 내 자동 파일첨부와 관련하여는 ckeditor 간섭을 위한 oembed/tpl/js/_ckeditor.js 파일과 관련하여 간섭이 있을 수 있습니다.
해당 파일이 지속적으로 불러와지는지 한번 검토해보시고, 캐시 초기화 등 진행해보셨음에도 지속된다면 한번 상세하게 파악이 필요해보입니다.
참고로 현재버전 기준으로 oembed 모듈은 별도 이미지 태그를 생성하지 않습니다.
답변 감사합니다. 원인이 저쪽에 있는 것 ㄱ같은데요. 확인 해보겠습니다.
안녕하세요. 혹시 아래 부분 재현이 되시는 지 아니면 저만의 환경 문제일지 문의드립니다.
라이믹스 최신버젼 + php7.4 + 기본 ckeditor + oembed최신버젼 + 기본 레이아웃 + 기본 게시판 스킨 상태입니다.
정상 동작: 1. 빈 에디터에 유튜브 URL만 붙여넣기 → 결과: 영상 정상 임베드
비정상동작: 1. 에디터에 텍스트 입력 후 Enter 키 → 유튜브 URL 붙여넣기 → 글쓰기 화면에서 영상 임베드 안되고 링크 보임 -> 글 저장 후에도 동일하게 영상 임베드 안되고 영상 url 링크만 노출되는 현상입니다.
콘솔 네크웍에서 특별한 에러 메시지는 없구요. 에디터 상에서 엔터키를 치고 동영상 url을 붙여넣기 했을 때 보여지는 소스 예시 입니다.
<p>테스트입니다.<br />
<a href="https://youtu.be/dpeAk8_oRNs?si=mww9RIJHifRv4Onj">https://youtu.be/dpeAk8_oRNs?si=mww9RIJHifRv4Onj</a></p>
자료 감사합니다.
해당 모듈은 PHP 8.4를 목표로 개발하였기에 7버전대에서는 예상하지 못한 오동작이 발생할 수 있습니다.
저의 경우 해당 주소가 문제없이 첨부됩니다.
그리고 리퀘스트를 지속적으로 변형시키는 등의 에러가 있을것을 염두하여 잘못된 요청을 보내는 경우 클라이언트에서 1시간동안 비활성화 되도록 설정되어있습니다.
그부분이 문제가 아닐지 의심되네요.
아 제가 지원 버젼 확인을 못했습니다. 답변감사합니다.
테스트 과정에서 연속으로 여러개 글 등록 하는 과정에서 답변주신 비활성화되는 부분이 일시적으로 생긴것 같구요, php7.4에서도 같은 내용(텍스트+유튜브동영상)으로 문제가 되었던 부분이 일정시간이 지난 현재는 특별한 문제없이 잘 작동되고 있는 것 같습니다. 감사합니다.
너무 좋은 자료 감사드립니다.
근데 유튜브 쇼츠 영상 첨부 파일과 본문의 썸네일(원본 영상 썸네일)이 다르게 나오는데요.
해서 게시판 썸네일도 원본 영상과 다르게 나와서요.
유튜브 일반 동영상은 잘 나오고 있어요.
확인 좀 부탁드립니다.
https://news.busan3.com/shorts
안녕하세요. 해당 영상의 섬네일이 실제로 임베디드로 보이는 섬네일과 다를 수 있습니다. (유튜브쪽 문제라고 봐주시면 좋을것같습니다)
그럼에도 불구하고 문제 파악을 진행하려 했지만, 제가 현재 해외라 그런지 확인이 불가능합니다.
Forbidden
You don't have permission to access this resource.
라고 뜨며 확인이 불가능하기에 추후 파악해서 패치에 적용토록 하겠습니다.
감사드립니다