OpenLiteSpeed 효율적인 캐시 정책 경고 해결 방법｜Expires 설정으로 PageSpeed 개선

효율적인 캐시 정책 경고는 워드프레스를 운영하면서 한 번쯤 만나게 되는 항목입니다. 저 역시 PageSpeed Insights를 점검하던 중 이미지와 CSS, JavaScript 파일에 대한 캐시 정책이 충분하지 않다는 경고를 확인했습니다.

처음에는 LiteSpeed Cache 설정 문제라고 생각했습니다. 캐시 플러그인 옵션을 확인하고 .htaccess 설정도 다시 살펴봤지만 특별히 잘못된 부분은 보이지 않았습니다.

문제는 모든 설정이 정상처럼 보였는데도 효율적인 캐시 정책 항목이 계속 남아 있었다는 점입니다. 여러 자료를 찾아보던 중 OpenLiteSpeed 서버 자체의 Expires 헤더 설정이 영향을 줄 수 있다는 내용을 확인했고, 실제로 적용한 뒤 경고가 사라졌습니다.

PageSpeed Insights가 지적한 항목

PageSpeed Insights에서 말하는 효율적인 캐시 정책은 브라우저 캐시와 관련된 항목입니다. 이미지, CSS, JavaScript 같은 정적 파일은 변경 빈도가 높지 않기 때문에 일정 기간 브라우저에 저장해 두는 것이 일반적입니다.

만료 시간이 짧거나 헤더가 제대로 전달되지 않으면 방문자가 다시 접속할 때마다 파일을 새로 받아야 하며, PageSpeed 검사에서도 경고가 나타날 수 있습니다. 워드프레스에서는 LiteSpeed Cache 같은 플러그인이 상당 부분 처리해주지만 서버 설정이 함께 맞춰지지 않으면 기대한 결과가 나오지 않는 경우도 있습니다.

OpenLiteSpeed WebAdmin에서 설정 위치 찾기

OpenLiteSpeed WebAdmin에서 Virtual Host 설정을 확인하는 화면 — OpenLiteSpeed Virtual Host 관리 화면

CyberPanel 환경에서 OpenLiteSpeed를 사용하고 있다면 WebAdmin 패널에 접속할 수 있습니다.

기본적으로 다음 주소로 접근 가능합니다.

https://도메인주소:7080

WebAdmin에 접속한 뒤 Virtual Hosts에서 대상 사이트를 선택했습니다.

검색한 자료에서는 Rewrite 영역에서 설정한다고 설명되어 있었지만 실제 서버에서는 해당 항목을 찾을 수 없었습니다. 메뉴를 하나씩 확인한 결과 Expires 관련 설정은 Rewrite가 아니라 General 탭 안에 있었습니다.

효율적인 캐시 정책 해결을 위한 Expires 설정

General 탭 안으로 들어가면 Expires Settings 항목을 확인할 수 있습니다. 기본 상태에서는 대부분 Not Set으로 되어 있으며 이 경우 브라우저 캐시 만료 시간이 충분히 전달되지 않을 수 있습니다.

편집 버튼을 눌러 설정 화면으로 이동했습니다.

OpenLiteSpeed Expires 설정을 수정하기 위해 편집 버튼을 선택한 화면 — Expires 설정 편집 메뉴 진입 화면

설정 화면에는 세 가지 항목이 있습니다.

Enable Expires
Expires Default
Expires By Type

Enable Expires는 Expires 헤더 사용 여부를 결정합니다.

Expires Default는 별도 설정이 없는 파일에 적용되는 기본 만료 시간입니다.

Expires By Type은 파일 형식별 만료 시간을 지정하는 항목입니다.

제가 적용한 값은 다음과 같습니다.

Enable Expires : Yes

Expires Default
A31557600

Expires By Type
image/jpg=A31536000,
image/jpeg=A31536000,
image/png=A31536000,
text/css=A2592000,
application/javascript=A2592000

이미지는 약 1년, CSS와 JavaScript는 약 1개월 동안 브라우저가 캐시하도록 설정한 값입니다.

설정 후 서버 재시작까지 진행

설정을 저장한 뒤에는 OpenLiteSpeed 재시작이 필요했습니다.

전체 서버를 강제로 종료하는 방식이 아니라 Graceful Restart를 사용하면 현재 연결을 유지하면서 설정을 반영할 수 있습니다.

OpenLiteSpeed 서버 설정 적용을 위해 Graceful Restart를 실행하는 화면 — OpenLiteSpeed Graceful Restart 실행 화면

재시작 이후 다시 PageSpeed Insights를 실행했고, 문제가 되었던 효율적인 캐시 정책 항목이 더 이상 표시되지 않았습니다.

왜 플러그인만으로 해결되지 않았을까?

정확한 원인은 아직 단정하기 어렵습니다. LiteSpeed Cache가 캐시 정책을 생성하고 있었지만 서버가 Expires 헤더를 충분히 전달하지 못했거나 Virtual Host 설정 우선순위 때문에 적용되지 않았을 가능성이 있습니다.

OpenLiteSpeed는 Server Level, Virtual Host Level, Context Level 설정이 서로 영향을 주기 때문에 환경에 따라 결과가 달라질 수 있습니다. 특히 CyberPanel 환경에서는 서버 기본 설정과 사이트별 설정이 다르게 동작하는 경우가 있어 한쪽만 확인해서는 원인을 찾기 어려울 수 있습니다.

적용 후 변화

Expires 설정을 적용한 뒤 다음과 같은 변화를 확인했습니다.

PageSpeed Insights 경고 제거
브라우저 캐시 만료 시간 정상 인식
정적 파일 재다운로드 감소
재방문 시 로딩 속도 개선
캐시 관련 진단 항목 감소

사이트 체감 속도가 극적으로 빨라지는 것은 아니었지만, 브라우저가 정적 자산을 효율적으로 활용하게 되면서 반복 방문 환경은 더 안정적으로 동작했습니다.

FAQ

효율적인 캐시 정책 경고는 반드시 해결해야 하나요?

사이트가 정상적으로 열리더라도 PageSpeed 점수와 브라우저 캐시 효율에 영향을 줄 수 있기 때문에 가능하면 해결하는 것이 좋습니다.

LiteSpeed Cache를 사용 중인데도 효율적인 캐시 정책 경고가 발생할 수 있나요?

발생할 수 있습니다. 플러그인 설정이 정상이어도 OpenLiteSpeed 서버의 Expires 헤더 설정이 적용되지 않은 경우 경고가 남을 수 있습니다.

OpenLiteSpeed 재시작 없이 적용되나요?

설정 저장만으로 반영되지 않는 경우가 있습니다. 변경 후 Graceful Restart를 실행하면 적용 여부를 확인하기 쉽습니다.