← 홈으로

SSlh 커뮤니티

전체 게시판

공지사항, 자료실, 기술 게시판의 새 글을 모아봅니다.

홈으로 돌아가기 →

운영 반영 전 단계별 연결 시험

테스트 환경에서 각 서비스의 정상 연결, 잘못된 프로토콜 입력, 백엔드 중단 시 동작, 재시작 후 복구를 확인하세요. 운영 환경에서는 승인된 점검 시간과 롤백 계획을 마련하고, 변경 전후에 같은 시험 항목으로 결과를 비교하세요.

→

장애 로그에서 확인할 단서

문제가 시작된 시각을 기준으로 SSLH와 대상 서비스 로그를 비교하면 연결이 어느 단계에서 실패했는지 파악하는 데 도움이 됩니다. 판별 실패, 대상 연결 거부, 권한 문제 등 메시지를 구분하되 로그의 주소와 계정 정보는 외부 공유 전 가려 주세요.

→

백엔드 서비스가 수신 대기하는지 확인하기

연결 실패 시 SSLH 설정뿐 아니라 대상 서비스가 지정된 주소와 포트에서 실행 중인지 확인하세요. 로컬 전용 바인딩 여부, 주소 계열, 방화벽과 접근 제어도 함께 점검하고, 서버 내부와 외부에서 각각 연결을 시험해 원인을 좁혀 보세요.

→

SSLH와 리버스 프록시의 차이

리버스 프록시는 보통 HTTP 요청과 호스트 정보 등을 해석해 웹 요청을 전달합니다. SSLH는 연결 초기의 프로토콜 신호를 판별해 설정된 대상으로 전달하는 목적이 다릅니다. 웹 라우팅 기능이나 TLS 종료 기능이 자동으로 포함된다고 가정하지 마세요.

→

TCP와 UDP 지원을 혼동하지 않기

서비스가 사용하는 전송 계층을 먼저 확인하세요. TCP 연결을 다루는 설정이 UDP 기반 트래픽이나 음성 미디어까지 자동으로 전달한다는 뜻은 아닙니다. 필요한 전송 방식의 지원 여부와 서비스 전체의 연결 구조를 공식 문서와 함께 검증해야 합니다.

→

프로토콜 판별과 설정 순서

SSLH는 연결 초기에 관찰할 수 있는 신호를 바탕으로 프로토콜을 판별합니다. 판별 가능한 프로토콜과 우선순위는 SSLH 버전 및 설정에 따르므로 실제 사용 중인 버전의 매뉴얼을 확인하고, 지원되지 않는 프로토콜을 가정하지 마세요.

→

수신 포트와 백엔드 포트 구분하기

수신 포트는 원격 클라이언트가 접속하는 지점이고 백엔드 포트는 SSLH가 판별된 연결을 전달하는 대상입니다. 두 포트의 역할과 바인딩 주소를 구분해 기록하고, 같은 주소와 포트를 여러 프로세스가 동시에 점유하지 않는지 확인하세요.

→

하나의 수신 포트를 여러 서비스가 공유할 때

여러 서비스가 같은 공개 포트를 사용하려면 해당 포트의 수신을 SSLH가 맡고, 각 서비스는 별도의 대상 주소와 포트에서 대기하도록 구성하는 방식이 일반적입니다. 실제 주소, 권한, 서비스 순서는 환경에 맞춰 확인해야 합니다.

→

SSLH의 역할과 연결 흐름

SSLH는 하나의 수신 포트로 들어온 연결의 초기 데이터를 살펴 지원하는 프로토콜을 구분하고 설정된 대상 서비스로 연결을 전달하는 프로그램입니다. 전달 가능한 프로토콜과 동작은 빌드 옵션, 버전, 설정에 따라 달라질 수 있습니다.

→

공식 SSLH 문서와 프로젝트 저장소

설치 방법과 설정 옵션은 사용 중인 버전에 맞는 공식 자료를 우선 참고하세요. SSLH 프로젝트 저장소에서 소스 코드, README, 매뉴얼과 공식 이슈를 확인할 수 있습니다: https://github.com/yrutschle/sslh

→

방화벽 변경 전 검토표

변경 대상, 허용할 출발지와 목적지, 프로토콜과 포트, 업무상 근거, 만료 또는 재검토 시점을 기록합니다. 기존 규칙과 충돌하는지 확인하고 승인 및 롤백 절차를 마련하세요. 필요한 범위만 허용하고 적용 후 연결 상태를 확인하세요.

→

업그레이드 준비 체크리스트

현재 버전과 설치 경로, 설정 파일, 패키지 설치 방법을 기록하고 백업을 확인하세요. 목표 버전의 변경 사항과 호환성을 검토하고, 테스트 환경에서 서비스별 연결과 복구 방법을 검증한 다음 운영 반영 시점을 정하세요.

→

로그 공유 전 개인정보 보호

로그에는 사용자 이름, IP 주소, 내부 호스트명, 경로 또는 인증 관련 값이 들어갈 수 있습니다. 공유가 필요한 부분만 추려서 식별 정보를 가리고, 원본 로그는 공개 게시판에 올리지 마세요. 로그 보관 및 파기 정책도 함께 따르세요.

→

장애 보고서 작성 템플릿

요약: 영향받은 서비스: 발생 및 복구 시각: 영향 범위: 관찰한 증상: 최근 변경 사항: 조치 및 결과: 후속 작업: 로그를 첨부하기 전 주소, 계정명, 토큰 등 민감한 값이 없는지 확인하세요.

