Muddog 문제 해결

먼저 연결 화면에서 내 VPN 연결과 내 인터넷 공유 중 어느 쪽에 문제가 있는지 확인하세요. 각각의 연결 상세, 또는 오류 알림의 오류 상세에 원인이 표시됩니다.

증상	확인할 내용
서비스에 연결할 수 없음	서비스 상태와 접근 권한
국가 목록이 비거나 연결 실패	국가와 상대 연결
연결됨인데 IP가 그대로이거나 접속 안 됨	VPN 사용 범위와 트래픽
앱 실행 버튼을 누를 수 없거나 특정 앱만 적용 안 됨	앱별 VPN
서비스가 기능을 지원하지 않는다는 오류	앱과 서비스 버전
내 인터넷 공유만 실패	공유와 기록 저장

서비스에 연결할 수 없음

앱은 백그라운드 서비스의 상태를 읽어 화면에 표시합니다. 이 메시지는 앱에서 상태를 확인할 수 없다는 뜻이며, VPN이나 공유가 확실히 꺼졌다는 의미는 아닙니다.

서비스가 정상으로 돌아오면 앱은 자동으로 다시 접속합니다. 아래에서 운영체제에 맞는 상태와 권한을 확인하세요. 서비스를 시작하면 인터넷 공유도 함께 시작됩니다.

Linux

1. 설치 직후라면 데스크톱에서 로그아웃했다가 다시 로그인하고 앱을 엽니다.

2. 터미널에서 서비스 상태를 확인합니다.

   systemctl status muddog-engine.service --no-pager

3. 서비스가 중지되어 있고 VPN과 공유를 다시 사용하려면 시작합니다. 시작과 함께 인터넷 공유도 재개됩니다.

   sudo systemctl start muddog-engine.service

4. 서비스는 실행 중인데 앱이 접근하지 못한다면, 앱을 사용하는 계정의 터미널에서 id -nG를 실행해 muddog 그룹이 있는지 확인합니다.

관리자가 다른 계정으로 설치해 그룹이 빠진 경우에는 앱을 사용할 일반 사용자로 로그인한 터미널에서 다음 명령을 실행하세요. 이후 데스크톱에서 로그아웃했다가 다시 로그인해야 합니다.

sudo usermod -aG muddog "$(id -un)"

앱을 관리자 권한으로 실행하는 것으로 대신하지 마세요. 서비스 자체가 시작되지 않으면 다음 명령으로 최근 오류를 확인할 수 있습니다.

sudo journalctl -u muddog-engine.service -n 100 --no-pager

Windows

PowerShell에서 서비스 상태를 확인합니다.

Get-Service -Name muddog-engine

서비스가 중지되어 있다면 관리자 권한으로 실행한 PowerShell에서 시작합니다.

Start-Service -Name muddog-engine

서비스를 사용 안 함으로 설정했다면 자동 실행을 다시 켜는 방법을 따르세요. 서비스가 없거나 필요한 파일이 누락되었다면 최신 MSI로 설치 또는 복구합니다. 앱은 일반 사용자 권한으로 실행합니다.

macOS

1. macOS 13 이상인지, Muddog.app을 /Applications에 복사했는지 확인합니다.
2. 현재 로그인한 계정이 macOS 관리자 계정인지 확인합니다.
3. Service → Enable Background Service로 서비스 등록을 요청합니다.
4. **Service → Background Service Settings…**에서 Muddog의 백그라운드 실행을 승인합니다. 승인 뒤 앱이 서비스에 다시 연결될 때까지 기다립니다.

터미널에서 등록된 서비스 상태를 확인할 수도 있습니다.

sudo launchctl print system/net.3rocks.muddog.engine

앱을 DMG 안이나 다른 폴더에서 실행하면 서비스를 등록할 수 없습니다. 기존 앱을 교체한 뒤 문제가 생겼다면 macOS 업데이트 절차에 따라 서비스를 제거한 뒤 앱을 다시 실행하세요.

위 절차를 따라도 계속 실패하면 문제 보고에 서비스 오류 내용을 함께 적으세요.

국가 목록이 비거나 연결에 실패함

1. 일반 인터넷 접속이 되는지 확인합니다.
2. 연결 국가 → 목록 새로고침을 누릅니다.
3. 선택한 국가가 목록에서 사라졌다면 자동 선택이나 다른 국가로 연결합니다.
4. 연결 서버 설정을 바꾼 적이 있다면 고급 설정의 기본값을 복원하고 저장합니다.
5. 계속 실패하면 연결 상세를 확인합니다.

P2P 연결은 선택한 국가의 참여자와 양쪽 네트워크 상태에 영향을 받습니다. 국가가 표시되더라도 연결이 보장되지는 않습니다. 이용 가능한 상대가 없으면 잠시 후 다시 시도하거나 다른 국가를 선택하세요. 방화벽이나 공유기의 통신 제한이 원인인지 확인하려면 사용 가능한 다른 인터넷 회선에서도 비교해 볼 수 있습니다.

최대 10회는 연결 시도 한도입니다. 상대를 찾지 못하면 그 전에 끝날 수 있으며, 이미 연결된 VPN이 끊긴 뒤에는 직접 다시 연결해야 합니다.

연결됨인데 IP가 그대로이거나 접속이 안 됨

