연결 문제 해결

Mihomo 암호화 구독: no identities found

Mihomo의 암호화된 proxy-provider 갱신에서 no identities found가 나오나요? 실제 코어의 개인 키, provider별 키, v1.19.34 수정과 임시 대처를 확인하고 갱신 및 복구를 검증하세요.

  • Mihomo
  • age
  • proxy-providers
  • 구독 복호화
  • v1.19.34
이 글의 목차

같은 개인 키로 전체 설정은 복호화되는데, 전역 시작 인수에 키를 넣은 뒤에도 암호화된 노드 provider는 갱신에 실패할 수 있습니다. 첫 번째 오류와 원래 정상 작동하던 설정을 보관하고, 키를 새로 만들거나 구독 캐시를 삭제하는 일은 보류하세요.

암호화된 provider에서 실패한 것인지 먼저 확인

이 글은 age ASCII armor를 사용하는 Mihomo proxy-provider를 다룹니다. 실제 코어에 일치하는 전역 개인 키가 있지만 항목의 age-secret-key가 없거나 비어 있을 때 decrypt config error: no identities found가 발생하는 경우입니다. 오류 문구만으로 이 결함이라고 판단할 수는 없습니다.

공식 #3449에는 전역 개인 키와 provider 개인 키를 비교한 내용이 있으며, 보고자는 Alpha 478af2a를 사용했습니다. v1.19.33의 고정 버전 코드에서도 빈 키를 먼저 파싱하는 경로를 확인할 수 있습니다. 그렇다고 모든 이전 버전이나 모든 구독 가져오기 실패에 해당한다고 단정하지는 않습니다.

실패한 단계에 따라 점검하기

현재 증상우선 확인할 내용
암호화된 provider에서 no identities found 발생실제 코어, 전역 개인 키, provider의 별도 키 설정 확인
로그인 페이지가 반환되거나 인증 실패 또는 다운로드 시간 초과 발생콘텐츠를 가져오는 문제부터 해결해야 하며, 복호화 패치만으로 해결되지 않음
메인 설정 파일 전체를 읽지 못함메인 설정의 로드 방식과 개인 키 출처를 확인하고, provider 문제의 해결법을 그대로 적용하지 않기

전역 개인 키가 있는데 왜 인식하지 못할까?

provider 파서는 해당 항목의 age-secret-key를 복호화 함수에 전달합니다. 이전 구현은 빈 문자열을 받아도 먼저 개인 키로 파싱하려 했습니다. 이 단계에서 오류가 나면 뒤에 있는 전역 개인 키 시도까지 도달하지 못합니다. 별도 키를 넣지 않은 것이 오히려 정상적인 전역 키 사용을 막을 수 있었던 것입니다.

#3450은 실제로 비어 있는 문자열을 건너뛰어 이후 전역 개인 키 처리를 계속하도록 수정했으며, v1.19.34 정식 릴리스에 포함됐습니다. 공백이나 손상된 키, 값이 들어 있으나 유효하지 않은 개인 키를 자동으로 고치지는 않습니다. 전역 개인 키를 로드하지 않은 프로세스에 키를 만들어 주는 수정도 아닙니다.

독립 코어의 -age-secret-key 인수는 기본적으로 CLASH_AGE_SECRET_KEY에서 값을 읽을 수 있습니다. 하지만 내 터미널에서 변수를 설정했다고 이미 실행 중인 GUI 클라이언트나 백그라운드 서비스가 그 값을 상속하는 것은 아닙니다. 다른 터미널의 값만 보지 말고 실제 코어를 시작하는 방식을 확인해야 합니다.

실제 코어 업데이트, 어려우면 기존 개인 키를 항목에 지정

복원할 수 있는 설정, 기존 키 관리 방식, 암호화된 provider 캐시를 먼저 백업하고 정상 작동하던 코어와 시작 방식을 기록하세요. 암호문과 일치하는 개인 키의 관계를 보존해야 합니다. 이 오류 때문에 관계없는 새 개인 키를 만들지 마세요.

프로젝트에서 지원하는 방법으로 #3450 수정이 포함된 코어를 받으세요. 이 글에서 확인한 정식 버전은 v1.19.34입니다. 클라이언트 사용자는 지원되는 코어 업데이트 방법을 확인해야 하며, GUI 앱 버전만으로 판단하거나 서비스 디렉터리의 실행 파일을 임의로 덮어쓰면 안 됩니다.

같은 provider를 대상으로 진행하기

  1. 기존 개인 키가 이 암호문과 일치하는지 확인

    현재의 유효한 개인 키와 원래 provider 내용을 보관하고, 정상 작동하던 기록과 대조하세요. 암호화할 때 지정한 수신자 공개 키와 복호화에 사용하는 개인 키가 일치해야 합니다. 구독 토큰, 공개 키, 다른 설정의 개인 키를 복호화 키로 착각하지 마세요.

  2. 실제로 시작하는 파일과 새 코어 확인

    독립 코어라면 실제 사용하는 실행 파일의 버전을 확인하세요. GUI 클라이언트나 서비스라면 코어 정보와 새 시작 로그를 봅니다. 이후 프로젝트 안내에 따라 정상적으로 재시작하고 기존의 유효한 전역 개인 키 로드 방식을 유지하여 새 프로세스가 수정을 실제로 사용하게 하세요.

  3. 당장 업데이트할 수 없다면 provider의 자체 필드 사용

    기존 proxy-providers 항목의 age-secret-key에 현재 보유한 동일하고 유효하며 암호문과 일치하는 개인 키를 넣은 뒤, 원래 방식대로 저장하고 다시 로드하세요. #3449 보고자는 이 방법으로 복호화되는 것을 확인했습니다. 임시 처리 제안이며, 이 사이트에서 실제 기기로 시험한 결과는 아닙니다.

  4. 다른 설정은 유지하고 이 항목만 갱신

    기존 provider 이름, 주소, 경로, 노드 선택을 유지한 채 같은 provider를 다시 갱신하고 첫 번째 오류를 확인하세요. 구독과 키를 동시에 바꾸거나 캐시를 비우면 비교하고 복원할 수 있는 상태를 잃게 됩니다.

