CSP 설정하는 법: 인라인 스크립트 해시가 깨질 때
「인라인 스타일과 스크립트를 해시로 잠그면 왜 깨질까?」 Windows CRLF 줄바꿈과 Cloudflare 분석 스크립트 충돌 해결.

정적 웹사이트에서 외부 CSS와 자바스크립트 요청을 없애려고 모든 코드를 HTML 안에 인라인으로 넣으면서, 동시에 unsafe-inline 없이 엄격한 CSP(Content-Security-Policy)를 유지하려면 어떻게 해야 할까?
가장 확실한 방법은 빌드 시점에 <style>과 <script> 태그 안의 텍스트를 SHA-256으로 해싱해 응답 헤더(_headers)에 'sha256-...' 목록으로 적어 주는 것이다.
카보틴 스튜디오 공식 홈(kavotin.com)은 첫 화면 표시 시간(FCP)을 줄이려고 홈 CSS(11월 20일 빌드 기준 18.0KB)와 블로그 추가 CSS(10.4KB), 카드 가로 넘김 스크립트(src/main.js), 구조화 데이터(application/ld+json)를 모두 HTML 안에 인라인으로 굽고 default-src 'none' 기반의 해시 CSP를 걸었다.
하지만 이 해시 CSP는 두 번 흔들렸다. 11월 11일에는 Cloudflare가 응답에 끼워 넣은 스크립트가 실제로 막혔고, 11월 15일에는 Windows 줄바꿈 문자(CRLF)가 원본 파일에 섞여 들어온 것을 굽기 전에 찾아냈다. 두 원인과 build.mjs · test/check.mjs에 넣은 대책을 기록한다.
외부 요청을 없앤 인라인 구조와 해시
홈페이지 첫 화면을 캐시 없이 열 때 브라우저가 별도의 .css나 .js 파일을 다시 요청하면 왕복 지연(RTT)이 한 번 더 든다.
그래서 build.mjs는 주석과 공백을 압축한 CSS 문자열과 스크립트 문자열을 모든 HTML 파일의 <head>와 <body> 끝에 바로 넣는다.
그 대신 인라인 코드가 임의로 실행되는 XSS(교차 사이트 스크립팅) 구멍을 막으려고 unsafe-inline을 열지 않고 Node.js의 crypto 모듈로 각 블록의 SHA-256 해시를 계산한다.
const b64 = (s) => crypto.createHash('sha256').update(s).digest('base64');
const csp = (styles, scripts) =>
`default-src 'none'; img-src 'self' data:; font-src 'self'; ` +
`style-src ${styles.map((s) => `'sha256-${b64(s)}'`).join(' ')}; ` +
`script-src ${scripts.map((s) => `'sha256-${b64(s)}'`).join(' ')} https://static.cloudflareinsights.com; ` +
`connect-src 'self' https://cloudflareinsights.com; base-uri 'none'; form-action 'none'; frame-ancestors 'none'`;
블로그 페이지는 홈 기본 스타일(css, 18.0KB)에 블로그 전용 스타일(blogCss, 10.4KB)까지 <style> 태그 두 개를 쓰므로 style-src에 SHA-256 해시 두 개가 나란히 들어간다.
스크립트 쪽도 본문 동작 스크립트(js)와 첫 화면 조직 정보 JSON-LD(jsonLd) 두 개의 해시가 script-src에 들어간다.
Windows CRLF 줄바꿈과 해시 불일치
줄바꿈 이야기는 2026년 11월 15일, 블로그 틀을 만들려고 같은 저장소의 git worktree를 Windows에 새로 풀었을 때 시작됐다.
파일 내용은 그대로인데 grep -c $'\r'로 세어 보니 build.mjs · src/styles.css 같은 원본에 CR 문자가 섞여 있었다. git이 체크아웃하면서 줄 끝을 CRLF(\r\n, 0x0D 0x0A)로 바꿔 놓은 것이다.
이대로 구우면 해시가 틀어진다. 이유는 빌드 도구와 HTML 파서가 같은 글자를 다르게 읽기 때문이다.
- Windows에서 편집하거나 체크아웃한 파일에
\r\n이 섞여 들어가면, 빌드 스크립트의crypto.createHash('sha256').update(s)는\r(0x0D) 바이트까지 그대로 포함해 해시를 계산한다. - 반면 웹 브라우저의 HTML 파서는 WHATWG HTML 명세(Preprocessing the input stream)에 따라 네트워크로 받은 바이트 스트림에서 모든
\r\n과 단독\r을 먼저\n(0x0A, LF)으로 바꾼 뒤 DOM 트리를 만든다. - 브라우저의 CSP 검사기는 그렇게 정규화가 끝난(
<style>·<script>안의\r이 모두 제거된) 문자열을 기준으로 SHA-256 해시를 계산한다.
결국 인라인 블록 안에 CR이 1바이트라도 남으면 빌드 도구가 계산한 해시(\r\n 기준)와 브라우저가 계산한 해시(\n 기준)가 달라져 스타일이나 스크립트가 통째로 막힌다. 화면이 깨진 채 배포되기 전에 찾았으니 운이 좋았던 편이다.
같은 일이 다시 생기지 않게 세 가지를 고정했다.
- 저장소 루트에
.gitattributes파일을 만들고* text=auto eol=lf와 바이너리 확장자(*.png,*.webp,*.jpg,*.ico,*.woff2)를 지정해 Windows에서도 모든 텍스트 파일이LF로만 체크아웃되도록 고정했다(커밋2c3acc0). 그다음 파일을 지우고git checkout-index --all로 다시 풀었다. build.mjs는 스크립트(src/main.js)의 주석 줄을 지우고\n뒤 공백까지 걷어 한 줄로 만든 뒤 해시를 낸다. CSS(src/styles.css·src/blog.css)도minCss()로 줄인 문자열을 해싱한다.test/check.mjs에!h.includes(String.fromCharCode(13))검사를 넣었다(커밋ea26d20, 지금은 29줄). 구운 HTML 파일(dist/*.html) 어디에든CR문자(0x0D, ASCII 13)가 단 1바이트라도 섞여 있으면 빌드가 즉시 실패한다.
Cloudflare 분석 스크립트 주입과 차단
두 번째 문제는 2026년 11월 11일 첫 판(ba41fb7d)을 실제 도메인(kavotin.com)에 올린 직후에 일어났다.
로컬에서 구운 파일을 헤드리스 크롬으로 열었을 때는 390폭과 1440폭 모두 콘솔 오류가 0건이었다.
그런데 Cloudflare Workers에 배포한 뒤 실제 주소(https://kavotin.com/)를 열자 브라우저 콘솔에 CSP 차단 오류가 1건 찍혔고, 로컬 빌드본과 배포본이 일치하는지 확인하는 라이브 검사까지 실패했다.
실제 서버가 내려준 HTML 응답 본문을 뜯어보니, 우리가 구운 </body> 바로 앞에 로컬에는 없던 <script> 태그 하나가 끼워져 있었다.
Cloudflare 대시보드의 Web Analytics(RUM, 실제 사용자 모니터링) 기능이 켜져 있으면, Cloudflare 프록시가 HTML 응답을 내보낼 때 자동으로 https://static.cloudflareinsights.com/beacon.min.js 스크립트 태그를 주입한다. 그리고 이 스크립트가 브라우저에서 돌면서 /cdn-cgi/rum 경로와 https://cloudflareinsights.com으로 방문 통계 비콘(connect-src)을 보낸다.
우리의 초기 CSP 헤더는 default-src 'none'에 우리가 구운 인라인 해시만 열어 두었기 때문에, Cloudflare가 스스로 끼워 넣은 외부 스크립트도 막히고 비콘 전송 요청도 막힌 것이다.
해결 방법은 두 단계였다.
표의 「스크립트」는 script-src, 「비콘 전송」은 connect-src, 「배포본 대조」는 test/check.mjs의 --live 검사다.
처음 검사는 body === html로 문자열을 그대로 비교했다.
| 무엇 | 처음 | 고친 뒤 |
|---|---|---|
| 스크립트 | 해시만 | 해시 + 분석 스크립트 주소 |
| 비콘 전송 | 막힘 | 'self' + 분석 주소 |
| 배포본 대조 | 그대로 비교 | 분석 태그 빼고 비교 |
먼저 build.mjs의 csp() 함수에서 script-src에 https://static.cloudflareinsights.com을 더하고 connect-src 'self' https://cloudflareinsights.com을 열었다. 다시 배포하자 실제 주소의 콘솔 오류가 즉시 0건으로 내려갔다.
그다음 배포 검증 도구인 test/check.mjs의 --live 검사에서는 로컬 dist/index.html과 실서버 응답 본문을 비교할 때 Cloudflare가 끼워 넣은 분석 스크립트 줄만 정규식으로 걷어내고 비교하도록 flat 함수를 작성했다.
const flat = (s) =>
s.replace(/<script[^>]*cloudflareinsights[^>]*><\/script>|<!--[\s\S]*?-->/g, '')
.replace(/\s+/g, ' ');
ok(flat(body) === flat(html), '올라간 첫 화면이 구운 것과 같다(Cloudflare 방문 셈 스크립트는 뺀다)');
빌드 뒤 자동 검사 734개 항목
11월 20일 기준 test/check.mjs는 로컬 빌드 직후 734개 항목을 검사한다. --live https://kavotin.com 옵션을 주면 실서버 응답 검사가 그 뒤에 더 붙는다.
그중 CSP 및 바이트 무결성과 관련된 핵심 검사 항목은 다섯 가지다.
- 구운 모든 HTML 파일에
CR문자(String.fromCharCode(13))가 0개인지 확인한다. - 실서버 첫 화면 응답 헤더의
content-security-policy에default-src 'none'이 포함되어 있는지 확인한다. - 실서버가 내려준 첫 화면과 제품 소개 페이지 4곳(
/about/oncall,/about/cloudline,/about/hongsil,/about/karyon) 등의 HTML이 Cloudflare 분석 스크립트를 제외하고 로컬 빌드본과 글자 하나까지 일치하는지 대조한다. - 첫 화면 전체 무게(HTML + 글꼴 두 벌 + 첫 화면 그림)가 230KB 상한 아래(11월 20일 빌드 219.2KB)인지 확인한다. 인라인 CSS가 커질수록 여기에 먼저 걸린다.
- 헤드리스 크롬으로 실제 주소를 390폭과 1440폭으로 열었을 때
console.error와pageerror가 0건인지 확인한다.
저는 정적 사이트에 CSP를 걸면서 귀찮다는 이유로 unsafe-inline을 열어 두면 CSP를 쓰는 의미가 반감된다고 본다. 빌드 스크립트에서 SHA-256 해시를 자동으로 뽑아 _headers에 적고, Windows의 CRLF 줄바꿈과 호스팅 프록시가 주입하는 스크립트 두 가지만 테스트 코드로 고정해 두면 unsafe-inline 없이도 인라인 최적화와 보안을 둘 다 챙길 수 있다.
글 · Kavotin Studio. 숫자는 직접 잰 것만 기록. 문의