이 글의 목차
Ubuntu 설치는 아키텍처에 맞는 DEB 선택부터 시작
Ubuntu에서의 전체 순서는 CPU 아키텍처에 맞는 공식 DEB를 받고 apt로 설치한 뒤 구독을 가져와 시스템 프록시를 검증하고 마지막으로 자동 시작을 설정하는 것입니다. 시스템 프록시가 아직 안정적이지 않을 때 TUN 서비스를 함께 설치하거나 로그인 후 자동 인수를 설정하면 재시작 후 연결이 끊겼을 때 되돌리기 더 어렵습니다.
2026-07-23 기준 Clash Verge Rev 최신 안정 버전 v2.5.2는 amd64, arm64와 armhf용 DEB를 제공합니다. Ubuntu와 Debian 사용자는 DEB를 직접 사용하면 데스크톱 메뉴, 의존성과 제거를 패키지 관리자에서 처리할 수 있습니다. 현재 Latest에는 AppImage가 없으므로 제삼자 사이트에서 따로 찾을 필요가 없습니다.
아키텍처 매핑
| uname -m | DEB 파일 |
|---|---|
| x86_64 | *_amd64.deb |
| aarch64 / arm64 | *_arm64.deb |
| armv7l | *_armhf.deb, 시스템 자체가 32비트 ARM인지 먼저 확인 |
다운로드 후 아키텍처와 패키지 정보부터 확인
DEB='./Clash.Verge_2.5.2_amd64.deb'
uname -m
dpkg --print-architecture
dpkg-deb -I "$DEB" | sed -n '1,25p'버전 번호는 현재 예시일 뿐이며 파일 이름은 직접 다운로드한 Release를 기준으로 확인해야 합니다. dpkg-deb로 패키지의 Architecture와 Depends를 읽을 수 있습니다. 이 단계에서 이미 시스템과 맞지 않는다면 --force-architecture로 강제 설치하지 마세요.
apt로 로컬 DEB를 설치해 의존성까지 함께 해결
아키텍처가 일치하는지 확인한 뒤 apt에 로컬 파일 설치를 맡깁니다. 의존성이 없을 때 명확한 패키지 이름이 표시되고 이후 같은 패키지 관리 시스템에서 제거하기도 쉽습니다.
DEB='./Clash.Verge_2.5.2_amd64.deb'
sudo apt install "$DEB"
# 查看安装状态
dpkg -l | grep -i clash-verge
# 需要卸载时先记下上一步显示的真实包名
sudo apt remove clash-verge명령의 파일 이름과 패키지 이름은 로컬 결과를 기준으로 확인해야 합니다. apt에서 의존성을 충족할 수 없다고 표시되면 전체 오류와 Ubuntu 버전을 저장하세요. 임의의 웹사이트에서 .so 파일 하나를 받아 시스템 라이브러리를 덮어쓰지 마세요. 설치 후 바로 TUN을 켜기보다 앱 메뉴에서 한 번 시작하면 WebKit, 트레이 또는 코어 시작 오류를 더 쉽게 볼 수 있습니다.
첫 검증에서는 Profile과 시스템 프록시만 확인
앱을 시작할 수 있다면 TUN은 아직 건드리지 마세요. 간단한 Profile과 시스템 프록시로 브라우저 접속을 완료하는 것만으로 설치 패키지, Mihomo 코어와 데스크톱 프록시가 정상적으로 함께 작동하는지 확인할 수 있습니다.
최소 인터넷 연결 경로
원격 구독 또는 로컬 구성 가져오기
Clash Verge Rev 2.x는 URL, 로컬 파일과 드래그 앤 드롭 가져오기를 지원합니다. 먼저 수동 업데이트하세요.
현재 Profile로 설정
정책 그룹과 노드가 이전 캐시가 아닌지 확인합니다.
노드 하나 고정
Rule 모드를 유지하고 시스템 프록시를 켭니다.
브라우저를 열고 연결 확인
도메인, 규칙과 외부 경로가 함께 나타나야 데스크톱 프록시가 정상입니다.
로그, Profiles와 터미널 프록시의 위치
브라우저는 사용할 수 있지만 터미널 명령에서 계속 시간 초과가 발생하는 일은 Linux에서 흔합니다. 데스크톱 시스템 프록시와 shell 환경 변수는 서로 다른 설정이므로 먼저 구분해서 확인하세요. apt 또는 Git 때문에 바로 TUN을 켤 필요는 없습니다.
공식 문서에 나온 Linux 경로
| 내용 | 경로 |
|---|---|
| verge.yaml | ~/.config/io.github.clash-verge-rev.clash-verge-rev/verge.yaml |
| 작업 디렉터리 | ~/.local/share/io.github.clash-verge-rev.clash-verge-rev/ |
| Profiles | ~/.local/share/io.github.clash-verge-rev.clash-verge-rev/profiles/ |
| WebView 캐시 | ~/.cache/io.github.clash-verge-rev.clash-verge-rev/ |
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1,::1
# 结束测试
unset HTTP_PROXY HTTPS_PROXY NO_PROXY시스템 프록시 검증에 성공한 뒤에만 자동 시작 활성화
Clash Verge Rev 설정 페이지에서 '자동 시작' 또는 Auto Launch를 먼저 켭니다. 버전에 따라 이름이 조금 다를 수 있습니다. 사용자 로그인 후 데스크톱에서 앱을 시작한다는 뜻이며 부팅 전부터 프록시가 있다는 의미는 아닙니다. 권한 확인 없이 TUN이 자동으로 트래픽을 인수한다고 보장하지도 않습니다. 시스템 프록시만 필요한 사용자는 TUN을 계속 꺼 두세요.
find ~/.config/autostart /etc/xdg/autostart -maxdepth 1 -type f -iname '*clash*' -print 2>/dev/null
grep -R '^Exec=' /usr/share/applications 2>/dev/null | grep -i 'clash.verge|clash-verge'자동 시작을 실제로 한 번 검증
먼저 로그아웃한 뒤 데스크톱에 다시 로그인
Clash Verge Rev 프로세스가 하나만 나타나고 기존 클라이언트가 함께 시작하지 않는지 확인합니다.
현재 Profile과 노드 확인
앱이 시작된 뒤에도 구독이 선택되어 있고 실행 구성이 방금 검증한 파일인지 확인해야 합니다.
시스템 프록시 확인
자동으로 켜도록 설정했다면 브라우저 요청이 연결 기록에 나타나야 합니다. 자동 인수를 원하지 않으면 스위치를 꺼 둡니다.
종료 후 복구 테스트
앱 메뉴에서 정상적으로 종료하면 Ubuntu의 HTTP, HTTPS와 SOCKS 프록시가 더 이상 로컬 포트를 가리키지 않습니다.
이번 로그인 테스트를 통과해야 자동 시작이 실제로 작동하는 것입니다. 트레이 아이콘만 나타나는 것으로는 부족합니다. Profile이 선택되지 않았거나 시스템 프록시가 남아 있으면 아이콘과 네트워크 상태가 서로 다를 수 있습니다.
실제로 프록시를 읽지 않는 프로그램이 있을 때만 TUN 서비스 설치
TUN에는 서비스와 가상 네트워크 인터페이스 권한이 필요합니다. 시스템 프록시를 먼저 안정화한 뒤 현재 버전의 설정 페이지에서 서비스를 설치하세요. 이전 가이드의 서비스 스크립트와 설치 디렉터리는 달라졌을 수 있습니다. 권한 또는 IPC 오류가 발생하면 현재 Release와 공식 FAQ를 먼저 확인하고 다른 버전에서 남은 명령을 바로 실행하지 마세요.
트레이가 보이지 않는 현상은 대개 데스크톱 환경의 AppIndicator 지원 부족 때문입니다. 창이 즉시 종료된다면 터미널에서 앱을 시작해 stderr를 확인하세요. 두 문제 모두 구독 노드 품질과는 무관합니다.
두 번 클릭해도 창이 나타나지 않음
터미널에서 시작하고 WebKit/그래픽 라이브러리 오류를 보존한 뒤 현재 데스크톱 세션을 확인합니다.
브라우저는 되지만 apt/Git은 연결되지 않음
해당 명령에 환경 변수 또는 도구 구성을 설정하고 TUN부터 켜지 않습니다.
TUN 스위치가 즉시 꺼짐
서비스 설치와 권한을 확인하고 DNS와 노드를 반복해서 바꾸지 마세요.
종료 후 브라우저에서 인터넷을 사용할 수 없음
데스크톱 네트워크 설정에서 남은 프록시를 끄고 앱이 강제 종료되었는지 확인합니다.