1. 연결 → 현재 연결 범위가 의도한 모드인지 확인합니다. 설정만 저장하고 재연결하지 않았다면 이전 범위가 계속 적용됩니다.
2. IP·대역 모드라면 접속하려는 목적지 IP가 목록에 포함되거나 제외되어 있는지 확인합니다. 도메인 이름은 주소 목록에 넣을 수 없습니다.
3. 앱별 모드라면 앱을 완전히 종료한 뒤 Muddog에서 다시 실행합니다.
4. 확인하려는 접속이 IPv6인지 확인합니다. IPv6는 VPN을 통과하지 않으며, Windows 앱별 모드에서는 선택한 앱의 IPv6 통신을 차단합니다.
5. 다른 VPN이나 네트워크 관리 도구를 함께 사용 중이라면 해당 연결을 해제한 상태에서도 비교합니다. 다른 도구가 설정한 경로가 먼저 적용될 수 있습니다.

IP 확인용 브라우저나 확인 페이지가 VPN 적용 대상이 아니라면 기존 회선의 IP가 보이는 것이 정상입니다. DNS도 사용하는 모드와 DNS 서버의 IP에 따라 기존 회선을 사용할 수 있습니다.

특정 웹사이트의 국가 제한이 계속되면 다른 국가나 다른 연결 상대에서도 확인하세요. Muddog은 해당 서비스의 접속 허용 여부나 특정 속도를 보장하지 않습니다.

macOS에서 Wi-Fi 등 사용 중인 회선을 바꿨다면 VPN을 해제하고 다시 연결하세요. IP 포함 모드에서 다른 프로그램이 설정한 호스트 경로와 충돌한다는 오류가 나오면 해당 프로그램의 연결과 지정한 IP·대역을 확인하세요.

앱별 VPN이 적용되지 않음

• macOS에서는 앱별 VPN을 지원하지 않습니다. 전체 인터넷 또는 IP·대역 모드를 사용하세요.
• VPN으로 실행이 비활성화되어 있다면 앱별 모드로 저장했는지, 그 모드로 VPN에 연결되었는지, 실행할 앱을 선택했는지 확인합니다.
• 앱 목록이 비어 있으면 목록 새로고침 또는 실행 파일 찾기를 사용합니다.
• 브라우저가 기존 창만 다시 열면 백그라운드 프로세스까지 종료한 뒤 실행합니다.
• 별도 서비스로 실행을 넘기거나 기존 인스턴스를 재사용하는 앱은 지원하지 않습니다. 설치 방식과 앱별 VPN의 사용 조건을 확인하세요.
• Linux에서 Snap·Flatpak 앱은 지원하지 않습니다. systemd 사용자 세션, cgroup v2 또는 nftables 관련 오류라면 해당 환경을 확인하고 오류 상세를 문제 보고에 포함하세요.
• Windows에서는 실행할 .exe 파일을 선택해야 하며, VPN 재연결 뒤에는 프로그램을 완전히 종료하고 Muddog에서 다시 실행해야 합니다.
• Windows에서 WinDivert 구성 요소가 없거나 로드할 수 없다는 오류가 나오면 MSI로 복구 또는 재설치합니다. 계속 실패하면 오류 상세를 보고하세요.

앱과 서비스의 버전이 다름

앱에서 요청한 기능을 지원하지 않는 구버전 서비스에 연결하면 오류가 발생합니다. 새 패키지로 앱과 서비스를 함께 업데이트하세요. macOS에서 앱별 VPN을 사용할 수 없는 것은 버전 오류가 아닌 지원 범위의 차이입니다.

업데이트했는데도 같은 오류가 남으면 운영체제에 맞게 서비스를 재시작합니다. 재시작하면 진행 중인 개인 VPN과 공유 연결이 끊어집니다.

Linux에서는 앱을 닫고 다음 명령을 실행한 뒤 앱을 다시 엽니다.

sudo systemctl restart muddog-engine.service

Windows에서는 앱을 닫고 관리자 PowerShell에서 다음 명령을 실행한 뒤 앱을 다시 엽니다.

Restart-Service -Name muddog-engine

macOS에서는 Service → Remove Background Service and Quit을 선택한 뒤 /Applications의 Muddog을 다시 실행하고 필요한 서비스 승인을 완료합니다.

서비스 재시작 후에는 VPN을 다시 연결해야 합니다. 오류가 계속되면 재시작을 반복하기보다 앱 버전과 오류 상세를 정리해 보고하세요.

인터넷 공유만 실패하거나 기록을 읽지 못함

내 인터넷 공유 → 연결 상세를 먼저 확인하세요. 기록 저장 공간 부족, 저장 한도 초과 또는 파일 쓰기 오류가 있으면 공유가 중단됩니다. 기록은 로컬 보관 방식에 따라 저장됩니다.

디스크 공간과 서비스 로그를 확인하세요. 보관 중인 기록이 필요한 상황이라면 오류를 없애기 위해 무작정 삭제하지 말고, 오류 메시지와 함께 지원을 요청하세요.

기록 조회만 실패한다면 서비스 접근 권한과 버전을 확인합니다. 날짜별 기록이 정리되어 조회 도중 내용이 바뀌었다면 날짜와 조건을 다시 선택해 조회를 누릅니다. 조회가 성공했지만 결과가 비어 있다면 UTC 날짜, 필터와 다음 기록을 확인하세요.