독립 코어 버전 확인: 실제 시작 파일을 대상으로 실행
mihomo -v

위 명령은 호출된 프로그램의 버전만 보여 줍니다. PATH에 있는 같은 이름의 프로그램이 클라이언트에서 실행 중인 코어와 같다는 보장은 없습니다. 아래 예시는 기존 provider 항목 안에 필드만 추가하는 것이며 전체 설정이 아닙니다. 자리표시자를 이미 보유한 일치하는 개인 키로 바꿔야 하며, 그대로 복사해 실행하면 안 됩니다.

임시 필드 예시: 기존 provider 항목 안에 추가
age-secret-key: "<YOUR_EXISTING_MATCHING_PRIVATE_KEY>"

개인 키는 자신이 관리하는 설정 위치에 보관하고, 도움을 요청하는 스크린샷이나 명령 기록, 공개 로그에 붙여 넣지 마세요. 다시 생성되는 런타임 YAML을 직접 편집하여 이 필드를 영구 저장하려 하지 말고, 원래 지원되는 설정이나 영구 오버라이드 방식을 사용하세요.

provider 로드를 확인한 뒤 실제 요청으로 검증

새로 시작한 실제 코어에 v1.19.34 수정이 포함됐는지 먼저 확인하고 실패하던 provider를 갱신하세요. 이번 갱신이 완료됐는지, 원래 복호화 오류가 사라졌는지, 예상한 노드가 실제로 로드됐는지 확인합니다. 예전 목록이 남아 있거나 구문 검사를 통과한 것만으로 원격 암호문이 복호화됐다고 볼 수는 없습니다.

그다음 예상한 노드 중 하나를 선택해 원래 접속하려던 대상에 새로운 실제 요청을 보내고 연결 기록과 함께 확인하세요. provider 복호화 성공은 노드 설정을 얻었다는 뜻일 뿐, 노드나 DNS 또는 대상 서비스에 연결할 수 있음을 보장하지는 않습니다.

검증 체크리스트

  • GUI 버전만 확인하지 않고 실제 실행 중인 코어, 시작 방식, 개인 키 출처를 확인했다.
  • 동일한 provider 암호문과 일치하는 개인 키로 시험했으며, 구독을 바꿔 결과를 가리지 않았다.
  • 이번 provider 갱신에 성공하고 예상한 노드가 로드됐으며, 원래 복호화 오류가 다시 나타나지 않았다.
  • 새로운 실제 프록시 요청이 정상이다. 실패한다면 현재의 첫 번째 오류를 보관하여 네트워크 문제를 계속 구분한다.
  • 백업을 복원할 수 있고, 추가한 provider 개인 키 사본도 자신의 설정 보호 대상에 포함했다.

계속 실패하면 첫 번째 오류에 따라 복구·분리 점검

전역 개인 키가 서비스나 클라이언트 코어에 실제로 전달되지 않음

프로젝트에서 지원하는 시작 설정으로 돌아가 확인하고, 정상적으로 재시작한 뒤 다시 점검하세요. 다른 터미널의 임시 변수만으로 기존 프로세스가 개인 키를 받았다고 추정하면 안 됩니다.

provider에 공백, 잘못된 키 또는 비어 있지 않지만 손상된 개인 키를 입력함

원래 유효했던 개인 키와 그에 대응하는 암호문을 확인하세요. 수정은 빈 문자열만 건너뜁니다. 유효하지 않은 키를 조용히 무시하거나 자동 대체가 반드시 성공하도록 만드는 것은 아닙니다.

콘텐츠가 예상한 age ASCII armor가 아니거나 다운로드 단계에서 실패함

실제로 반환된 내용과 다운로드 오류를 확인한 뒤 제공자에게 형식과 키를 확인하세요. 로그인 페이지, 인증 실패, 관련 없는 YAML 오류를 모두 이 패치로 설명하면 안 됩니다.

저장하거나 다시 로드한 뒤 원래 설정도 사용할 수 없음

추가 변경을 멈추고 정상 작동을 확인한 설정, 시작 방식, 보호된 캐시 사본을 복원하세요. 필요하면 프로젝트에서 지원하는 방식으로 원래 사용하던 코어로 돌아갑니다. 롤백했다고 이전 결함이 수정된 것은 아닙니다.

문제를 보고할 때는 전체 코어 버전, provider 유형, 전역 키와 항목별 개인 키 중 어느 것을 사용하는지, 민감 정보를 제거한 첫 번째 오류를 제공하세요. 전체 설정, 암호문 원본, 개인 키는 자신이 관리하는 위치에 두고, 도움 요청용 사본에서는 구독 토큰, 개인 키, 노드 비밀번호를 제거하세요.

이 글은 공식 릴리스, 고정 버전 코드와 이슈 논의를 대조한 내용입니다. 코어를 다운로드하거나 사용자의 자격 증명을 처리하거나 실제 클라이언트에서 복호화를 재현하지 않았습니다. #3449는 현재 열린 상태이며, 수정이 병합됐다는 사실을 이슈 종료나 사용자 검증 완료로 표현하지 않습니다.

참고 자료