Segment Route
자주 묻는 질문

프록시 설정을 위한 CNAME 및 고가용성 FAQ

05

라우팅 및 DNS 기본 지식

CNAME 레코드란 무엇인가요?

CNAME 레코드는 한 이름이 다른 이름의 별명이 되도록 연결하는 DNS 레코드입니다. 별명인 이름은 같은 이름에 다른 레코드를 가질 수 없으므로, 일반적으로 루트 도메인(bare domain)에는 사용하지 않습니다. 간단한 규칙입니다. DDNS와 프록시가 충돌할 때 보통 오래된 주소를 가리키는 레코드가 원인입니다. 프록시가 제공하는 주소와 레코드를 비교해 보세요.

프록시에서 고가용성(High Availability)이란 무엇을 의미하나요?

고가용성은 단일 장애 지점(SPOF)을 피하는 것을 의미합니다. 실제 구현에서는 프록시 뒤에 두 개 이상의 백엔드를 두고, 실패한 백엔드로 요청 전송을 중단하는 건강 상태 확인(health checks), 그리고 프록시 자체를 위한 두 번째 프록시 또는 장애 조치(failover) 계획을 마련하는 것입니다. 이는 위험을 줄여줍니다. 하지만 고장 나지 않을 것을 보장하지 않으며, Segment Route도 가동 시간 수치를 약속하지 않으므로, 장애 조치 계획을 직접 테스트해 보세요.

502, 503, 504 상태 코드는 무엇을 의미하나요?

502 Bad Gateway는 프록시가 백엔드에서 유효하지 않은 응답을 받았음을 의미하고, 503은 서비스가 사용 불가능함을, 504 Gateway Timeout은 백엔드가 응답을 너무 늦게 보내었음을 의미합니다. SSL 인증서가 만료되었을 때 프록시가 백엔드와의 보안 연결을 완료하지 못하면 Bad Gateway 오류가 발생할 수 있습니다. 먼저 인증서 날짜를 확인하세요. 그런 다음 주소를 다시 요청하고 상태 코드를 비교해 보세요.

301과 302 리디렉션의 차이는 무엇인가요?

301은 URL이 영구적으로 이동했음을 의미하고, 302는 임시로 이동했음을 의미합니다. 307과 308은 요청 메서드를 유지하는 임시 및 영구 리디렉션 코드입니다. 인증서 경고가 없는 도메인 포워더는 포워딩 대상 이름을 모두 포함하는 인증서가 필요합니다. 그렇지 않으면 브라우저가 리디렉션 전에 경고창을 표시합니다. 임시 이동에는 임시 코드를 사용하고, 영구 이동에는 사용하지 마세요.

리디렉션 루프가 발생하는 이유는 무엇인가요?

리디렉션 루프는 두 계층이 동일한 요청을 리디렉션할 때 발생하며, 가장 흔한 경우 프록시와 애플리케이션이 모두 HTTP 트래픽을 HTTPS로 리디렉션할 때 발생합니다. 브라우저는 두 지점 사이를 오가다가 결국 연결을 끊습니다. 두 곳의 리디렉션 규칙을 확인하고, 중복된 규칙 중 하나를 제거한 후 주소를 다시 요청하여 단일 홉(single hop)으로 정상 작동하는지 확인하세요.

Segment Route 사용법

에이전트가 명령을 직접 실행하나요?

네. 에이전트는 도구를 직접 실행하며, 모든 작업은 실제 결과가 포함된 채팅 카드 형태로 표시됩니다. 확장된 카드는 전체 출력(명령 결과 또는 파일 diff)을 보여줍니다. 카드를 읽고, Ask first 모드에서는 변경이 적용되기 전에 각 변경 사항을 수락하거나 거부합니다. Plan only 모드에서는 아무것도 실행하지 않습니다.

에이전트는 라우트 파일을 어떻게 변경하나요?

edit_file 도구는 파일을 변경하기 전에 먼저 diff를 보여줍니다. 마이크로서비스 아키텍처의 API 게이트웨이인 경우 각 서비스에 고유한 라우트 라인이 할당되며, 하나의 diff로 모든 변경 사항을 확인할 수 있습니다. Ask first 모드에서는 에이전트가 변경 전에 일시정지하며 수락 또는 거부를 요청하고, Shell은 구성 테스트 명령을 실행하므로 리로드 전에 실제 종료 코드를 확인할 수 있습니다.

