TsgcHTTPServer › 속성

TsgcHTTPServer 속성

용도별로 그룹화된 published 속성과 그에 이어지는 전체 알파벳순 목록.

연결

Name설명
Active구성된 바인딩에서 리스닝 소켓을 열어, HTTP 서버를 시작하거나 중지합니다.
Port서버가 들어오는 HTTP 연결을 수락하는 TCP 포트입니다.
Bindings서버가 수신 대기하는 IP/Port 쌍의 컬렉션. 여러 엔드포인트를 동시에 바인딩하는 데 사용하십시오.
MaxConnections서버가 수락하는 최대 동시 클라이언트 연결 수입니다.
KeepAlive응답이 전송된 후 HTTP 연결을 열어 두어 후속 요청이 이를 재사용할 수 있게 합니다.

HTTP

Name설명
CharsetDocumentRoot에서 제공되는 텍스트 응답에 적용되는 문자 집합입니다.
DocumentRoot정적 파일(HTML, JavaScript, CSS, 이미지 등)을 위해 HTTP 서버가 제공하는 디렉터리입니다.
HTTP2OptionsHTTPS 요청을 제공하는 데 사용되는 HTTP/2 프로토콜 핸들러를 활성화하고 조정합니다.
HTTP3OptionsHTTP/1.1 및 HTTP/2와 함께 UDP를 통해 HTTP 요청을 처리하는 HTTP/3(QUIC) 리스너를 활성화합니다.
HTTPCompression클라이언트가 지원을 알릴 때 HTTP/1.1 응답을 gzip 또는 deflate로 압축합니다.
HTTPUploadFilesHTTP POST를 통해 업로드된 파일이 어떻게 버퍼링되고(메모리 또는 파일 스트림) 디스크에 저장되는지 제어합니다.
ParseParams모든 요청의 쿼리 문자열과 form-urlencoded 본문을 ARequestInfo.Params로 파싱합니다.

세션

Name설명
AutoStartSession세션 상태가 활성화된 경우 들어오는 모든 요청에 대해 자동으로 새 HTTP 세션을 생성합니다.
SessionClass서버가 새 HTTP 세션을 생성하는 데 사용하는 클래스입니다. 사용자 지정 TIdHTTPSession 하위 클래스로 설정하십시오.
SessionList활성 HTTP 세션을 보유하는 목록입니다. 코드에서 세션을 관리하려면 이 값을 읽거나, 사용자 지정 목록을 할당하십시오.
SessionState상태 비저장 HTTP 프로토콜 위에서 쿠키 기반 HTTP 세션 추적을 활성화합니다.
SessionTimeOutHTTP 세션이 만료된 것으로 간주되어 제거 대상이 되는 유휴 타임아웃(밀리초)입니다.

보안

Name설명
Authentication들어오는 HTTP 연결에 대한 사용자/비밀번호 인증을 활성화하고 구성합니다.
SSL클라이언트가 https://를 사용하여 연결할 수 있도록 서버에서 TLS/SSL을 활성화합니다.
SSLOptionsTLS 리스너에 대한 인증서 경로, TLS 버전 선택, OpenSSL 튜닝을 보유합니다.
SecurityOptions공유 서버 엔진으로부터 상속된 핸드셰이크 허용 규칙입니다. 이 구성 요소에는 적용되지 않습니다(설명 참조).
MaxRequestBodySize인바운드 HTTP 요청 본문의 최대 크기(바이트)이며, 메모리 고갈 공격으로부터 서버를 보호합니다.
StrictRequestParsing요청 스머글링 공격에 사용되는 모호한 HTTP 요청을 거부하고 더 엄격한 청크 인코딩 검증을 적용합니다.
APIKeyManager연결을 수락하기 전에 들어오는 API 키를 검증하는 데 사용되는 선택적 API 키 관리자 구성 요소입니다.

안정성

Name설명
WatchDog예기치 않은 종료 또는 리스너 실패 후 서버를 자동으로 다시 시작합니다.
FallBack공유 서버 엔진으로부터 상속된 속성이며, 이 구성 요소에는 적용되지 않습니다(설명 참조).
RateLimiter클라이언트별 또는 IP별로 요청 속도를 제한하는 rate-limiter 구성 요소를 할당합니다.
Firewall들어오는 연결을 IP, 지역 또는 사용자 지정 규칙으로 필터링하는 방화벽 구성 요소를 할당합니다.

고급

Name설명
Options기타 서버 동작 플래그를 묶습니다: 시간 초과, 내장 테스트 페이지, HTTP Server 헤더입니다.
IOHandlerOptions연결을 처리하는 데 사용되는 I/O 전략을 선택합니다: 연결당 스레드, IOCP 또는 EPOLL.
ThreadPool연결이 닫힐 때 작업자 스레드를 파괴하는 대신 재활용하는 스레드 풀을 활성화합니다.
ThreadPoolOptionsThreadPool이 활성화된 경우 사용되는 재사용 가능한 스레드 풀의 크기와 상한을 구성합니다.
Throttle서버가 각 연결에서 읽거나 쓰는 대역폭(초당 비트)을 제한합니다.

진단

Name설명
LogFile디버깅 및 감사를 위해 들어오고 나가는 모든 HTTP 요청/응답을 로그 파일에 기록합니다.
NotifyEvents스레드화된 서버 이벤트가 메인 VCL 스레드와 어떻게 동기화되는지 제어합니다.
Version바이너리에 임베드된 sgcWebSockets 라이브러리 버전이 있는 읽기 전용 문자열입니다.

