그누보드 HTMLPurifier 외부 동영상 iframe 허용 도메인 설정 방법

• 목록
• 스크랩

그누보드 HTMLPurifier 외부 동영상 iframe 허용 도메인 설정 방법

그누보드 게시판 본문에 유튜브 외 카카오TV나 아프리카TV 등 외부 동영상 iframe이 출력되지 않을 때 HTMLPurifier 허용 도메인을 추가하여 해결하는 방법을 알아봅니다.

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

유튜브 등 일부 동영상 플랫폼의 퍼가기 코드는 본문에 넣었을 때 바로 출력되지만, 카카오TV나 아프리카TV 등 외부 사이트의 동영상은 화면에 보이지 않거나 필터링되는 현상이 발생할 수 있습니다.

이는 그누보드 보안 필터와 HTMLPurifier 설정에서 해당 외부 사이트의 도메인이 허용되지 않았기 때문입니다.

그누보드5 HTMLPurifier 설정 파일 경로

그누보드5 환경에서 외부 동영상 iframe 도메인을 허용하기 위해 수정해야 하는 설정 파일의 경로와 이름은 다음과 같습니다.

• 파일 경로 및 이름: /plugin/htmlpurifier/safeiframe.txt

작업을 시작하기 전에 FTP 등을 통해 서버에 접속하여 원본 파일을 백업해 두는 것이 안전합니다.

safeiframe.txt 도메인 입력 형식

그누보드5 환경에서 외부 동영상 iframe을 허용하기 위해 /plugin/htmlpurifier/safeiframe.txt 파일에 도메인을 추가할 때의 올바른 작성 형식은 다음과 같습니다.

• 작성 형식: 카카오TV나 아프리카TV 등의 퍼가기 소스코드에서 http:// 앞부분을 제외한 주소를 입력합니다.
• 슬래시 추가: 도메인 뒤에는 가급적 슬래시(/)를 붙여줍니다.

입력 예시

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

파일에 도메인을 한 줄씩 추가한 뒤 설정을 저장하고 관리자 페이지나 게시판에서 동영상이 정상적으로 출력되는지 확인합니다.

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

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

그누보드5 외부 동영상 iframe 허용 설정

• 내 상황: 게시판 본문에 외부 동영상 퍼가기 코드를 삽입했으나 화면에 출력되지 않음
• 선택 기준: 그누보드5 환경에서 HTMLPurifier 보안 필터에 의해 해당 도메인이 차단된 경우
• 다음 행동: FTP로 서버 접속 → /plugin/htmlpurifier/safeiframe.txt 파일 열기 → 허용할 도메인 주소를 한 줄씩 추가(예: tv.kakao.com/) 후 저장

실전 FAQ

Q. 도메인 입력 시 주의사항이 있나요?

• 답변: http:// 또는 https://를 제외하고 도메인 주소만 입력합니다. 도메인 뒤에는 가급적 슬래시(/)를 붙여야 정상적으로 인식됩니다.

Q. 설정 후에도 동영상이 나오지 않으면 어떻게 하나요?

• 답변: 추가한 도메인 라인을 삭제하여 설정을 원래대로 복구한 뒤, 입력한 도메인 형식이 올바른지 다시 확인하십시오.

참고자료

기타 참고자료

• mercury-seed.com — 그누보드 HTMLPurifier 외부 동영상 iframe 허용 도메인 설정 방법
• sir.kr — safeiframe.txt 가 동작하지 않습니다. - SIR - 개발자 커뮤니티