셀프호스팅으로 워드프레스를 직접 운영하고 있는데, 글과 디자인을 손보는 시간이 늘어나면서,
"사이트 인상이 왜 이렇게 밋밋할까?"라는 생각을 자주 했어요. 시스템 폰트만으로는 브랜드 톤이 잘
살아나지 않더군요. 그래서 한·영 혼용에서도 안정적으로 읽히는 Pretendard를 제가 운영하는
워드프레스에 적용해 보기로 했습니다. 가변(Variable) 폰트를 쓰면 요청 수와 용량을 줄이면서도
굵기를 유연하게 다룰 수 있어 성능 면에서도 이점이 큽니다. 외부 CDN에 의존하지 않고 제 서버에서
폰트를 제공하면 개인정보 측면이나 캐시/배포 관리도 한결 편해지고요.
이 글은 실제 적용 과정을 거치면서 경험한 내용을 정리한 것인데, 먼저 Astra의 Custom Fonts로
가장 쉽게 붙이고, 업로드가 막히면 에러 원인을 짚어 해결합니다. 그래도 막힌다면
WP-CLI로 우회 등록을 하고, 끝으로 플러그인 없이 @font-face만으로
완전 수동 적용하는 방법까지 정리했습니다.
시작 준비 — Pretendard 폰트 파일 다운로드
폰트는
Pretendard 최신 릴리스 페이지
에서 받습니다. 페이지에 표시된 최신 버전(vX.Y.Z)을 확인하고 ZIP을 내려받으세요.
예시: https://github.com/orioncactus/pretendard/releases/download/v1.3.9/Pretendard-1.3.9.zip
방법 A) PC에서 ZIP 다운로드(권장)
위 최신 릴리스 페이지에서 ZIP 다운로드.
압축 해제 후 web/static/woff2-subset/ 폴더에서 필요한 굵기(예: 300/400/500/700)만 선택.
이 파일들을 워드프레스 관리자에서 업로드하거나, 아래 섹션의 절차로 등록합니다.
방법 B) 서버에 직접 받기(curl/wget)
서버로 다운로드 & 압축 해제
# Pretendard 최신 버전은 여기서 확인:
# https://github.com/orioncactus/pretendard/releases/latest
# 1) 작업 폴더 준비
mkdir -p ~/fonts && cd ~/fonts
# 2) 버전 지정(릴리스 페이지에서 vX.Y.Z 확인 후 숫자만 넣으세요)
VER=1.3.9 # ← 최신 버전으로 바꾸기
# 3) 공식 ZIP 다운로드
curl -L -o Pretendard-${VER}.zip \
"https://github.com/orioncactus/pretendard/releases/download/v${VER}/Pretendard-${VER}.zip"
# 4) 압축 해제
unzip -q Pretendard-${VER}.zip
# 5) 웹 서브셋(용량 ↓)을 모아 둡니다.
mkdir -p ~/fonts/woff2 ~/fonts/woff
cp -f Pretendard-${VER}/web/static/woff2-subset/*.woff2 ~/fonts/woff2/ 2>/dev/null || true
cp -f Pretendard-${VER}/web/static/woff/*.woff ~/fonts/woff/ 2>/dev/null || true
# (다음 단계에서 /tmp 로 옮겨 chown 하는 절차가 나옵니다)
# 우리가 쓸 경로 예시: ~/fonts/woff2/Pretendard-*.woff2 , ~/fonts/woff/Pretendard-*.woff
TIP · 트래픽/용량을 줄이려면 woff2-subset 위주로 사용하세요.
구형 브라우저 호환이 필요하면 woff도 함께 준비합니다.
플러그인으로 간단 적용 — 처음이라면 편한 방법부터
플러그인 설치 · 관리자 → 플러그인 → 플러그인 추가 → “Custom Fonts (Brainstorm Force)” 설치/활성화.
Pretendard 파일 준비 · web/static/woff2-subset 기준으로 *.woff2 (필요시 *.woff) 선택.
폰트 등록 · 모양 → Custom Fonts → Add New Font → Font Name = Pretendard →
WOFF2/WOFF/TTF 칸에 굵기별 파일 업로드(예: 300/400/500/700).
테마에 적용 · 모양 → 사용자 정의 → Global → Typography → Body/Headings = Pretendard → 공개.
Elementor 쓰면 · Elementor → 설정 → 일반에서 “기본 글꼴/색상 비활성화(Disable Default …)” 체크 → 에디터 새로고침.
확인 · DevTools → Elements/Computed에서 font-family: 'Pretendard' & 네트워크에 .woff2 로드 확인.
업로드 에러? “이 파일 유형 업로드할 권한이 없습니다 / 서버에서 예상치 못한 응답”이 보이면, 아래 업로드 에러 해결을 먼저 보세요.
등록 후엔 Elementor 글꼴 목록에서도 바로 검색됩니다.
업로드 에러 해결 — 증상 진단 → 로그 확인 → 바로 조치
Pretendard .woff/.woff2 업로드 중
“이 파일 유형 업로드할 권한이 없습니다” 또는
“서버에서 예상하지 않은 응답이 있습니다”가 보일 수 있습니다.
아래 순서대로 보면 원인 파악 → 근거 로그 → 즉시 해결까지 한 번에 끝납니다.
1) 먼저 이렇게 확인(브라우저 + 서버)
브라우저: DevTools Network에서 async-upload.php 요청을 필터링 → Status가 200이 아니면 응답/콘솔 에러 문구를 확인.
Apache/ModSecurity: 서버에서 async-upload.php, multipart, id 200003 같은 키워드로 로그를 조회.
서버 즉시 점검 명령
# Apache 에러로그(Oracle/RHEL 계열 경로 예시)
sudo tail -n 200 /var/log/httpd/error_log
# ModSecurity 감사로그에서 업로드 관련만 추림
sudo egrep -i "async-upload\.php|multipart|id \"?200003" /var/log/httpd/modsec_audit.log | tail -n 80
# WordPress 디버그 로그(필요 시 wp-config.php에 아래 3줄 추가 후 재현)
# define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false);
sudo tail -n 200 /var/www/html/wordpress/wp-content/debug.log
샘플 로그 — 실제로는 이렇게 보입니다
ModSecurity (modsec_audit.log) — 업로드 엔드포인트에서 멀티파트 경계 오탐:
excerpt: modsec_audit.log
--abcdEF12-F--
Message: Access denied with code 403 (phase 2). [id "200003"]
[msg "Multipart parser detected a possible unmatched boundary."]
[uri "/wp-admin/async-upload.php"] [hostname "example.com"]
Apache 에러로그 — 같은 시각에 403과 함께 기록:
excerpt: error_log
[Tue Feb 04 12:55:22.123456 2025] [:error] ModSecurity: Access denied with code 403
for POST /wp-admin/async-upload.php (id "200003": Multipart unmatched boundary) ...
WordPress 디버그 — MIME 미허용 시 자주 보이는 형태:
excerpt: wp-content/debug.log
[04-Feb-2025 03:02:10 UTC] Notice: File type does not meet security guidelines (.woff2)
in /wp-admin/includes/file.php on line ...
2) 원인별 빠른 해결(요약)
증상 A · “이 파일 유형 업로드할 권한이 없습니다”
워드프레스가 .woff/.woff2 MIME을 기본 허용하지 않아서입니다. (관리자 한정 허용 권장)
MU 플러그인으로 woff/woff2 허용
cd /var/www/html/wordpress
sudo -u apache mkdir -p wp-content/mu-plugins
sudo tee wp-content/mu-plugins/allow-fonts.php >/dev/null <<'PHP'
증상 B · “서버에서 예상하지 않은 응답” + DevTools 403/500 ModSecurity가 async-upload.php 멀티파트를 오탐(id 200003)한 경우가 많습니다.
업로드 엔드포인트에만 예외를 주는 방식으로 해결합니다.
WP-CLI는 워드프레스를 브라우저 없이 서버 명령줄에서 조작하는 도구예요.
미디어 업로드가 보안 정책(ModSecurity), MIME 제한, 프록시·용량 제한 등으로 브라우저에서 막힐 때,
WP-CLI를 이용하면 파일을 직접 wp-content/uploads에 등록(첨부글 생성)할 수 있습니다.
언제 이 방식을 쓰나요?
관리자 화면에서 “.woff/.woff2 업로드 불가” 또는 “서버에서 예상치 못한 응답”이 반복될 때
방화벽/WAF(예: ModSecurity) 예외를 바로 못 열어줄 때 임시로 우회가 필요할 때