모든 속성(알파벳순)

Name설명
Active구성된 바인딩에서 리스닝 소켓을 열어, HTTP 서버를 시작하거나 중지합니다.
APIKeyManager연결을 수락하기 전에 들어오는 API 키를 검증하는 데 사용되는 선택적 API 키 관리자 구성 요소입니다.
Authentication들어오는 HTTP 연결에 대한 사용자/비밀번호 인증을 활성화하고 구성합니다.
AutoStartSession세션 상태가 활성화된 경우 들어오는 모든 요청에 대해 자동으로 새 HTTP 세션을 생성합니다.
Bindings서버가 수신 대기하는 IP/Port 쌍의 컬렉션. 여러 엔드포인트를 동시에 바인딩하는 데 사용하십시오.
CharsetDocumentRoot에서 제공되는 텍스트 응답에 적용되는 문자 집합입니다.
DocumentRoot정적 파일(HTML, JavaScript, CSS, 이미지 등)을 위해 HTTP 서버가 제공하는 디렉터리입니다.
FallBack공유 서버 엔진으로부터 상속된 속성이며, 이 구성 요소에는 적용되지 않습니다(설명 참조).
Firewall들어오는 연결을 IP, 지역 또는 사용자 지정 규칙으로 필터링하는 방화벽 구성 요소를 할당합니다.
HTTP2OptionsHTTPS 요청을 제공하는 데 사용되는 HTTP/2 프로토콜 핸들러를 활성화하고 조정합니다.
HTTP3OptionsHTTP/1.1 및 HTTP/2와 함께 UDP를 통해 HTTP 요청을 처리하는 HTTP/3(QUIC) 리스너를 활성화합니다.
HTTPCompression클라이언트가 지원을 알릴 때 HTTP/1.1 응답을 gzip 또는 deflate로 압축합니다.
HTTPUploadFilesHTTP POST를 통해 업로드된 파일이 어떻게 버퍼링되고(메모리 또는 파일 스트림) 디스크에 저장되는지 제어합니다.
IOHandlerOptions연결을 처리하는 데 사용되는 I/O 전략을 선택합니다: 연결당 스레드, IOCP 또는 EPOLL.
KeepAlive응답이 전송된 후 HTTP 연결을 열어 두어 후속 요청이 이를 재사용할 수 있게 합니다.
LogFile디버깅 및 감사를 위해 들어오고 나가는 모든 HTTP 요청/응답을 로그 파일에 기록합니다.
MaxConnections서버가 수락하는 최대 동시 클라이언트 연결 수입니다.
MaxRequestBodySize인바운드 HTTP 요청 본문의 최대 크기(바이트)이며, 메모리 고갈 공격으로부터 서버를 보호합니다.
NotifyEvents스레드화된 서버 이벤트가 메인 VCL 스레드와 어떻게 동기화되는지 제어합니다.
Options기타 서버 동작 플래그를 묶습니다: 시간 초과, 내장 테스트 페이지, HTTP Server 헤더입니다.
ParseParams모든 요청의 쿼리 문자열과 form-urlencoded 본문을 ARequestInfo.Params로 파싱합니다.
Port서버가 들어오는 HTTP 연결을 수락하는 TCP 포트입니다.
RateLimiter클라이언트별 또는 IP별로 요청 속도를 제한하는 rate-limiter 구성 요소를 할당합니다.
SecurityOptions공유 서버 엔진으로부터 상속된 핸드셰이크 허용 규칙입니다. 이 구성 요소에는 적용되지 않습니다(설명 참조).
SessionClass서버가 새 HTTP 세션을 생성하는 데 사용하는 클래스입니다. 사용자 지정 TIdHTTPSession 하위 클래스로 설정하십시오.
SessionList활성 HTTP 세션을 보유하는 목록입니다. 코드에서 세션을 관리하려면 이 값을 읽거나, 사용자 지정 목록을 할당하십시오.
SessionState상태 비저장 HTTP 프로토콜 위에서 쿠키 기반 HTTP 세션 추적을 활성화합니다.
SessionTimeOutHTTP 세션이 만료된 것으로 간주되어 제거 대상이 되는 유휴 타임아웃(밀리초)입니다.
SSL클라이언트가 https://를 사용하여 연결할 수 있도록 서버에서 TLS/SSL을 활성화합니다.
SSLOptionsTLS 리스너에 대한 인증서 경로, TLS 버전 선택, OpenSSL 튜닝을 보유합니다.
StrictRequestParsing요청 스머글링 공격에 사용되는 모호한 HTTP 요청을 거부하고 더 엄격한 청크 인코딩 검증을 적용합니다.
ThreadPool연결이 닫힐 때 작업자 스레드를 파괴하는 대신 재활용하는 스레드 풀을 활성화합니다.
ThreadPoolOptionsThreadPool이 활성화된 경우 사용되는 재사용 가능한 스레드 풀의 크기와 상한을 구성합니다.
Throttle서버가 각 연결에서 읽거나 쓰는 대역폭(초당 비트)을 제한합니다.
Version바이너리에 임베드된 sgcWebSockets 라이브러리 버전이 있는 읽기 전용 문자열입니다.
WatchDog예기치 않은 종료 또는 리스너 실패 후 서버를 자동으로 다시 시작합니다.