오리진 매개변수(Origin parameters)
오리진 매개변수는 cloudflared가 게시된 애플리케이션의 오리진 서버로 요청을 보내는 방식을 결정해요.
출처: 문서
본문
오리진 매개변수 업데이트하기
이 섹션은 원격 관리 터널의 오리진 매개변수 업데이트 방법을 설명해요. 로컬 관리 터널을 사용한다면 이 매개변수들을 구성 파일에 추가해요.
- Cloudflare 대시보드에서 Networking > Tunnels로 이동하고 터널을 선택해요. Tunnels로 이동 ↗
- Routes 탭으로 이동해요.
- 구성하려는 게시된 애플리케이션의 작업 메뉴에서 Edit route를 선택하거나, 새로 만들려면 Add route를 선택해요.
- Additional application settings를 펼치고 HTTP, TLS 또는 Connection 범주 아래에서 오리진 매개변수를 수정해요.
- Save changes를 선택해요.
TLS 설정(TLS settings)
originServerName
| Default | UI name |
|---|---|
"" |
Origin Server Name |
cloudflared가 오리진 서버 인증서에서 기대해야 하는 호스트 이름. 비어 있으면 cloudflared는 서비스 URL의 호스트 이름을 사용해요. 예를 들어 서비스가 https://localhost:443이면 localhost를 사용해요.
matchSNItoHost
| Default | UI name |
|---|---|
false |
Match SNI to host |
true이면 cloudflared는 TLS 핸드셰이크 중 Server Name Indication(SNI)을 오리진으로 보내진 요청 Host 값으로 설정해요. HTTP Host Header를 구성했다면 cloudflared는 그 값을 SNI에 사용해요. 이 설정은 각 요청에 대해 Origin Server Name을 덮어써요.
이 설정은 여러 서비스를 호스팅하고 SNI에 의존해 요청을 라우팅하거나 올바른 인증서를 제시하는 진입점으로 트래픽을 보낼 때 유용해요. 와일드카드 라우팅을 사용할 때 개별 서비스에 originServerName을 명시적으로 구성할 필요를 없애줘요.
caPool
| Default | UI name |
|---|---|
"" |
CA Pool |
오리진 서버 인증서용 인증 기관(CA)의 로컬 파일 경로(예: /root/certs/ca.pem). 경로는 하나 이상의 신뢰할 수 있는 루트 CA 인증서가 들어 있는 .pem 또는 .crt 형식의 인증서 저장소 파일이나 번들 파일을 가리켜야 해요. cloudflared는 이 인증서들을 기본 신뢰 풀에 추가해요. 프라이빗 CA가 인증서에 서명했고 그 CA가 기본 신뢰 풀에 없을 때 이 설정을 구성해요.
noTLSVerify
| Default | UI name |
|---|---|
false |
Disable TLS certificate verification |
false이면 오리진이 제시한 인증서에 대해 TLS 검증이 수행돼요.
true이면 TLS 검증이 비활성화돼요. 이렇게 하면 오리진의 어떤 인증서도 허용돼요.
tlsTimeout
| Default | UI name |
|---|---|
10s |
TLS Timeout |
Tunnel을 HTTPS 서버에 연결하도록 선택했다면, 오리진 서버로의 TLS 핸드셰이크를 완료하는 타임아웃.
http2Origin
| Default | UI name |
|---|---|
false |
Use HTTP/2 to origin |
false이면 cloudflared는 HTTP/1.1로 오리진에 연결해요.
true이면 cloudflared는 HTTP/1.1 대신 HTTP/2를 사용해 오리진 서버에 연결을 시도해요. 오리진으로의 HTTP/2는 HTTPS가 필요해요. 프라이빗 CA가 서명한 인증서의 경우 CA Pool을 구성하고 TLS 검증을 켠 채 유지해요.
HTTP 설정(HTTP settings)
httpHostHeader
| Default | UI name |
|---|---|
"" |
HTTP Host Header |
로컬 서비스로 보내진 요청에 HTTP Host 헤더를 설정해요.
disableChunkedEncoding
| Default | UI name |
|---|---|
false |
Disable Chunked Encoding |
false이면 cloudflared는 HTTP/1.1을 통해 데이터를 전송할 때 청크 전송 인코딩을 수행해요.
true이면 청크 전송 인코딩이 비활성화돼요. Web Server Gateway Interface(WSGI) 서버를 실행 중일 때 유용해요.
연결 설정(Connection settings)
connectTimeout
| Default | UI name |
|---|---|
30s |
Connect Timeout |
오리진 서버로의 새 TCP 연결을 설정하는 타임아웃. TLS 설정에 걸리는 시간은 제외하며, 이는 tlsTimeout이 제어해요.
noHappyEyeballs
| Default | UI name |
|---|---|
false |
No Happy Eyeballs |
false이면 로컬 네트워크가 두 프로토콜 중 하나를 잘못 구성한 경우 cloudflared는 IPv4/IPv6 폴백에 Happy Eyeballs 알고리즘을 사용해요.
true이면 Happy Eyeballs가 비활성화돼요.
proxyType
| Default | UI name |
|---|---|
"" |
Proxy Type |
cloudflared는 예를 들어 SSH 또는 RDP를 프록시할 때 HTTP 트래픽을 TCP로 변환하는 프록시 서버를 시작해요. 이것은 시작될 프록시 유형을 구성해요. 유효한 옵션은:
""일반 프록시"socks"SOCKS5 프록시. 자세한 내용은 kubectl로 Cloudflare Access를 통해 연결하는 튜토리얼을 참고해요.
proxyAddress
참고
로컬 관리 터널 전용.
| Default | UI name |
|---|---|
127.0.0.1 |
-- |
cloudflared는 예를 들어 SSH 또는 RDP를 프록시할 때 HTTP 트래픽을 TCP로 변환하는 프록시 서버를 시작해요. 이것은 그 프록시의 수신 주소를 구성해요.
proxyPort
참고
로컬 관리 터널 전용.
| Default | UI name |
|---|---|
0 |
-- |
cloudflared는 예를 들어 SSH 또는 RDP를 프록시할 때 HTTP 트래픽을 TCP로 변환하는 프록시 서버를 시작해요. 이것은 그 프록시의 수신 포트를 구성해요. 0으로 설정하면 사용되지 않는 포트가 무작위로 선택돼요.
keepAliveTimeout
| Default | UI name |
|---|---|
1m30s |
Idle Connection Expiration Time |
유휴 keepalive 연결이 버려질 수 있는 타임아웃.
keepAliveConnections
| Default | UI name |
|---|---|
100 |
Keep Alive Connections |
기본: 100
cloudflared와 오리진 사이의 유휴 keepalive 연결의 최대 수. 이는 총 동시 연결 수를 제한하지 않아요.
tcpKeepAlive
| Default | UI name |
|---|---|
30s |
TCP Keep Alive Interval |
기본: 30s
cloudflared가 오리진 서버에 TCP keepalive 패킷을 보내는 타임아웃.
Access 설정(Access settings)
access
| Default | UI name |
|---|---|
"" |
Protect with Access |
트래픽을 오리진으로 프록시하기 전에 cloudflared가 Cloudflare Access JWT를 검증하도록 요구해요. Access 애플리케이션으로 보호되는 공개 호스트 이름 서비스에서 이 검사를 시행할 수 있어요. 이 호스트 이름에 대한 모든 L7 요청에 대해 Access는 JWT를 Cf-Access-Jwt-Assertion 요청 헤더로 cloudflared에 전송해요.
구성 파일에서 이 보안 제어를 활성화하려면 Access 애플리케이션의 AUD 태그를 가져와 originRequest에 다음 규칙을 추가해요:
access:
required: true
teamName: <your-team-name>
audTag:
- <Access-application-audience-tag>
- <Optional-additional-tags>
더 알아보기 (Learn more)
오리진 매개변수는 cloudflared가 로컬 오리진에 연결하는 방식을 제어해요. TLS·HTTP·연결·Access 네 가지 범주로 나뉘며, 원격 관리 터널은 대시보드에서, 로컬 관리 터널은 구성 파일에서 설정해요.