이 글의 목차
Ubuntu에서는 시스템 아키텍처에 맞는 DEB 패키지를 사용해야 합니다. 창이 열리면 가져온 설정으로 인터넷에 연결할 수 있는지도 확인하세요. 브라우저, 명령줄, 로그인 시 자동 실행은 각각 확인할 설정이 다릅니다. 이미 정상 작동을 확인한 부분은 유지하고 실패한 단계를 살펴보세요. 터미널에서 시간 초과가 났다고 설치부터 다시 시작할 필요는 없습니다.
Ubuntu에 DEB 설치하기: amd64, arm64와 armhf 선택 방법
아래 표에서 현재 프로세서 아키텍처와 Ubuntu DEB 패키지가 일치하는지 확인하세요. 맞지 않는 패키지를 강제로 설치하지 마세요. Clash Verge Rev 설치 후에는 시스템 프록시가 정상 작동하는지 확인한 다음 로그인 시 자동 실행을 설정하세요. 프록시가 필요한 앱이 시스템 프록시를 사용하지 않는 경우에 TUN 서비스를 고려하세요. 한 번에 하나씩 변경하고 문제가 생기면 가장 최근 변경을 되돌리세요.
2026-07-23 기준 Clash Verge Rev 최신 안정 버전 v2.5.2는 amd64, arm64, armhf용 DEB를 제공합니다. Ubuntu와 Debian에서는 패키지 관리자로 이 버전을 설치하거나 제거할 수 있으며 해당 Release에는 AppImage가 없습니다.
더 새 버전을 받을 때는 해당 릴리스 페이지의 실제 파일을 확인하고, 없는 형식을 제삼자 사이트에서 찾지 마세요.
아키텍처 매핑
| uname -m | DEB 파일 |
|---|---|
| x86_64 | *_amd64.deb |
| aarch64 / arm64 | *_arm64.deb |
| armv7l | *_armhf.deb, 시스템 자체가 32비트 ARM인지 먼저 확인 |
uname과 dpkg에 표시된 아키텍처는 DEB와 일치해야 합니다
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과 시스템 프록시만 확인
구성을 가져오고 시스템 프록시 확인하기
원격 구독 또는 로컬 구성 가져오기
Clash Verge Rev 2.x는 URL, 로컬 파일과 드래그 앤 드롭 가져오기를 지원합니다. 먼저 수동 업데이트하세요.
현재 Profile로 설정
정책 그룹과 노드가 이전 캐시가 아닌지 확인합니다.
노드 하나 고정
Rule 모드를 유지하고 시스템 프록시를 켭니다.
브라우저를 열고 연결 확인
도메인, 규칙과 외부 경로가 함께 나타나야 데스크톱 프록시가 정상입니다.
Profiles는 어느 디렉터리에 저장되고 터미널은 어떻게 프록시를 사용하나요?
브라우저는 되지만 apt나 Git이 시간 초과된다면 터미널이 데스크톱 시스템 프록시를 읽지 않는 경우가 많습니다. shell은 터미널 명령을 실행하는 환경으로 자체 프록시 변수가 필요합니다. 아래 설정은 현재 터미널에만 적용되며 테스트 후 해제할 수 있습니다.
Linux 기본 경로: 앱에서 열어 주는 디렉터리를 기준으로 확인하세요
| 내용 | 경로 |
|---|---|
| verge.yaml | ~/.local/share/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
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
export no_proxy="$NO_PROXY"
# 结束测试
# unset HTTP_PROXY HTTPS_PROXY NO_PROXY http_proxy https_proxy no_proxy로그인 자동 시작 후 Profile, 프록시와 종료 후 복구가 정상인가요?
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 -Ei 'clash.verge|clash-verge'자동 시작을 실제로 한 번 검증
먼저 로그아웃한 뒤 데스크톱에 다시 로그인
Clash Verge Rev 프로세스가 하나만 나타나고 기존 클라이언트가 함께 시작하지 않는지 확인합니다.
현재 Profile과 노드 확인
앱이 시작된 뒤에도 구독이 선택되어 있고 실행 구성이 방금 검증한 파일인지 확인해야 합니다.
시스템 프록시 확인
자동으로 켜도록 설정했다면 브라우저 요청이 연결 기록에 나타나야 합니다. 트래픽을 자동으로 처리하지 않으려면 스위치를 꺼 두세요.
종료 후 복구 테스트
앱 메뉴에서 정상적으로 종료하면 Ubuntu의 HTTP, HTTPS와 SOCKS 프록시가 더 이상 로컬 포트를 가리키지 않습니다.
TUN이 시작되지 않거나 트레이 아이콘이 보이지 않거나 창이 갑자기 닫히면 각각 어디를 확인해야 하나요?
TUN에는 서비스와 가상 네트워크 인터페이스 권한이 필요합니다. 시스템 프록시를 먼저 안정화한 뒤 현재 버전의 설정 페이지에서 서비스를 설치하세요. 이전 가이드의 서비스 스크립트와 설치 디렉터리는 달라졌을 수 있습니다. 권한 또는 IPC 오류가 발생하면 현재 Release와 공식 FAQ를 먼저 확인하고 다른 버전에서 남은 명령을 바로 실행하지 마세요.
트레이가 보이지 않는 현상은 대개 데스크톱 환경의 AppIndicator 지원 부족 때문입니다. 창이 즉시 종료된다면 터미널에서 앱을 시작해 stderr를 확인하세요. 두 문제 모두 구독 노드 품질과는 무관합니다.
두 번 클릭해도 창이 나타나지 않음
터미널에서 시작하고 WebKit/그래픽 라이브러리 오류를 보존한 뒤 현재 데스크톱 세션을 확인합니다.
브라우저는 되지만 apt/Git은 연결되지 않음
해당 명령에 환경 변수 또는 도구 구성을 설정하고 TUN부터 켜지 않습니다.
TUN 스위치가 즉시 꺼짐
서비스 설치와 권한을 확인하고 DNS와 노드를 반복해서 바꾸지 마세요.
종료 후 브라우저에서 인터넷을 사용할 수 없음
데스크톱 네트워크 설정에서 남은 프록시를 끄고 앱이 강제 종료되었는지 확인합니다.