이 글은 OpenWrt LuCI의 OpenClash v0.47.156과 Mihomo 코어에 vmess:// 공유 링크 하나를 추가하는 작업만 다룹니다. Clash for Windows, Clash Verge Rev, FlClash의 가져오기 화면에는 적용할 수 없습니다. 이전 OpenClash 버전은 화면 문구와 파서 동작이 다를 수 있습니다.

vmess:// 링크는 보통 서버, 포트, UUID, 전송 방식, TLS 정보를 포함한 단일 VMess 노드입니다. https:// 구독 URL은 OpenClash가 내려받고 갱신할 수 있는 원격 엔드포인트입니다. 단일 노드 링크를 다운로드 URL처럼 붙여 넣는 것만으로 원격 프로필이 되지는 않습니다.

입력의미이 글의 처리 방법
vmess://…VMess 노드 1개의 공유 링크온라인 변환을 켜거나 서버 노드 편집기에서 로컬 가져오기
https://…원격 구독 또는 설정 URL보통 Config Subscribe에 직접 추가
.yaml / .yml이미 만들어진 설정 파일설정 파일 관리에서 업로드하며 이 글의 범위가 아님

두 가지 경로가 있습니다:온라인 변환은 간단하지만 변환 서비스에 링크가 전달됩니다. v0.47.156의 로컬 가져오기는 LuCI 페이지 안에서 링크를 분석해 폼을 채우므로 타사 변환 서비스가 필요 없습니다. 개인용 또는 자체 운영 노드에는 로컬 경로가 적합합니다.

완전한 VMess 공유 링크는 비밀번호처럼 다루십시오. 공개 검색, 포럼, 온라인 YAML 검사기, 문제 해결 화면 캡처에 붙여 넣지 마십시오. 이 글은 마스킹된 예시만 사용합니다.

마스킹 예시vmess://REDACTED
  1. 사용 권한이 있고 신뢰할 수 있는 서버 또는 서비스에서 받은 링크인지 확인합니다.
  2. 현재 활성 프로필 이름, OpenClash 실행 상태, 정상 연결되는 기존 노드를 기록합니다.
  3. 온라인 변환을 고려한다면 운영자와 로그 정책을 확인합니다. 확인할 수 없으면 로컬 가져오기를 선택합니다.
  4. 링크가 이미 노출되었다면 가져오기 전에 인증 정보를 폐기하고 새로 생성합니다.

노드 하나에도 민감한 정보가 있습니다:VMess UUID는 인증 정보입니다. 서버 호스트, 포트, SNI, WebSocket Host, 경로도 노출될 수 있으므로 표시 이름만 가리는 것은 충분하지 않습니다.

방법 1: Config Subscribe에서 온라인 변환을 활성화합니다

OpenClash v0.47.156 구독 편집 화면은 Subscribe Convert Online을 활성화했을 때 Subscribe Address가 SS, SSR, VMess 등의 노드 링크를 지원한다고 명시합니다. 변환 서비스가 링크를 받으므로 직접 운영하거나 충분히 검증한 서비스에서만 사용하십시오.

  1. Services → OpenClash → Config Subscribe를 열고 이번 테스트용 항목을 새로 만듭니다.
  2. 구분하기 쉬운 별칭을 정하고 완전한 vmess:// 링크 하나를 Subscribe Address에 입력합니다. 첫 테스트에서 기존 구독과 섞지 마십시오.
  3. Subscribe Convert Online을 켜고 검증한 Convert Address를 선택합니다. 화면의 기본 주소는 개인정보 보호를 보증하지 않습니다.
  4. 저장 후 목록으로 돌아가 해당 행을 갱신하거나 아래쪽의 Update Config를 실행합니다. Update Config는 설정을 저장하고 OpenClash를 활성화해 시작하므로 잠시 연결이 끊길 수 있습니다.
  5. 완료 후 프로필과 VMess 노드가 생성되었는지 확인합니다.

화면 자체에 개인정보 유출 위험 경고가 있습니다:온라인 구독 변환은 라우터 내부의 오프라인 변환이 아닙니다. 운영자를 확인할 수 없는 서비스에는 링크를 전송하지 마십시오.

방법 2: 서버 노드 편집기에서 로컬로 가져옵니다

변환 서비스에 링크를 전달하고 싶지 않다면 OpenClash 서버 노드 편집기를 사용합니다. v0.47.156에는 SS/SSR/VMESS/TROJAN URL 행과 Import 버튼이 있으며 공유 링크를 붙여 넣도록 안내합니다. 페이지 소스의 parseVmess가 브라우저 안에서 값을 분석해 폼을 채웁니다. 타사 변환기는 필요하지 않지만 저장된 인증 정보는 라우터 설정에 기록됩니다.

  1. Services → OpenClash → Config Manage를 열고 대상 YAML 행의 Actions에서 Servers Manage를 선택한 뒤 Apply를 누릅니다.
  2. Servers & Groups manage에서 화면 안내대로 편집 전에 Read Config를 누르고 Proxies 영역에 항목 하나를 추가합니다.
  3. 새 항목의 SS/SSR/VMESS/TROJAN URL 행에서 Import를 누르고 완전한 vmess:// 링크를 붙여 넣습니다. 성공 문구는 분석 성공만 의미합니다.
  4. Config File이 앞에서 선택한 설정인지 확인합니다. 모든 설정에 추가하는 옵션은 의도한 경우에만 사용합니다.
  5. 대상 설정에 실제로 존재하는 Proxy Group을 선택합니다. 아직 만들지 않은 그룹 이름을 입력하지 마십시오.
  6. 모든 필드를 확인하고 Commit Settings로 저장합니다. Servers & Groups manage로 돌아가 Apply Settings를 눌러 대상 YAML에 기록한 뒤 실행 중인 설정을 다시 불러옵니다.

