Muddog 설치 및 업데이트
지원 환경
다운로드 페이지에서 운영체제와 버전을 확인한 뒤 설치 파일을 받으세요.
| 운영체제 | 제공 형태와 사용 안내 |
|---|---|
| Linux x86_64 | .deb 및 .rpm 패키지. systemd를 사용하는 데스크톱 환경이 필요합니다. |
| Windows 10/11 x64 | .msi 설치 파일. 현재 Windows 패키지는 x64만 지원합니다. |
| macOS 13 Ventura 이상 | .dmg 설치 파일. Universal 패키지는 Intel과 Apple Silicon을 모두 지원합니다. 앱 제어에는 macOS 관리자 계정이 필요합니다. |
Linux 설치 관리자는 앱 실행에 필요한 라이브러리와 의존 패키지를 함께 설치합니다. Linux의 앱별 VPN에는 추가로 systemd 사용자 세션과 cgroup v2가 필요하며, nftables는 패키지 의존성에 포함되어 있습니다. Windows도 앱별 VPN을 지원하며, macOS는 전체 인터넷과 IP·대역별 VPN을 지원합니다.
이 설명서는 2.x용입니다. 다운로드 페이지에 해당 운영체제의 2.x 파 일이
아직 표시되지 않는다면 배포 여부를 먼저 확인하세요. Windows용 1.0.7의
.exe 파일은 기존 버전 안내를 따릅니다.
Linux와 Windows는 설치가 끝나면, macOS는 첫 실행과 백그라운드 서비스 승인 후 인터넷 공유가 자동으로 시작됩니다. 이후에는 부팅할 때도 서비스가 실행되므로 앱 창을 열지 않아도 다른 사용자가 내 인터넷 회선을 이용할 수 있습니다. 설치 전에 인터넷 공유 관리를 확인하세요.
Linux에 설치하기
아래 명령은 2.0.0 파일명 예시입니다. 터미널에서 다운로드한 파일이 있는 디렉터리로 이동하고, 파일명을 실제로 받은 패키지 이름으로 바꿔 실행하세요. 설치에는 관리자 권한이 필요합니다.
Debian / Ubuntu
sudo apt install ./muddog_2.0.0_amd64.deb
Fedora
sudo dnf install ./muddog-2.0.0-1.x86_64.rpm
설치 후 처음 실행
- 설치를 마치면 데스크톱에서 로그아웃했다가 다시 로그인합니다.
- 앱 메뉴에서 Muddog을 실행합니다.
- 연결 화면에 VPN 상태와 내 인터넷 공유 상태가 표시되는지 확인합니다.
- VPN 연결하기에 따라 국가를 고르고 연결합니다.
일반 사용자 계정에서 sudo로 설치하면 해당 사용자가 muddog 그룹에
추가됩니다. 다시 로그인해야 이 권한이 앱에 반영됩니다. 앱은 일반 사용자로
실행하며, VPN 사용을 위해 미꾸라지 ID나 비밀번호를 입력하지 않습니다.
관리자가 다른 계정으로 설치했거나 여러 사용자가 앱을 제어해야 한다면 서비스 접근 권한 확인을 참고하세요.
Windows에 설치하기
- 이전
.exe설치 프로그램으로 설치한 Muddog이 있다면 Windows의 설정 → 앱에서 먼저 제거합니다. 기존 설치본을 제거하라는 안내가 나오면 제거를 마친 뒤 MSI 설치를 다시 진행하세요. - 다운로드한
.msi파일을 실행하고 관리자 권한 요청을 승인합니다. - 설치 안내에 따라 진행합니다. WebView2 Runtime이 없으면 설치 도우미가 인터넷에서 내려받으므로 인터넷 연결이 필요합니다.
- 시작 메뉴나 바탕 화면의 muddog을 일반 사용자 권한으로 실행합니다.
- 연결 화면에서 서비스 상태를 확인하고 VPN 연결하기를 진행합니다.
기본 설치 위치는 %ProgramFiles%\muddog입니다. 설치 프로그램은
muddog-engine 서비스를 등록하고 자동으로 시작하며, 엔진에 필요한 UDP 수신
방화벽 규칙도 추가합니다. VPN과 앱별 VPN에 필요한 구성 요소는 패키지에 포함됩니다.
앱을 사용할 때마다 관리자 권한으로 실행할 필요는 없습니다.
macOS에 설치하기
- 다운로드한
.dmg파일을 엽니다. - Muddog.app을 응용 프로그램(
/Applications) 폴더에 복사합니다. DMG 안에서 바로 실행하면 백그라운드 서비스를 등록할 수 없습니다. - macOS의 관리자 계정으로 로그인한 상태에서 복사한 Muddog을 실행합니다.
- 시스템 설정 → 일반 → 로그인 항목 및 확장 프로그램에서 Muddog의 백그라운드 실행을 승인합니다. macOS 버전에 따라 항목 이름은 다를 수 있습니다.
- 앱이 서비스에 다시 연결되면 VPN 연결하기를 진행합니다.
승인 화면을 다시 열려면 macOS 메뉴 막대의
**Service → Background Service Settings…**를 선택합니다. 서비스 등록이
필요하면 Service → Enable Background Service를 선택하세요.
이 메뉴 이름은 영어로 표시됩니다. 앱 자체는 sudo 없이 실행합니다.
업데이트하기
VPN을 사용 중이라면 연결 해제를 누르고, 다운로드 페이지에서 운영체제에 맞는 새 설치 파일을 받습니다.
- Linux: 앱을 닫고 위 설치 명령에 새
.deb또는.rpm파일명을 지정해 설치합니다. - Windows: 앱을 닫고 새
.msi파일을 실행합니다. 기존 MSI 설치본은 업데이트 과정에서 교체됩니다. - macOS: 먼저 Service → Remove Background Service and Quit으로
서비스를 제거하고 앱을 종료합니다. 새 DMG의 Muddog.app으로
/Applications의 앱을 교체한 뒤 다시 실행하고 필요한 서비스 승인을 완료합니다.
업데이트 과정에서 진행 중인 VPN과 공유 연결이 끊어집니다. 업데이트 후 앱을 다시 열고 연결과 공유 상태를 확인하세요. 앱과 서비스가 서로 다른 버전이라는 오류가 나오면 문제 해결을 확인하세요.
Linux의 기존 1.0.7에서 바꾸는 경우에는 이전 앱을 닫고 새 패키지를
설치하세요. 설치 프로그램은 기존 muddog_srv.service가 등록되어 있으면
중지하고 자동 실행을 해제합니다. 이후에는 앱 메뉴의 Muddog을 실행합니다.
제거하기
Linux
Debian / Ubuntu에서는 다음 명령을 사용합니다.
sudo apt remove muddog
Fedora에서는 다음 명령을 사용합니다.
sudo dnf remove muddog
패키지를 제거하면 서비스와 VPN이 종료되고 Muddog이 추가한 네트워크 경로가
정리됩니다. Debian / Ubuntu에서 전용 서비스 계정과 그룹도 제거하려면
일반 제거 대신 sudo apt purge muddog를 사용할 수 있습니다.
Windows
Windows의 설정 → 앱에서 muddog을 선택해 제거합니다. 제거 과정에서 서비스와 VPN을 종료하고 VPN 경로를 정리한 뒤 서비스와 설치 시 추가한 방화벽 규칙을 삭제합니다. 사용자 설정과 접속·중계 기록은 보관합니다.
macOS
- 앱의 Service → Remove Background Service and Quit을 선택합니다.
- 서비스 제거와 앱 종료가 완료되면
/Applications의 Muddog.app을 휴지통으로 옮깁니다.
앱 파일만 먼저 삭제하면 백그라운드 항목 정리가 늦어질 수 있습니다. 사용자 설정과 접속·중계 기록은 보관합니다.
남은 기록과 공유 중지
패키지 제거와 접속·중계 기록 삭제는 별개입니다. 남아 있는 로컬 기록의 위치와 보관 방식은 접속·중계 기록을 참고하세요. 프로그램을 유지하면서 공유만 중지하려면 서비스 중지를 이용할 수 있지만, 서비스가 중지된 동안에는 내 VPN도 사용할 수 없습니다.