미꾸라지 설치 방법

이 문서는 PC 용 미꾸라지 VPN 을 설치하는 방법에 대해 기술한 문서입니다. 아래의 목록을 살펴보셔서 자신의 환경에 맞는 섹션을 참고하시기 바랍니다.

프로그램 받기

최신 mudfish 배포판은 https://mudfish.net 의 "다운로드" 섹션에서 가능합니다. 현재 Linux 와 Mac OS X, Windows 를 위한 설치본을 배포하고 있습니다.

• Windows

  32 bit 와 64 bit (binary 는 32 비트, 드라이버는 64 비트) 용이 제공되며 지원되는 윈도우즈 버전은 다음과 같습니다.

  • Windows XP SP2 이후

  • Windows Vista SP2 이상, Windows 7

  • Windows 8 / 8.1 / 10 이상

    • WFP (Windows Filtering Platform) 드라이버 관련 (mudwfp_proxy) 부분의 경우, 최소 Windows 8 이상이어야 합니다.

• Mac OS X

  OS X 버전의 경우, 2 가지 버전을 제공하고 있습니다. Intel CPU 기반의 빌드의 경우, 10.15 (macOS Catalina) 기준으로 빌드된 버전이며, Apple M1 기반의 경우, 11.5 (macOS Big Sur) 기준으로 빌드가 되었습니다. 만약 현재 사용하고 계신 macOS 버전이 낮아 실행에 문제가 있을 경우, http://mudfish.net/releases/ 에 이전 버전으로 시도를 해보시기 바랍니다.

  다른 하위 OS X 버전 지원을 원하신다면 미꾸라지 포럼 https://forums.mudfish.net 으로 요청 바랍니다.

• Linux

  64 bit 용만 현재 제공되며 지원되는 리눅스 배포판은 다음과 같습니다. 혹여나 다른 배포판을 위한 package 를 원하신다면 미꾸라지 포럼 https://forums.mudfish.net 으로 요청 바랍니다.

  • Ubuntu 16.04 LTS 이상

사용하시는 OS 와 CPU 타입에 따라 알맞은 설치 파일을 다운로드 받으셔야 합니다.

설치하기

윈도우

받으신 설치 프로그램을 실행하시면 우선 첫 번째 화면으로 component 선택 화면을 보실 수 있습니다.

현재 두 개의 component 가 존재하며 각각은 다음과 같은 프로그램을 시스템에 설치합니다.

• Mudfish

  Core 파일들. 실제 데이타의 전송 및 가속을 해주는 모듈이 포함되어 있습니다. 추가적으로 crash reporting 을 위한 모듈이 함께 설치되게 됩니다.

• TAP-Win32 Adapter v9

  core 모듈과 함께 작동하는 가상 miniport adapter 입니다. 설치시 OpenVPN technology Inc. 에서 배포하는 tap0901 드라이버를 설치하게 됩니다.

다음 화면은 설치할 디렉토리를 선택하는 화면입니다. 이 설명서에는 mudfish 가 C:\Program Files\Mudfish Cloud VPN (64bit 머신에서는 C:\Program Files (x86)\Mudfish Cloud VPN) 에 설치되었다고 가정합니다.

폴더 선택이 끝났다면 이제 설치 버턴을 눌러주세요.

처음 TAP-Win32 Adapter v9 를 설치한다면 도중에 위 화면과 같은 경고창을 만나실 수 있습니다. "계속(C)" 버튼을 클릭하여 설치를 진행합니다.

만약 Windows 7/8/8.1/10 사용자의 경우 경고창이 뜰 수 있습니다.

"설치(I)."을 선택하셔서 설치를 계속해 주십시오.

설치가 모두 끝났습니다.

Mac OS X

다운로드 페이지를 통해서 Mac OS X 용 미꾸라지를 패키지를 다운로드 받으셨다고 가정하겠습니다. 패키지 확장자는 .dmg 입니다. 해당 파일을 더블 클릭하시면 해당 파일이 운영체제에 마운트 되면서 미꾸라지 프로그램을 보실 수 있으실 겁니다.

다른 Mac OS X 설치 패키지와 마찬가지로 미꾸라지 아이콘을 Applications 폴더로 복사하시면 됩니다.

경고 (WARNING)

.dmg 패키지 내에서 단순히 미꾸라지를 실행하는 것은 작동되지 않기 때문에 반드시 Applications 폴더에 설치해 주신 후 응용 프로그램에서 미꾸라지를 실행해 주셔야 합니다.

리눅스

다운로드 페이지를 통해서 리눅스용 미꾸라지를 패키지를 다운로드 받으셨다고 가정하겠습니다. 패키지 확장자는 .sh 입니다. 아래는 버전 v4.5.1 을 다운로드 받으셨다는 가정하에 작성된 설치 예제입니다.

$ wget https://mudfish.net/releases/mudfish-5.8.8-linux-x86_64.sh
$ sudo sh mudfish-5.8.8-linux-x86_64.sh
Verifying archive integrity... All good.
Uncompressing Mudfish Cloud VPN v5.8.8......
Installation is done under /opt/mudfish/5.8.8.
$ ls -l /opt/mudfish/5.8.8/bin/

리눅스용 미꾸라지의 경우 총 3 개의 executable binary 로 구성되어 있으며 설치 위치는 항상 /opt/mudfish/$(VERSION)/bin/ 에 됩니다. 만약 여러 버전의 패키지가 설치된다면 버전 마다 각각 다른 디렉토리가 사용됩니다.