팁·활용

• 목록
• 스크랩

외부 동영상 iframe이 출력되지 않는 이유

유튜브 같은 동영상 플랫폼은 퍼가기 코드를 본문에 넣었을 때 바로 출력되지만, 카카오TV나 아프리카TV 등 일부 외부 사이트의 동영상은 화면에 보이지 않거나 필터링되는 경우가 발생합니다. 이는 그누보드 보안 필터와 HTMLPurifier 설정에서 해당 도메인이 허용되지 않았기 때문입니다.

그누보드 버전별 필터링 차이

그누보드4까지는 관련 함수를 이용해 iframe을 제어했으나, 그누보드5부터는 plugin/htmlpurifier/safeiframe.txt 파일을 통해 허용된 도메인을 관리합니다. 따라서 그누보드5 환경에서는 본문의 iframe 도메인 설정을 safeiframe.txt 파일에서 처리해야 합니다.

허용 도메인 추가 방법

외부 동영상 iframe 소스코드를 정상적으로 작동시키려면 설정 파일을 수정해야 합니다. 작업을 시작하기 전에 원본 파일을 백업해 두는 것이 안전합니다.

1. FTP 등을 통해 서버에 접속합니다.
2. /plugin/htmlpurifier/safeiframe.txt 파일을 엽니다.
3. 파일 내용에 허용할 도메인 주소를 한 줄씩 추가합니다.

tv.kakao.com/
vod.afreecatv.com/

예를 들어 카카오TV의 퍼가기 소스코드에서 http:// 앞부분을 제외한 tv.kakao.com/ 형식을 입력합니다. 도메인 뒤에는 가급적 슬래시(/)를 붙여줍니다.

설정 변경 후 점검 및 복구 방법

설정을 마친 뒤 관리자 페이지나 게시판에서 해당 동영상이 삽입된 글을 확인합니다. 만약 동영상이 여전히 노출되지 않거나 문제가 발생하면 safeiframe.txt 파일에 추가한 도메인 라인을 제거하여 원래 상태로 복구할 수 있습니다.

함께 보면 좋은 글

• 그누보드 회원가입 시 특정 이메일 도메인만 허용하도록 제한하는 방법