Windows, CPU 아키텍처, WebView2부터 확인하기

공식 설치 문서는 Windows 10 이상, 64비트 시스템, Microsoft Edge WebView2를 Windows 전제 조건으로 안내합니다. 앱이 실행되지 않을 때 설치형과 포터블을 반복해 교체하기 전에 운영체제가 조건을 충족하는지를 먼저 분리해 확인하세요.

설정, 시스템, 정보에서 시스템 종류를 확인합니다. 일반적인 Intel/AMD 64비트 PC는 x64 패키지를 사용합니다. v1.6.1 안정 릴리스에는 네이티브 Windows arm64 파일이 없으므로 Windows on Arm 사용자는 x64 파일을 ARM64 전용 빌드로 오해하지 마세요. WebView2가 없거나 손상되었다면 Microsoft가 지원하는 경로로 설치하거나 복구하세요.

v1.6.1 공식 Releases에 실제로 올라온 파일을 기준으로 선택하세요.Windows 파일은 x64 빌드이며 setup.exe와 portable.zip는 설치 방식의 차이이지 CPU 아키텍처 두 종류를 뜻하지 않습니다.

설치형과 포터블 ZIP 중 하나 선택하기

설치 자산은 Clash.Nyanpasu_x.y.z_x64-setup.exe와 같은 이름으로 설치 절차를 실행합니다. 포터블 자산은 Clash.Nyanpasu_x.y.z_x64_portable.zip과 같은 이름이며 모든 파일을 풀어야 합니다. 한 PC에서 계속 사용할 것이면 설치형이 명확하고, 격리된 시험이나 설치 마법사를 실행할 수 없는 경우에는 ZIP을 고려할 수 있습니다.

Clash Nyanpasu Windows 패키지 차이
항목설치형포터블 ZIP
실행setup.exe를 먼저 실행전체 압축 해제 후 실행
시스템 통합일반적인 설치 사용에 적합공식 문서에 기능 제약 명시
WebView2필요패키징이 자동 탐지하지 않음
용도한 컴퓨터의 지속 사용시험 및 버전 격리

공식 안내는 Tauri가 포터블 모드를 공식 지원하지 않으며, 시스템 서비스, 알림, 사용자 지정 URL 스키마 등에 제약이 있음을 밝힙니다. EXE가 열린다고 모든 시스템 통합이 설치형과 동일한 것은 아닙니다.

설치 패키지로 깨끗한 첫 실행 검증

설치 전에 트레이 프로세스를 포함한 다른 Clash/Mihomo 클라이언트를 종료하세요. 두 클라이언트가 로컬 포트를 경쟁하거나 Windows 프록시 설정을 반복해 덮어쓰면 설치는 성공했어도 고장처럼 보입니다. 기존 프로필의 이름, 모드, 사용자 규칙을 기록하고 구독 Token은 공개하지 마세요.

  1. 공식 릴리스에서 x64-setup.exe로 표시된 파일을 받습니다. Windows on Arm에서는 호환성을 먼저 확인하고, 목록에 없는 v1.6.1 ARM64 안정판을 찾지 마세요.
  2. 파일명과 버전을 비교하고 설치를 실행합니다. 보안 대화 상자의 출처가 예상과 다르면 중지합니다.
  3. 첫 실행 후 버전 정보를 열어 오래된 바로 가기가 다른 설치를 열지 않았는지 확인합니다.
  4. 이미 검증된 프로필 하나만 가져와서 코어와 프록시 그룹을 로드합니다.
  5. 기본 시스템 프록시가 동작한 후에만 TUN 또는 서비스 기능을 별도로 시험합니다.

이 순서는 데스크톱 앱 실행, 프로필 파싱, Windows 트래픽 처리를 서로 다른 결과로 확인합니다. 앱이 실행되지 않는데 노드를 바꾸는 것은 도움이 되지 않습니다.

포터블 패키지를 전체 압축 해제하고 제약 검증

포터블 ZIP을 계정이 쓸 수 있고 경로가 안정적인 폴더에 두고 완전히 풉니다. 압축 관리자의 미리보기에서 EXE를 바로 실행하면 인접 자원을 찾지 못하거나 미리보기가 닫힐 때 임시 경로가 사라질 수 있습니다.

  1. 파일명의 버전, x64, portable 표시를 확인합니다.
  2. ZIP 전체를 새 폴더에 풀고 메인 EXE만 복사하지 않습니다.
  3. WebView2가 설치되었는지 확인한 다음 실행합니다.
  4. 인터페이스, 프로필 로드, 알림, 필요한 시스템 통합을 각각 시험합니다.

포터블은 모든 설정이 압축 해제 폴더에 저장된다는 보장이 아닙니다.현재 버전의 실제 동작과 공식 문서로 확인할 때까지 이동식 디스크를 분리하거나 기존 설치를 삭제하지 마세요.

두 설치 환경을 섞지 않고 이전하기

설치형에서 포터블로, 또는 반대로 이동할 때는 작동하는 환경을 보존하고 새 패키지를 별도 위치에서 실행합니다. 앱이 지원하는 내보내기/가져오기를 사용하거나 필요한 설정만 의도적으로 재작성하세요. 캐시와 프로그램 트리를 무차별하게 덮어쓰지 마세요.

첫 실행 및 이전 후 확인
현상먼저 확인다음 조치
창이 없음아키텍처, Windows, WebView2맞는 공식 패키지를 다시 다운로드
프로필이 없음실제 실행된 폴더와 버전캐시 복사 대신 제어된 가져오기
포터블 통합이 없음공식 포터블 제약필요하면 설치형 사용
프록시가 계속 변함다른 클라이언트와 트레이전부 종료하고 하나만 실행

예상한 버전 실행, 프로필 로드, 코어 시작, 시험 요청, 종료 후 Windows 프록시 복원을 순서대로 확인한 뒤 이전 패키지를 삭제합니다. 문제 보고에는 Windows 버전, 아키텍처, 패키지 유형, Nyanpasu 버전, 재현 단계, 구독 Token을 제거한 최소 로그를 포함하세요.

공식 자료와 버전 범위

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