운영 중인 프록시에 적합한 승인 모드는 무엇인가요?

3가지 승인 모드가 있습니다. Plan only는 계획만 작성하고 아무것도 실행하지 않으며, Ask first는 변경을 일으키는 작업 전에 일시정지하고, Auto-run은 즉시 실행합니다. 운영 중인 프록시의 경우 Ask first가 일반적인 선택입니다. diff를 수락하거나 거부할 수 있고, Shell은 리로드 전에 구성 테스트를 실행하기 때문입니다. Auto-run은 복원이 가능한 파일에서만 사용하세요.

에이전트의 결과가 항상 정확한가요?

아닙니다. 모든 결과와 diff를 직접 확인하세요. 에이전트는 구성 테스트 명령을 실행하지만, 테스트 통과가 구문만 유효하다는 것을 의미할 뿐입니다. 주소를 요청하고 상태 코드와 Location 헤더를 읽은 후, 변경 전에 기록한 값과 비교하세요. 백업을 유지하여 롤백할 수 있게 하고, 각 변경 제안은 초안으로 취급하세요.

coderouting.com이 Segment Route의 공식 웹사이트인가요?

네, coderouting.com은 Segment Route의 공식 웹사이트이며, 다운로드 버튼은 약 34 MB 크기의 원래 설치 프로그램을 제공합니다. 먼저 체크섬을 비교하세요. 파일을 실행하기 전에 SHA-256 값을 게시된 매니페스트와 비교하고, 문제를 보고하거나 빌드에 대해 문의하려면 앱 내부의 Send feedback 버튼을 사용하세요.

모델, 개인정보 및 다운로드

내 파일이 PC 외부로 나가나요?

네, 클라우드 모델을 사용할 경우: 프롬프트와 에이전트가 읽는 파일의 텍스트가 해당 제공업체로 전송됩니다. 아니요, PC에서 로컬로 실행되는 모델을 사용할 경우: 아무것도 외부로 나가지 않습니다. 채팅, 작업 폴더 및 API 키는 PC에 남아 있으며, 도구 출력에 포함된 비밀 정보는 모델에 전달되기 전에 가려집니다. 이를 고려하여 모델을 선택하세요.

앱이 텔레메트리를 전송하나요?

아니요. Segment Route는 텔레메트리를 수집하지 않고 로컬에서 실행됩니다. 프롬프트는 선택한 모델 엔드포인트로만 전송됩니다. 몇 가지 선택적 기능은 네트워크를 사용합니다: 웹 검색, 스마트폰 브라우저에서 채팅 제어(원격 아웃바운드 연결을 사용하며 끌 수 있음), 업데이트 확인. Privacy 페이지에 모든 항목이 한 곳에 나열되어 있습니다.

다운로드 버튼은 어떤 파일을 제공하나요?

제공되는 파일의 크기는 34 MB입니다: Windows 10 및 11용 설치 프로그램입니다. 약 25 MB 크기의 포터블 단일 .exe 파일도 존재하지만, 이 웹사이트의 버튼은 설치 프로그램을 제공합니다. 설치 프로그램은 자동 업데이트를 지원하는 빌드이며, 새 버전이 준비되면 Update 버튼을 표시합니다.

다운로드한 설치 파일을 어떻게 확인하나요?

두 값이 일치해야 합니다: 파일의 SHA-256 체크섬과 게시된 매니페스트의 값입니다. Windows 명령어 certutil -hashfile을 다운로드한 파일 경로와 끝에 SHA256을 붙여 실행하세요. SmartScreen이 경고할 수 있습니다. 설치 프로그램이 아직 코드 서명되지 않았기 때문입니다. 값이 일치한 후에만 More info를 선택하고 Run anyway를 클릭하세요.

Windows용 Segment Route

에이전트를 설치하고 첫 번째 규칙을 테스트하세요

Segment Route 다운로드 ↗