서비스 제공업체나 관리자에게서 Trojan 설정 정보를 받은 뒤, iPhone / iPad의 Shadowrocket에 서버를 직접 추가하려는 사용자를 위한 안내입니다. Address, Port, Password는 전달받은 값 그대로 입력하고, SNI는 서버 측 안내에 따르세요. 평소에는 Allow Insecure를 끄세요. 연결되지 않으면 주소와 포트, TLS 인증서, 비밀번호와 라우팅 순으로 확인하세요.
01 Trojan 연결 방식
Trojan은 먼저 TLS 연결을 설정한 다음, 암호화된 채널을 통해 Password에서 파생된 인증 값과 프록시 요청을 전송합니다. TLS는 데이터를 보호하고 인증서로 서버 신원을 확인합니다. Password는 서버가 클라이언트의 서비스 이용 권한을 확인하는 데 사용됩니다. 비밀번호가 맞아도 인증서 검증 실패를 해결할 수 없으며, 인증서 검증에 성공해도 비밀번호가 맞다는 뜻은 아닙니다.
요약: 인증서 오류가 나면 TLS부터 확인하세요
연결 시 인증서 이름이 일치하지 않는다는 메시지가 표시되면 먼저 서버 설정을 참고해 SNI와 인증서에 포함된 이름을 확인하세요. Password부터 바꾸지 마세요. 인증서 검증 단계에서 연결이 실패했다면 Trojan 인증은 아직 시작되지 않은 것입니다.
02 Add Server에서 Trojan 설정하기
iPhone / iPad의 Home 화면에서 시작하는 방법입니다. 서버 항목을 직접 추가하려면 서버 주소, 포트, Trojan 비밀번호, 서버가 지정한 TLS 호스트 이름을 미리 준비하세요. 구독 주소만 있다면 직접 관리하는 구독을 가져오세요. 구독 주소를 분리해 수동 입력란에 넣지 마세요.
프로토콜 선택
Home 화면 오른쪽 위의 «+»를 눌러 Add Server로 이동한 다음 Type을 열고 Trojan을 선택하세요. 다른 항목을 입력하기 전에 Type을 확인하세요. Password라는 이름의 항목도 프로토콜에 따라 용도가 다를 수 있습니다.
주소와 포트 입력
Address에는 서버에서 받은 도메인이나 IP를 입력하고, Port에는 포트 번호만 따로 입력하세요. 예를 들어 안내된 값이
edge.example.com과8443이라면 각각 해당 항목에 입력합니다. Address에https://, 경로 또는:8443을 붙이지 마세요. 비표준 포트를 임의로443으로 바꾸지 마세요.비밀번호 붙여넣기
Password에는 해당 서버 항목의 Trojan 비밀번호를 입력하세요. 서비스 제공업체 계정 비밀번호나 구독 링크의 토큰이 아닙니다. 붙여넣은 뒤 안내 문구, 따옴표, 줄바꿈이 함께 들어가지 않았는지 확인하세요. 비밀번호의 대소문자와 기호는 그대로 유지해야 합니다.
TLS 확인
Trojan은 TLS를 사용합니다. 입력 화면에 TLS 스위치가 있다면 켜 두세요. 서버에서 SNI를 별도로 제공했다면
tls.example.com처럼 호스트 이름만 원문 그대로 입력하세요. 프로토콜 접두사나 포트는 붙이지 않습니다. SNI를 안내받지 못했다면 임의로 추측하지 마세요. 특히 Address가 IP라면 서버가 요구하는 TLS 호스트 이름을 먼저 확인하세요. Allow Insecure는 끄세요.저장 후 연결 테스트
Done을 눌러 저장한 뒤 Home으로 돌아가 방금 추가한 서버를 선택하고 연결 스위치를 켜세요. 스위치가 켜졌다는 것은 기기에서 터널이 시작됐다는 뜻일 뿐, 특정 요청이 이 Trojan 연결을 통과했다는 의미는 아닙니다. 테스트할 때 Global Routing에서 대상 요청이 선택한 서버를 거치도록 설정되어 있는지도 확인하세요.
위 도메인과 포트는 입력 형식을 보여 주기 위한 예시이며 실제로 사용할 수 있는 서버 정보가 아닙니다. 직접 입력할 때는 같은 서비스 안내에 있는 설정값을 한 세트로 사용하세요. 한 항목의 주소와 다른 항목의 비밀번호를 섞지 마세요.
03 Address, SNI, 인증서 이름의 관계
Address는 클라이언트가 연결할 대상을 지정합니다. 도메인이라면 클라이언트가 먼저 해당 도메인을 조회해야 합니다. SNI는 TLS 핸드셰이크 때 클라이언트가 전송하는 호스트 이름으로, 서버는 이를 바탕으로 인증서를 선택할 수 있습니다. 두 값은 같을 수도, 다를 수도 있습니다. 예를 들어 서비스 안내에 연결 주소로 192.0.2.10을, TLS 호스트 이름으로 tls.example.com을 지정할 수 있습니다. 이 경우 도메인과 IP를 서로 바꿔 입력하면 같은 설정이 아닙니다.
| 서버 측 안내 | 입력 방법 | 확인할 사항 |
|---|---|---|
| 연결 도메인과 TLS 호스트 이름이 같은 경우 | Address에는 edge.example.com을 입력하고, SNI를 명시하라고 안내된 경우 같은 이름을 입력합니다. | 인증서에 해당 호스트 이름이 포함되어 있어야 합니다. 안내에 빈칸으로 두어도 된다고 되어 있다면 다른 도메인을 입력할 필요가 없습니다. |
| 연결 도메인과 TLS 호스트 이름이 다른 경우 | Address에는 edge.example.com을, SNI에는 tls.example.com을 입력합니다. | 각 항목에 안내된 값을 그대로 사용하세요. 둘 다 도메인을 입력할 수 있다고 해서 같은 값으로 바꾸면 안 됩니다. |
| 연결 주소는 IP이고 TLS 호스트 이름은 별도로 받은 경우 | Address에는 192.0.2.10을, SNI에는 tls.example.com을 입력합니다. | IP는 연결에, 도메인은 TLS에 사용합니다. IP를 SNI에 복사하지 마세요. |
이름 일치는 인증서 검증의 한 부분일 뿐입니다. 인증서가 만료됐거나 서버에 필요한 중간 인증서가 없거나 기기의 시스템 시간이 크게 틀리면 검증이 실패할 수 있습니다. 같은 설정으로 이전에는 연결됐다면 먼저 기기의 날짜와 시간을 확인한 뒤 관리자에게 인증서 유효기간과 인증서 체인을 점검해 달라고 요청하세요. 비밀번호를 반복해서 다시 붙여넣을 필요는 없습니다.
04 Allow Insecure 설정 기준
Allow Insecure는 TLS 인증서 검증을 건너뛸지 정하는 옵션이지, TLS를 켜고 끄는 스위치가 아닙니다. 이 옵션을 켜면 TLS 암호화가 계속 적용되더라도 정상적인 인증서 검사를 통해 상대가 의도한 서버인지 확인할 수 없습니다.
Allow Insecure 끄기
권장인증서 검증을 유지합니다. 이름, 유효기간 또는 신뢰 체인 오류가 나타나면 오류 상태를 그대로 두고 설정을 다시 확인하거나 관리자에게 서버 인증서를 수정해 달라고 요청하세요.
권장 상황: 평소 사용 및 TLS 설정 수정 후 검증
Allow Insecure 켜기
인증서 검증을 건너뛰므로 원래 차단되어야 할 연결이 계속될 수 있습니다. 인증서 문제를 고치거나 잘못된 포트 연결, Trojan 비밀번호 오류를 해결해 주는 옵션은 아닙니다.
사용 상황: 관리자가 격리된 환경에서 테스트용 인증 정보로 인증서 검증 결과를 비교할 때만 사용하세요. 평소 연결에는 사용하지 마세요.
05 Trojan 연결 문제 해결
연결을 시도하자마자 시간 초과가 발생합니다. 비밀번호를 다시 입력해야 하나요?
비밀번호부터 바꾸지 마세요. Home에서 해당 서버 항목을 열어 Address에 프로토콜 접두사나 경로가 들어가 있지 않은지, Port가 서버에서 받은 값과 같은지 확인하세요. 같은 설정이 모바일 데이터에서는 작동하지만 현재 Wi-Fi에서 시간 초과가 발생한다면 두 테스트의 네트워크와 시간을 기록하고, 현재 네트워크에서 해당 주소와 포트에 연결할 수 있는지 먼저 확인하세요. 시간 초과만으로 비밀번호가 틀렸다고 판단할 수는 없습니다.
인증서 이름 불일치 오류가 표시됩니다. SNI에는 무엇을 입력해야 하나요?
서버가 지정한 TLS 호스트 이름을 입력하고, 실수로 붙여넣은 접두사, 포트, 경로는 제거하세요. Address가 IP나 접속용 도메인이라고 해서 이를 SNI에 그대로 복사하지 마세요. 안내된 값을 정확히 입력했는데도 오류가 계속되면 관리자에게 해당 주소와 포트에서 반환되는 인증서에 이 호스트 이름이 포함되어 있는지 확인해 달라고 요청하세요.
인증서 오류는 없는데 요청이 끊깁니다. 어디를 확인해야 하나요?
인증서 오류가 없다고 해서 TLS나 Trojan 인증이 완료된 것은 아닙니다. 먼저 Type이 Trojan인지, 포트가 실제 Trojan 서비스용인지 확인한 다음 서버 안내에서 Password가 변경되지 않았는지 확인하세요. 서비스 안내에 별도의 전송 설정이 있다면 다른 항목의 값을 임의로 적용하지 마세요. 원인을 찾기 어렵다면 비밀번호는 보내지 말고 테스트 시간과 오류 증상을 관리자에게 전달해 서버 로그와 대조해 달라고 요청하세요.
Home에서 연결 스위치를 켰는데 대상 웹페이지가 열리지 않는 이유는 무엇인가요?
먼저 Home에서 방금 추가한 항목이 선택되어 있는지 확인한 다음 Global Routing을 살펴보세요. Direct 상태에서는 웹 요청이 이 프록시를 사용하지 않습니다. Config 상태라면 현재 Config에서 대상 주소가 어떤 정책으로 전달되는지 확인하세요. 테스트 중 대상 요청이 선택한 프록시를 거치는 것을 확인했다면 해당 대상에 직접 연결할 수 있는지도 점검하세요. 웹페이지 하나가 열리지 않는다고 비밀번호 오류로 단정하지 마세요.