본문 바로가기
Q&A해결2026년 4월 30일1분 읽기

Cloudflare Tunnel로 로컬 개발 노출 시 WebSocket이 자주 끊깁니다

원
원격작업러
조회 861댓글 2

로컬 개발 서버를 Cloudflare Tunnel로 외부에 노출해서 다른 팀원이 보게 하고 있습니다. HTTP는 잘 되는데, Vite HMR이나 Next.js dev의 WebSocket 연결이 30초~1분마다 끊깁니다.

cloudflared config:

tunnel: my-tunnel
ingress:
  - hostname: dev.example.com
    service: http://localhost:3000
  - service: http_status:404

댓글 2

김김영삼6개월 전

Cloudflare는 기본적으로 idle WebSocket을 100초 후 끊습니다. dev 서버용으로는 timeout 늘리고 ping/pong 활성화하면 안정됩니다.


1) cloudflared config 보강


tunnel: my-tunnel
ingress:
- hostname: dev.example.com
service: http://localhost:3000
originRequest:
connectTimeout: 30s
tlsTimeout: 10s
tcpKeepAlive: 30s
keepAliveTimeout: 90s
noTLSVerify: true # 로컬 dev이므로 OK
proxyType: ""
noHappyEyeballs: true # IPv6 우회
- service: http_status:404

2) Cloudflare 대시보드 설정



  • Network → WebSockets: On

  • Caching → Configuration → Browser Cache TTL: Respect Existing Headers

  • Speed → Optimization → Rocket Loader: Off (개발용)


3) Vite HMR 설정 (가장 중요)


// vite.config.ts
export default defineConfig({
server: {
hmr: {
protocol: 'wss', // ← Cloudflare는 wss로 종단
host: 'dev.example.com', // 외부 호스트명
clientPort: 443, // 항상 443
},
allowedHosts: ['dev.example.com'],
},
})

HMR 클라이언트가 ws://localhost:5173으로 연결하려고 하면 Cloudflare 너머에서는 실패합니다. wss + 외부 호스트 + 443으로 명시해야 동작.


4) Next.js의 경우


// next.config.js
module.exports = {
experimental: {
allowedDevOrigins: ['dev.example.com'],
},
}

5) Cloudflare ZeroTrust 권장


인증 추가하면 dev 서버가 외부에 그대로 노출되는 것보다 안전합니다. Tunnel + Access 조합으로 팀원만 접근 가능하게.

원원격작업러(guest)6개월 전
3번 Vite HMR 설정이 핵심이었네요. clientPort: 443이 빠져 있어서 WS가 잘못된 포트로 연결 시도하고 있었습니다. 안정적으로 유지됩니다. 감사합니다!
Ctrl+Enter로 등록