이 글의 목차
업그레이드 전에 기존 버전으로 충분한지 FlClash v0.8.97의 새 기능이 필요한지 판단해야 합니다. 업데이트하기로 했다면 원래 설정과 접속 기록을 보존한 뒤 장치에 맞는 공식 설치 파일을 선택하세요. 화면이 열린 뒤에도 백그라운드 프로세스와 평소 사용하는 연결은 각각 확인해야 합니다.
FlClash v0.8.97은 무엇을 다시 만들었으며 업그레이드할 만할까요?
FlClash v0.8.97은 2026년 9월 10일에 정식 안정 버전으로 출시되었습니다. 공식 변경 사항을 확인할 때 화면과 현지화, 앱 창 계층, 데스크톱 패키징, Android VPN, Helper 플러그인, 코어 IPC와 프로세스 수명 주기를 각각 확인하세요.
v0.8.96이나 더 이전의 안정 버전에서 업그레이드할 때 새 화면 메뉴, TUN, Android VPN, 창과 코어 상태를 확인하세요. Helper는 데스크톱 시스템 작업을 돕는 백그라운드 구성 요소이며 IPC는 앱과 코어가 통신하는 방식입니다. 이전 버전이 시작되지 않는다면 설정을 내보낼 수 있는 상태로 먼저 복구하세요.
공식 측은 v0.8.97이 모든 노드, 구독 또는 DNS 문제를 해결한다고 밝히지 않았습니다. 버전 번호만을 위해 업그레이드할 필요는 없습니다. 프록시 인증이나 새 크로스 플랫폼 UI가 필요하거나 체크리스트에 따라 회귀 검증을 할 수 있을 때 업데이트하세요.
현재 상태에 따른 결정
| 현재 상황 | 권장 사항 | 이유 |
|---|---|---|
| v0.8.96이 안정적으로 동작하고 새 기능이 필요하지 않음 | 업그레이드 보류 가능 | 큰 개편 전 복원할 수 있는 이전 설정 보관하기 |
| v0.8.97에 추가된 프록시 인증이 필요함 | 백업 후 업그레이드 | 공식 출시 설명에 명시된 새 기능임 |
| 새 UI, Helper 또는 Android VPN을 검증할 준비가 됨 | 플랫폼별로 단계적 업그레이드 | 시스템 프록시, TUN, VPN 중 한 번에 한 가지 방식만 테스트 |
| 이전 버전에서 이미 노드 Timeout 또는 구독 실패가 발생함 | 기존 문제부터 진단 | 업그레이드는 노드, 설정, DNS 진단을 대신할 수 없음 |
Profile과 설정을 저장하고 업그레이드 전 연결 결과 기록하기
이전 버전에서 현재 Profile의 구독 자동 업데이트를 잠시 끄고 Profile, 정책 그룹, 실행 모드와 시스템 프록시 또는 VPN/TUN 상태를 기록하세요. 실제 HTTPS 요청을 완료하고 FlClash를 종료한 뒤 직접 연결이 복구되는지도 확인하세요. 이 기록을 업그레이드 전후 비교에 사용합니다.
FlClash의 백업 또는 내보내기 기능으로 Profile과 앱 설정을 저장하고, 백업을 앱 데이터 디렉터리 밖에 복사하세요. 구독 URL, 노드 비밀번호, WebDAV 자격 증명은 민감한 정보이므로 공개 클라우드, issue 또는 스크린샷에 포함하면 안 됩니다.
데스크톱에서는 현재 설치 파일의 아키텍처와 시스템 수준 서비스 사용 여부도 기록하세요. Android에서는 시스템 버전, 배터리 제한, VPN 권한 상태를 기록해야 업그레이드 후 앱 변경과 기존 기기 제한을 구분할 수 있습니다.
업그레이드 전 보관할 기록
- 현재 FlClash 버전과 운영체제 아키텍처를 기록함
- Profile, 덮어쓰기, 앱 설정을 앱 외부에 백업함
- 현재 정책 그룹과 정상 동작하는 노드 하나를 기록함
- 시스템 프록시, TUN 또는 Android VPN의 원래 상태를 기록함
- 이전 버전에서 실제 HTTPS 요청을 완료하고 연결 기록을 남김
- FlClash 종료 후 기기를 직접 연결 상태로 복구하는 방법을 알고 있음
공식 Release에서 기기에 맞는 설치 파일 선택
v0.8.97 공식 Release는 Windows amd64와 arm64용 설치 프로그램 및 ZIP, macOS amd64와 arm64용 DMG, Android용 세 가지 ABI, Linux amd64와 arm64용 AppImage, DEB, RPM을 제공합니다.
이 글을 작성할 당시 이 사이트의 검증된 백업은 v0.8.96이었습니다. 현재 백업 버전은 다운로드 페이지의 표시를 기준으로 확인하세요. 이 글은 v0.8.97 업그레이드와 롤백을 다루며, 이 버전이 여전히 최신 안정판이라는 뜻은 아닙니다. 해당 버전이 필요하다면 chen08209/FlClash의 v0.8.97 공식 Release에서 태그, 파일 이름, SHA256SUMS를 확인하세요.
설치 파일 표기
| 플랫폼 | 일반적인 기기 | v0.8.97 선택 |
|---|---|---|
| Windows | Intel 또는 AMD 컴퓨터 | windows-amd64-setup.exe |
| Windows | ARM Windows 기기 | windows-arm64-setup.exe |
| macOS | Apple M 시리즈 | macos-arm64.dmg |
| macOS | Intel Mac | macos-amd64.dmg |
| Android | 대부분의 최신 휴대전화 | android-arm64-v8a.apk |
| Linux | 배포판과 uname -m 결과에 따라 선택 | 아키텍처에 맞는 AppImage, DEB 또는 RPM |
앱만 교체하고 설정은 동시에 바꾸지 않기
공식 안정 버전 다운로드
페이지 태그가 v0.8.97인지 확인하고 시스템 및 CPU 아키텍처에 맞는 첨부 파일을 선택하세요.
체크섬 목록 확인
기기의 파일 검증 도구로 설치 파일의 SHA256을 계산하고 같은 Release의 SHA256SUMS에서 해당 파일의 전체 값과 비교하세요. 파일 이름이 같다는 것만으로는 부족합니다. 다른 사람이 이름을 바꾸거나 다시 패키징한 파일은 사용하지 마세요.
이전 버전 완전히 종료
시스템 프록시, TUN 또는 Android VPN을 먼저 끈 다음 앱 메뉴에서 종료하고 이전 코어가 멈출 때까지 기다리세요.
덮어쓰기 설치 완료
기존 설정 디렉터리는 유지하고 업그레이드 중에는 새 구독을 가져오거나 DNS를 바꾸거나 노드를 교체하지 마세요.
데스크톱 창이 열리면 코어, 시스템 프록시와 Helper 확인하기
v0.8.97은 데스크톱 러너, 플러그인, Helper, Rust bridge, 코어 IPC를 함께 재구성했습니다. 창이 열린다는 것은 UI가 시작됐다는 뜻일 뿐입니다. Profile을 읽는지, 코어가 계속 실행되는지, 시스템 프록시 또는 TUN이 실제 요청을 처리하는지도 확인해야 합니다.
첫 실행에서는 업그레이드 전 Profile과 고정 노드만 사용하세요. 먼저 시스템 프록시를 켜서 브라우저 요청을 완료하고 연결 기록을 확인하세요. 기존에 TUN을 사용했다면 시스템 프록시 경로가 안정된 뒤 TUN만 따로 켜세요.
프록시 인증은 새 기능이지 기본적으로 켜야 하는 옵션이 아닙니다. 로컬 프록시 인바운드에 실제로 사용자 이름과 비밀번호가 필요할 때만 설정하고, 잘못된 자격 증명은 거부되고 올바른 자격 증명은 접속되는지 비교해 검증하세요.
창은 열리지만 프록시 그룹이 비어 있거나 코어가 반복 재시작됨
첫 번째 앱 또는 코어 오류를 확인하고 아직 구독을 다시 가져오거나 서비스를 재설치하지 마세요.
시스템 프록시는 되지만 TUN을 켠 뒤에만 인터넷이 끊김
문제는 Helper, 권한, DNS 또는 TUN 경로에 있습니다. 시스템 프록시로 복구해 계속 분리 진단하세요.
브라우저 요청이 실패하고 연결 기록이 비어 있음
시스템 프록시가 현재 FlClash 포트를 가리키는지 확인하고 다른 프록시 클라이언트를 종료하세요.
연결 기록이 있고 노드가 Timeout으로 표시됨
정상 동작이 확인된 다른 노드로 고정하고 일반적인 노드 장애를 v0.8.97 탓으로 단정하지 마세요.
프록시 인증을 설정한 뒤 모든 앱이 실패함
이번 인증 설정을 되돌리고 앱이 로컬 프록시에 자격 증명을 보낼 수 있는지 확인하세요.
데스크톱 통과 기준
- 앱에 v0.8.97이 표시되고 업그레이드 전 Profile과 정책 선택이 유지됨
- 코어가 계속 실행되고 UI에 IPC 또는 프로세스 오류가 반복 표시되지 않음
- 시스템 프록시에서 실제 HTTPS 요청이 성공하고 연결 기록이 보임
- TUN이 필요할 때 따로 켜면 이전에 누락된 앱이 인터넷에 연결됨
- 완전히 종료하면 시스템 프록시 또는 TUN이 해제되고 기기가 직접 연결로 돌아감
- 한 번 다시 실행한 뒤에도 Profile, 창 상태, 트래픽 처리 방식이 정상임
Android VPN의 시작, 네트워크 전환, 잠금과 중지가 정상인가요?
상태 표시줄에 VPN 아이콘이 나타난다고 프록시가 동작하는 것은 아닙니다. 연결 기록과 실제 HTTPS 요청을 함께 확인해야 합니다. 화면 잠금 후 아이콘이 사라지면 백그라운드 제한일 가능성이 크고, 아이콘은 남아 있지만 요청이 Timeout이면 노드, DNS, 규칙을 계속 확인하세요.
Android에서 앱 업데이트 후 확인 순서
기존 Profile 확인
앱을 연 뒤 Profile, 정책 그룹, 고정 노드를 확인하고 모든 구독을 즉시 새로고침하지 마세요.
VPN 한 번 시작
시스템의 FlClash VPN 요청을 허용하고 포그라운드 요청이 연결 기록에 들어오는지 확인하세요.
네트워크 전환 테스트
Wi-Fi, 모바일 네트워크, 화면 잠금 후 복구를 순서대로 테스트하며 매번 같은 대상 사이트만 관찰하세요.
수동으로 중지
FlClash 또는 시스템 VPN 페이지에서 연결을 끊고 일반 네트워크가 즉시 복구되는지 확인하세요.
업그레이드 후 문제 중 공식 수정된 것과 사용자 보고만 있는 것은 무엇인가요?
v0.8.97 출시 후 공식 issue에는 Windows 코어 재시작, Android 설정 저장, 스크립트 오버라이드, 빈 프록시 그룹에 대한 초기 보고가 올라왔습니다.
스크립트 보고자는 이후 변수를 const 또는 let으로 선언하자 해결됐다고 설명하고 issue를 닫았습니다. 보고마다 상태와 근거가 다르므로 모두에게 발생하는 결함으로 묶을 수 없으며, 보고자의 해결 방법을 유지관리자가 확인한 공통 수정으로 볼 수도 없습니다.
v0.8.98에는 Windows Modern Standby에서 Core 실행 유지와 Geo 파일 정보 갱신이라는 두 가지 수정만 명확히 포함되어 있으므로 다른 보고도 해결되었다고 주장할 수 없습니다.
내 기기에서 문제가 생기면 버전, 플랫폼, 설치 파일 이름, 첫 오류, 최소 재현 절차를 먼저 보존하세요. 데이터를 지우고 노드를 바꾸고 DNS까지 동시에 수정하는 것보다 같은 Profile로 v0.8.97과 업그레이드 전 버전을 비교하는 편이 판단에 도움이 됩니다.
실제 이상에 맞는 근거 보관하기
| 증상 | 보존할 근거 | 안전한 조치 |
|---|---|---|
| 앱이 열리지 않음 | 시스템 버전, 아키텍처, 설치 파일 이름, 첫 오류 | 직접 연결을 복구하고 공식 파일 확인 |
| Profile 또는 설정이 예상과 다름 | 업그레이드 전후 백업과 해당 필드 | 기존 사본을 덮어쓰며 계속 저장하지 않기 |
| 코어 또는 프록시 그룹 이상 | 앱 로그, 코어 로그, 같은 Profile | 트래픽 처리를 끈 뒤 버전 비교 |
| 실제 연결만 실패함 | 도메인, 적용 규칙, 출구, 노드 결과 | 노드, DNS 또는 규칙 진단으로 이동 |
문제가 생기면 이전 버전으로 돌아가고 업그레이드 근거 보존
v0.8.97이 내 기기에서 안정적으로 시작, 처리 또는 중지되지 않으면 시스템 프록시, TUN 또는 Android VPN을 먼저 끄고 기기가 직접 연결로 돌아왔는지 확인한 뒤 앱을 완전히 종료하세요. 새 프로세스와 이전 프로세스가 동시에 실행 중일 때 설정 디렉터리를 덮어쓰지 마세요.
민감 정보를 제거한 v0.8.97 로그와 현재 데이터 사본을 저장한 뒤 새 앱을 제거하세요. 롤백할 때는 업그레이드 전에 해당 기기에서 확실히 작동했던 공식 버전을 선택하고 업그레이드 전 백업을 가져와야 합니다. 현재 다운로드 페이지에서 제공하는 사이트 백업이 필요한 이전 버전이 아닐 수 있으므로 롤백 전에 버전과 출처를 확인하세요.
롤백 후 같은 Profile, 같은 노드, 같은 네트워크로 검증을 반복하세요. 이전 버전에서는 복구되고 v0.8.97에서 지속적으로 실패해야 유의미한 버전 비교가 됩니다. 프로젝트에 제보할 때도 구독 URL, 노드 비밀번호 또는 전체 설정은 업로드하지 마세요.