개인용 단일 노드에는 로컬 가져오기가 적합합니다:원본 링크를 변환 서비스로 보내지 않으며, 단일 노드가 자동 갱신 구독으로 취급되지도 않습니다. 인증 정보가 바뀌면 수동으로 편집하거나 다시 가져와야 합니다.

저장 전에 VMess 필드를 대조합니다

v0.47.156 가져오기 코드는 일반적인 V2RayN Base64 JSON을 먼저 분석하고 URI 형식 VMessAEAD도 시도합니다. 알려진 필드를 폼에 반영하고 일부 알 수 없는 단순 값은 ‘기타 매개변수’에 기록하지만, 모든 알 수 없는 객체를 복원하지는 않습니다. 서버 설정과 Mihomo VMess 문서를 기준으로 결과를 확인하십시오.

확인 항목일반적인 원본 키불일치 증상
서버, 포트, UUIDadd, port, id주소 해석, 연결 또는 인증 실패
암호화, Alter IDscy / encryption, aid핸드셰이크 실패. 임의 값으로 바꾸지 않기
TLS, SNI, 지문tls / security, sni, fpTLS 또는 인증서 오류
전송 방식net / typeTCP, WebSocket, HTTP/2, gRPC 불일치
경로, Host, 서비스 이름path, host, serviceName서버는 도달하지만 프로토콜 요청 실패
프로필 및 그룹 범위OpenClash 폼 선택저장한 노드가 활성 프로필이나 그룹에 없음

인증서 검증 기본값을 반드시 확인하십시오:v0.47.156의 새 노드 폼은 skip-cert-verify 기본값이 true입니다. VMess 가져오기는 링크에 insecure 매개변수가 없을 때도 이를 자동으로 false로 바꾸지 않습니다. 신뢰하는 원본 설정이 검증 생략을 요구하지 않는다면 저장 전에 직접 false로 바꾸십시오. 폼 기본값을 서버 요구 사항으로 해석하지 마십시오.

한 번 적용한 뒤 노드 목록과 실제 연결을 검증합니다

  1. 구독 또는 서버 노드를 저장한 뒤 설정을 한 번만 갱신하거나 적용하고 OpenClash가 실행 상태로 돌아올 때까지 기다립니다.
  2. 시작 로그에서 처음 나온 프로필 분석, 그룹 또는 VMess 오류를 확인합니다. 갱신 버튼을 반복해서 누르지 마십시오.
  3. 새 노드가 지정한 프로필과 그룹에 나타나는지 확인합니다. 보이지 않으면 TLS보다 먼저 적용 범위를 확인합니다.
  4. 새 노드를 직접 선택하고 실제 요청을 한 번 보낸 뒤 연결 로그에서 최종 노드와 오류 종류를 확인합니다.
  5. 이전에 정상 동작한 노드로 되돌려 다시 시험해 새 노드 문제와 라우터 전체 문제를 구분합니다.

지연 시간 시험 성공은 그 순간 헬스 체크 대상에 도달했다는 뜻일 뿐입니다. OpenClash가 시작되고, 노드가 정확한 프로필과 그룹에 있으며, 실제 요청에 사용되고, 기존 노드로 되돌릴 수 있어야 완료입니다.

노드는 보이지만 연결되지 않는 경우:UUID, 포트, TLS, SNI, 전송 방식을 서버와 먼저 대조하십시오. DNS, Fake-IP, TUN, 코어, 프록시 모드를 동시에 바꾸지 마십시오.

문제 해결과 원복은 이번에 추가한 항목만 대상으로 합니다

증상먼저 확인할 것처리
구독 갱신 실패온라인 변환이 꺼져 있는지신뢰하는 변환기를 사용하거나 로컬 가져오기로 변경
로컬 가져오기 형식 오류완전한 vmess:// 링크인지신뢰하는 출처에서 다시 복사하고 디코딩 정보를 공개하지 않기
분석 성공 후 노드가 없음Config File과 Proxy Group활성 프로필과 기존 그룹을 선택한 뒤 다시 적용
노드는 있으나 연결 실패서버, UUID, TLS, SNI, 전송서버와 대조하고 한 번에 한 필드만 변경
갱신 후 OpenClash 시작 실패시작 로그의 첫 분석 오류이번 항목을 제거하고 이전 프로필 복원

로컬 경로를 원복할 때는 이번 서버 노드만 삭제하고 Servers & Groups manage에서 Apply Settings를 다시 실행하여 삭제 결과를 대상 YAML에 기록한 뒤 실행 설정을 다시 불러옵니다. 온라인 경로는 먼저 기존 활성 프로필로 전환한 다음 이번 Config Subscribe 항목을 비활성화하거나 삭제합니다. 이 작업만으로 생성된 YAML이 지워지지는 않습니다. 파일이 이번 테스트에서만 만들어졌다면 비활성 상태인지 확인하고 백업을 내려받은 후 Config Manage에서 따로 삭제하십시오. 기존 구독이나 모든 노드를 지우지 마십시오.

신뢰할 수 없는 변환기에 링크를 보냈다면 OpenClash에서 삭제해도 정보 노출을 되돌릴 수 없습니다. 서버 또는 서비스에서 UUID를 교체하거나 인증 정보를 다시 만드십시오. 관련 항목은 사이트의 다운로드 페이지에서 확인할 수 있지만 클라이언트 변경으로 잘못된 VMess 필드가 수정되지는 않습니다.

공식 자료와 버전 범위

버전 번호, 파일 이름, 화면 문구는 업데이트로 바뀔 수 있습니다. 작업 전에 연결된 공식 문서를 확인하세요.