이 글의 목차
이번 업그레이드가 필요한지 변경 범위부터 확인
FlClash v0.8.97은 2026년 9월 10일 공식 안정 버전으로 출시되었습니다. 공식 설명에 따르면 단순한 소규모 수정이 아니라 UI와 현지화, 앱 창 계층, 데스크톱 패키징, Android VPN, Helper 플러그인, 코어 IPC와 프로세스 수명 주기를 함께 재구성한 버전입니다.
이 글은 v0.8.96 또는 그 이전 안정 버전을 사용하며 업그레이드를 준비 중이거나, 업그레이드 후 UI 진입점, TUN, Android VPN, 창 또는 코어 상태가 달라진 사용자를 위한 안내입니다. 이전 버전이 이미 실행되지 않는다면 먼저 설정을 내보낼 수 있는 상태로 복구하세요.
공식 측은 v0.8.97이 모든 노드, 구독 또는 DNS 문제를 해결한다고 밝히지 않았습니다. 버전 번호만을 위해 업그레이드할 필요는 없습니다. 프록시 인증이나 새 크로스 플랫폼 UI가 필요하거나 체크리스트에 따라 회귀 검증을 할 수 있을 때 업데이트하세요.
현재 상태에 따른 결정
| 현재 상황 | 권장 사항 | 이유 |
|---|---|---|
| v0.8.96이 안정적으로 동작하고 새 기능이 필요하지 않음 | 업그레이드 보류 가능 | 대규모 재구성 전에는 정상 동작 기준을 보존하는 것이 좋음 |
| v0.8.97에 추가된 프록시 인증이 필요함 | 백업 후 업그레이드 | 공식 출시 설명에 명시된 새 기능임 |
| 새 UI, Helper 또는 Android VPN을 검증할 준비가 됨 | 플랫폼별로 단계적 업그레이드 | 한 번에 하나의 트래픽 처리 경로만 테스트 |
| 이전 버전에서 이미 노드 Timeout 또는 구독 실패가 발생함 | 기존 문제부터 진단 | 업그레이드는 노드, 설정, DNS 진단을 대신할 수 없음 |
업그레이드 전에 Profile, 설정, 정상 동작 기준 저장
업그레이드에서 가장 중요한 준비는 버전 번호를 캡처하는 일이 아니라 복구 가능한 네트워크 경로를 남기는 것입니다. 이전 버전에서 현재 Profile의 구독 자동 업데이트를 잠시 끄고, 현재 Profile, 정책 그룹, 실행 모드, 시스템 프록시 또는 VPN/TUN 상태를 기록한 다음 실제 HTTPS 요청을 한 번 완료하세요.
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 공식 Release에서 태그, 파일 이름, SHA256SUMS를 확인하세요.
설치 전에 트레이 또는 앱 메뉴에서 FlClash를 완전히 종료하고 이전 코어가 더 이상 실행 중이지 않은지 확인하세요. 두 데스크톱 클라이언트가 동시에 시스템 프록시를 수정하게 두지 말고, Android VPN이 실행 중인 상태에서 덮어쓴 뒤 앱을 반복 실행하지 마세요.
설치 파일 표기
| 플랫폼 | 일반적인 기기 | 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 아키텍처에 맞는 첨부 파일을 선택하세요.
체크섬 목록 확인
파일 이름을 같은 Release의 SHA256SUMS와 대조하고 다른 사람이 이름을 바꾸거나 다시 패키징한 파일은 사용하지 마세요.
이전 버전 완전히 종료
시스템 프록시, TUN 또는 Android VPN을 먼저 끈 다음 앱 메뉴에서 종료하고 이전 코어가 멈출 때까지 기다리세요.
덮어쓰기 설치 완료
기존 설정 디렉터리는 유지하고 업그레이드 중에는 새 구독을 가져오거나 DNS를 바꾸거나 노드를 교체하지 마세요.
데스크톱에서는 UI, 코어, 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 수명 주기만 확인
Android 버전은 v0.8.97에서 VPN 서비스와 수명 주기를 재구성했습니다. 업그레이드 후 중지 상태에서 시작해 기존 Profile로 VPN을 한 번 켜고, 포그라운드 접속, 화면 잠금, Wi-Fi와 모바일 네트워크 전환을 확인한 뒤 수동으로 중지하세요.
상태 표시줄에 VPN 아이콘이 나타난다고 프록시가 동작하는 것은 아닙니다. 연결 기록과 실제 HTTPS 요청을 함께 확인해야 합니다. 화면 잠금 후 아이콘이 사라지면 백그라운드 제한일 가능성이 크고, 아이콘은 남아 있지만 요청이 Timeout이면 노드, DNS, 규칙을 계속 확인하세요.
Android 회귀 테스트 순서
기존 Profile 확인
앱을 연 뒤 Profile, 정책 그룹, 고정 노드를 확인하고 모든 구독을 즉시 새로고침하지 마세요.
VPN 한 번 시작
시스템의 FlClash VPN 요청을 허용하고 포그라운드 요청이 연결 기록에 들어오는지 확인하세요.
네트워크 전환 테스트
Wi-Fi, 모바일 네트워크, 화면 잠금 후 복구를 순서대로 테스트하며 매번 같은 대상 사이트만 관찰하세요.
수동으로 중지
FlClash 또는 시스템 VPN 페이지에서 연결을 끊고 일반 네트워크가 즉시 복구되는지 확인하세요.
출시 직후 보고는 관찰 범위를 정하는 데만 활용
v0.8.97 출시 후 공식 issue에는 Windows 코어 재시작, Android 설정 저장, 스크립트 덮어쓰기, 빈 프록시 그룹 등에 관한 초기 보고가 올라왔습니다. 아직 공통 재현 절차, 유지관리자 결론 또는 공식 수정이 없으므로 모든 사용자에게 발생하는 확인된 결함으로 볼 수 없습니다.
내 기기에서 문제가 생기면 버전, 플랫폼, 설치 파일 이름, 첫 오류, 최소 재현 절차를 먼저 보존하세요. 데이터를 지우고 노드를 바꾸고 DNS까지 동시에 수정하는 것보다 같은 Profile로 v0.8.97과 업그레이드 전 버전을 비교하는 편이 판단에 도움이 됩니다.
문제가 발생한 계층
| 증상 | 보존할 근거 | 안전한 조치 |
|---|---|---|
| 앱이 열리지 않음 | 시스템 버전, 아키텍처, 설치 파일 이름, 첫 오류 | 직접 연결을 복구하고 공식 파일 확인 |
| Profile 또는 설정이 예상과 다름 | 업그레이드 전후 백업과 해당 필드 | 기존 사본을 덮어쓰며 계속 저장하지 않기 |
| 코어 또는 프록시 그룹 이상 | 앱 로그, 코어 로그, 같은 Profile | 트래픽 처리를 끈 뒤 버전 비교 |
| 실제 연결만 실패함 | 도메인, 적용 규칙, 출구, 노드 결과 | 노드, DNS 또는 규칙 진단으로 이동 |
문제가 생기면 이전 버전으로 돌아가고 업그레이드 근거 보존
v0.8.97이 내 기기에서 안정적으로 시작, 처리 또는 중지되지 않으면 시스템 프록시, TUN 또는 Android VPN을 먼저 끄고 기기가 직접 연결로 돌아왔는지 확인한 뒤 앱을 완전히 종료하세요. 새 프로세스와 이전 프로세스가 동시에 실행 중일 때 설정 디렉터리를 덮어쓰지 마세요.
v0.8.97의 민감 정보를 제거한 로그와 현재 데이터 사본을 저장한 뒤 새 앱을 제거하고 업그레이드 전에 실제로 동작했던 공식 버전을 다시 설치한 다음 이전 백업을 가져오세요. 이 사이트의 v0.8.96 백업은 명확히 표시된 이전 버전 롤백 소스로만 적합합니다.
롤백 후 같은 Profile, 같은 노드, 같은 네트워크로 검증을 반복하세요. 이전 버전에서는 복구되고 v0.8.97에서 지속적으로 실패해야 유의미한 버전 비교가 됩니다. 프로젝트에 제보할 때도 구독 URL, 노드 비밀번호 또는 전체 설정은 업로드하지 마세요.
업그레이드 또는 롤백 완료 기준
- 현재 실행 버전과 설치 파일 출처를 확인할 수 있음
- Profile, 덮어쓰기, 정책 선택이 백업과 일치함
- 시스템 프록시 또는 Android VPN에서 실제 요청이 성공함
- TUN이 필요할 때 권한, DNS, 연결 기록을 따로 검증함
- 완전히 종료한 뒤 기기가 직접 연결로 돌아오고 남은 트래픽 처리가 없음
- 업그레이드 문제에 대한 최소 재현, 첫 오류, 버전 비교를 보존함
- 구독 링크, 비밀번호, 로그 경로, 개인 정보를 모두 비식별 처리함