Linux 배포판에서 Happ 설치 및 설정

Linux에 Happ 설치하기: AppImage와 .deb

Happ 데스크톱 빌드는 GitHub의 Happ-proxy 저장소 Releases 섹션에서 배포됩니다. 대부분의 배포판에서는 범용 형식인 AppImage가 더 편리합니다. 설치가 필요 없고 어느 폴더에서든 실행할 수 있기 때문입니다. Debian과 Ubuntu 계열을 위해서는 별도의 .deb 패키지가 제공됩니다.

자신의 아키텍처(보통 x86_64)에 맞는 최신 파일을 내려받고 AppImage를 실행 가능하게 만든 뒤 실행하세요: `chmod +x Happ-x86_64.AppImage` 그리고 `./Happ-x86_64.AppImage`. .deb의 경우 `sudo apt install ./happ_amd64.deb`를 사용하면 패키지 관리자가 의존성을 자동으로 처리합니다.

AppImage가 시작되지 않는다면 대부분 FUSE 라이브러리가 없는 경우입니다. `sudo apt install libfuse2`(Debian/Ubuntu) 명령이나 사용 중인 배포판에 맞는 방법으로 설치하세요. 대안으로 AppImage를 압축 해제하여 직접 실행할 수도 있습니다: `./Happ-x86_64.AppImage --appimage-extract` 후 `./squashfs-root/AppRun`.

구독 및 구성 가져오기

서버 접속 권한은 서비스의 Telegram 봇이 제공합니다. 그곳에서 체험용, 유료 또는 공식 키를 활성화하면 https://…/sub/… 형태의 구독 링크를 받게 됩니다. 이 링크에는 최신 서버 목록과 Xray 파라미터가 담겨 있어 구성을 수동으로 입력할 필요가 없습니다.

앱에서 구성 추가를 열고 구독 링크를 붙여넣은 뒤 저장하세요. Happ가 사용 가능한 모든 서버를 하나의 목록으로 불러오며, 이후에도 같은 링크로 갱신합니다. 서버가 변경되거나 새로운 위치가 추가되면 구독 갱신 버튼만 누르면 되고, 재설치는 필요하지 않습니다.

필요하다면 단일 구성도 추가할 수 있습니다. 봇에서 vless:// 또는 ss:// 문자열을 복사하여 클립보드 가져오기를 통해 붙여넣으세요. 동일한 키가 모든 기기에서 동작하므로 Linux, Windows, 모바일 클라이언트의 구독이 서로 일치합니다.

Xray 코어에서 프록시 모드 실행

가져오기가 끝나면 목록에서 서버를 선택하고 연결을 켜세요. Happ는 Xray 코어에서 로컬 프록시(SOCKS 및 HTTP)를 띄우고 그것을 통해 트래픽을 라우팅합니다. 시스템 모드에서는 클라이언트가 데스크톱 환경 설정에 프록시를 등록하므로, 브라우저와 대부분의 애플리케이션이 추가 설정 없이 터널을 통해 동작하기 시작합니다.

로컬 프록시 포트는 앱 설정에서 수동으로 지정할 수 있습니다. 특정 프로그램만 Happ로 보내야 할 때 유용합니다. 브라우저의 프록시 설정이나 환경 변수(예: `export https_proxy=http://127.0.0.1:PORT`)에 주소 127.0.0.1과 지정한 포트를 입력하고, 나머지 트래픽은 직접 연결로 남겨두세요.

트래픽을 세밀하게 분리하려면 Happ에는 목록 기반 라우팅과 split tunneling이 있습니다. 어떤 도메인과 애플리케이션이 프록시를 거치고 어떤 것이 우회할지 지정할 수 있습니다. 규칙과 utility에 대한 자세한 설명은 기본 설치와 정교한 경로 설정을 섞지 않도록 사이트의 별도 섹션으로 분리했습니다.

시스템 시작 시 Happ 자동 실행

프록시가 자동으로 켜지도록 하려면 클라이언트를 데스크톱 환경의 자동 시작 항목에 추가하세요. `~/.config/autostart/happ.desktop` 파일을 만들고 `[Desktop Entry]`, `Type=Application`, `Exec=/전체/경로/Happ-x86_64.AppImage`, `X-GNOME-Autostart-enabled=true` 줄을 넣으세요. GNOME, KDE 및 대부분의 환경이 다음 로그인 시 이를 인식합니다.

.deb 설치의 경우 자동 시작 항목을 앱 설정에서 직접 켜거나 사용 중인 환경의 자동 시작 메뉴를 통해 켤 수 있으며, 실행 파일 경로가 자동으로 입력됩니다. 로그인 후 Happ는 시스템 트레이로 최소화되어 시계 옆 아이콘에서 접근할 수 있습니다.

그래픽 셸 없이 Linux를 운영한다면 실행을 systemd 사용자 서비스로 구성하세요: unit 파일을 `~/.config/systemd/user/`에 넣고 `ExecStart`에 AppImage 경로를 지정한 뒤 `systemctl --user enable --now happ.service` 명령으로 자동 시작을 활성화하세요.

연결 확인 및 진단

연결 후 트래픽이 서버를 거치는지 확인하세요: IP 확인 서비스를 아무거나 열어보면 주소와 국가가 선택한 위치와 일치해야 합니다. IP가 그대로라면 시스템 프록시가 켜져 있는지, 앱이 올바른 로컬 포트를 읽고 있는지 확인하세요.

끊김이 발생하거나 속도가 느리면 구독 목록에서 서버를 바꿔보세요. 인접한 위치가 더 안정적인 경로를 제공하는 경우가 많습니다. 그런 다음 구독을 갱신하여 최신 Xray 파라미터를 받고 연결을 재시작하세요. 때로는 로컬 방화벽이 방해가 되니, ufw나 firewalld에서 Happ의 아웃바운드 연결을 허용하세요.

클라이언트 업데이트 후 서버 목록이 불러와지지 않으면 Telegram 봇에서 키의 유효 기간과 구독 링크의 정확성을 확인하세요. 연결 로그는 앱 안에서 확인할 수 있으며, 키 문제인지 네트워크 차단인지 구분하는 데 도움이 됩니다.