→

정기 운영 점검 체크리스트

SSLH 프로세스 상태와 로그를 확인하고, 연결 대상 서비스가 응답하는지 점검합니다. 인증서나 계정 정보의 유효성, 방화벽 정책의 변경 여부, 디스크 및 시스템 자원, 최근 설정 변경 기록도 운영 환경의 절차에 따라 확인하세요.

→

설정 백업 및 변경 기록 양식

변경 일시와 담당자, 변경 목적, 대상 파일, 변경 전후의 차이, 검증 결과, 롤백 방법을 기록하세요. 백업 파일과 설정에는 비밀 정보가 있을 수 있으니 접근 권한을 제한하고 공개 게시판이나 저장소에 올리지 마세요.

→

서비스와 포트 매핑표 작성 예시

서비스 이름, 프로토콜, 외부 수신 주소와 포트, 내부 대상 주소와 포트, 담당자를 표로 정리해 두세요. 실제 운영값은 환경마다 다르므로 이 자료에는 특정 포트 번호를 기본값으로 가정하지 않습니다. 변경 시 표와 서버 설정을 함께 갱신하세요.

→

장애 문의용 환경 정보 양식

운영체제 및 버전: SSLH 버전과 설치 방법: 관련 서비스와 포트: 문제가 시작된 시각: 최근 변경 사항: 기대한 결과와 실제 결과: 재현 절차 및 민감정보를 제거한 로그: 비밀번호, 키, 토큰은 절대 기록하지 마세요.

→

설치 전 확인 체크리스트

운영체제와 SSLH 버전을 기록합니다. 사용할 수신 포트와 연결할 백엔드 서비스, 기존 포트 점유 여부를 확인합니다. 방화벽 및 네트워크 정책의 변경 권한과 복구 계획을 준비한 뒤 테스트 환경에서 먼저 검증합니다.

→

SSLH 프로젝트 문의는 공식 채널을 이용하세요

이 사이트는 독립적인 한국어 안내 페이지이며 SSLH 프로젝트의 공식 지원 채널이 아닙니다. 프로그램의 버그나 기능 제안은 공식 프로젝트 저장소의 이슈와 문서를 확인해 주세요: https://github.com/yrutschle/sslh

→

게시판 이용 및 기술 문의 안내

공지사항은 사이트 운영 안내, 자료실은 참고용 체크리스트와 문서, 기술 게시판은 구성 및 문제 해결 정보를 다룹니다. 질문을 작성할 때는 사용 환경과 재현 절차를 구체적으로 적고 민감정보는 포함하지 마세요.

→

점검 후에는 실제 연결을 확인하세요

설정 변경이 끝나면 대상 서비스별로 연결이 정상인지 확인하고, SSLH와 백엔드 서비스 로그를 함께 살펴보세요. 한 가지 연결만 확인하지 말고 영향을 받는 서비스와 복구 절차도 점검해 주세요.

→

사용 중인 버전에 맞는 문서를 확인하세요

설정 항목과 지원 프로토콜은 SSLH 버전이나 배포판 패키지에 따라 다를 수 있습니다. 블로그나 오래된 예시를 그대로 적용하기보다 설치된 버전의 매뉴얼과 배포판 안내를 우선 확인해 주세요.

→

네트워크 정책 변경은 운영 담당자와 확인하세요

수신 포트나 방화벽 정책을 변경하면 기존 서비스와 보안 경계에 영향이 생길 수 있습니다. 변경 범위와 승인 절차를 확인하고, 필요한 포트만 허용한 뒤 적용 결과를 점검해 주세요.

→

연결 문제가 생기면 환경 정보를 함께 확인하세요

문제가 발생한 시각, 운영체제, SSLH 버전, 변경한 설정, 기대한 동작과 실제 결과를 정리하면 원인을 파악하는 데 도움이 됩니다. 재현 절차와 관련 로그를 공유할 때는 민감정보를 반드시 제거해 주세요.

→

게시판에 비밀 정보를 올리지 마세요

질문이나 장애 사례를 공유할 때 비밀번호, 개인 키, 토큰, 내부 주소, 사용자 개인정보가 포함되지 않았는지 먼저 확인해 주세요. 로그나 설정 예시를 올릴 때는 식별 가능한 정보를 삭제하거나 안전한 예시 값으로 바꿔 주세요.

→

설정 변경 전 기존 파일을 백업하세요

SSLH나 네트워크 설정을 수정하기 전에 현재 설정 파일을 안전한 위치에 백업하고 변경 이유와 시각을 기록해 두세요. 문제가 생겼을 때 원래 상태로 되돌릴 수 있도록 복구 방법도 함께 확인해 주세요.

→

SSLH 설치 전 확인할 사항

설치 전에 운영체제와 패키지 버전, 현재 사용 중인 서비스 포트, 방화벽 정책을 확인해 주세요. 기존 서비스에 영향을 줄 수 있으므로 운영 서버에 적용하기 전 테스트 환경에서 동작을 점검하는 것을 권장합니다.

→

이 안내 사이트와 SSLH 프로젝트의 범위

이 사이트는 SSLH 프로그램을 한국어로 소개하는 안내 사이트입니다. SSLH 데몬을 설치하거나 서버 설정을 대신 변경하지 않습니다. 실제 운영 설정은 사용 중인 운영체제와 SSLH 버전에 맞춰 공식 문서를 확인해 주세요.

→

sslh 패키지 설치하기

sudo apt update && sudo apt install -y sslh sslh -v

→