본문으로 건너뛰기

미꾸라지 OVA 설치

가상 머신용 미꾸라지 Cloud VPN 은 OpenWRT 펌웨어로 구성되어 있으며, x86_64 아키텍쳐 기반입니다. 기본적으로 미꾸라지 Core 패키지와 Luci 웹 인터페이스를 위한 미꾸라지 UI 패키지가 설치되어 있습니다.

지원되는 가상 머신​

현재 아래의 가상 머신을 공식적으로 지원합니다.

OVA 설치 방법​

가상 머신에 미꾸라지를 설치하기 위해서는 우선 다음의 경로에서 OVA 파일을 다운로드 받으셔야 합니다.

Oracle VM VirtualBox​

OVA 이미지 Import 하기​

다음과 같은 순서로 OVA 파일을 import 하시면 됩니다.

  1. VirtualBox 를 실행합니다.

  2. 'File -> Import appliance' 메뉴를 클릭하고, Source 탭에서 위에서 다운로드 받은 OVA 파일의 위치를 지정합니다.

  3. 그러면 기본적인 가상 머신 구성이 보이실 것입니다. 거기에서 중요한 부분은 'Mac Address Policy' 입니다. 해당 옵션 중 다음을 선택하여 주시기 바랍니다.

    • Include all network adapter MAC addresses

  4. 그런 후 Import 합니다. 그러면 'OpenWRT with Mudfish <version>' 과 같은 VM 이 생성이 되셨을 것입니다.

축하합니다! 미꾸라지 VM 설치가 성공적으로 완료되었습니다. 이 시점에서 체크해야 하는 체크리스트는 다음과 같습니다.

체크 리스트

  • 'OpenWRT with Mudfish <version>' 의 Settings 메뉴를 열고, Network 탭으로 이동합니다.

  • Adapter 1 의 상태는 다음과 같아야 합니다.

    • Enable Network Adapter 가 체크되어 있어야 합니다.

    • Attached to 는 Host-only Adapter 여야 합니다.

    • Name 은 보통 vboxnet0 여야 합니다. 만약 아무런 이름을 찾을 수 없다면, VirtualBox 윈도우에서 'File -> Host Network Manager' 메뉴에서 생성하시면 됩니다. 현재 미꾸라지 OVA 이미지의 경우, vboxnet0 가 다음과 같은 설정이라고 가정을 하고 있습니다.

      • Name: vboxnet0
      • IPv4 Address/Mask: 192.168.56.1/24
      • DHCP Server: Enabled

  • Adpater 2 의 상태는 다음과 같아야 합니다.

    • Enable Network Adapter 가 체크되어 있어야 합니다.
    • Attached to 는 Bridged Adapter 여야 합니다.
    • Name 은 현재 인터넷선이 물려있는 네트워크 카드 이름이여야 합니다.

이 VM 를 실행하고 약 10 ~ 15 초가 흘렀을 때, VM 콘솔에서 Enter 키를 눌렀을 때, console 작업을 하실 수 있습니다.

Luci UI 접속 및 미꾸라지 설정​

Host 머신상에서 브라우저를 열고, http://192.168.56.2 로 접속하시면 됩니다. 접속 Root 암호는 없습니다.

만약 SSH 접속을 원할 경우, ssh root@192.168.56.2 로 접속하시면 console 작업을 할 수 있습니다.

가상 머신 상에서 동작하는 미꾸라지 UI 에 접속하기 위해서는 웹 Luch UI 접속 후, "서비스 -> Mudfish" 메뉴에 접속하시면 됩니다. 보통 http://192.168.56.2:8282 에 미꾸라지가 실행되고 있습니다. 해당 메뉴를 통해서 OpenWRT 상의 미꾸라지를 세팅하실 수 있습니다. ipTIME 미꾸라지 공유기 사용에 익숙하시다면, 쉽게 설정하실 수 있으실 것입니다.

Default Gateway 변경하기​

이제 가상 머신 상에 있는 OpenWRT with Mudfish 로 트래픽을 redirection 시킬 차례 입니다.

1회성으로 한번만 변경하고자 한다면 다음과 같이 설정하시면 됩니다. 즉, 컴퓨터를 재부팅하면 기존 설정이 원복되게 됩니다.

가상 머신에서 OpenWRT with Mudfish 가 실행되고 있어야 합니다.

  1. "명령 프롬프트"를 관리자 권한으로 실행합니다.

  2. ROUTE DELETE 0.0.0.0 으로 기존 경로를 삭제합니다.

  3. ROUTE ADD 0.0.0.0 MASK 0.0.0.0 192.168.56.2 METRIC 1 명령어로 새로운 default gateway 를 추가합니다.

  4. 이제 ping 192.168.56.2 로 핑이 제대로 전달되는지 확인합니다.

VMware Workstation 16 Player​

다음과 같은 순서로 OVA 파일을 import 하시면 됩니다.

  1. VMware Workstation 16 Player 를 실행합니다. "Open a Virtual Machine" 메뉴를 클릭한 후, 위에서 받은 미꾸라지 OVA 파일을 지정합니다.

  2. 'Import Virtual Machine' 창이 뜬다면, 다음과 같은 정보를 입력하고, Import 버튼을 클릭해 줍니다.

    • "Name for the new virtual machine" 에 OpenWRT with Mudfish 를 입력

    • "Storage path for the new virtual machine" 의 경우, 위의 항목 입력시, 자동으로 완성됩니다.

  3. 만약 "The import failed because ... did not pass OVF specification..." 와 같은 메세지가 나타난다면, Retry 버튼을 클릭합니다.

  4. 문제가 없다면, 성공적으로 Import 되었음을 확인하실 수 있습니다.

    체크 리스트

    • 'OpenWRT with Mudfish' 항목을 선택하신 후, 'Edit virtual machine settings' 메뉴를 클릭하여, 설정 화면을 엽니다.

    • Network Adapter 의 상태는 다음과 같아야 합니다.

      • Connect at power on 가 체크되어 있어야 합니다.

      • Network connection 는 Host-only 여야 합니다. 보통 이를 지정하게 되면, VMNet1 장치가 연동되게 됩니다.

        그리고 보통 VMNet1 의 경우, Host-only IP 가 192.168.139.1 로 설정되어 있습니다.

    • Network Adapter 2 의 상태는 다음과 같아야 합니다.

      • Connect at power on 가 체크되어 있어야 합니다.
      • Network connection 는 Bridged 여야 합니다.
      • 중요한 부분은 "Configure Adapters" 버튼을 클릭하여, 반드시 인터넷선이 물려 있는 네트워크 장치를 선택하고, 나머지는 선택을 해제합니다.

  5. 이제 OpenWRT with Mudfish 이미지를 부팅합니다. 약 8 ~ 10 초 정도가 흐른 후, 화면상에서 Enter 키를 누를 경우, 콘솔로 접속이 됩니다.

  6. 마지막으로 내부 LAN IP 를 변경해 줘야 합니다. 다음과 같이 입력합니다. 이 명령어는 내부 LAN IP 를 192.168.139.2 으로 변경하는 명령어들입니다.

    uci set network.lan.ipaddr='192.168.139.2'
    uci commit
    reboot

  7. 재부팅이 제대로 되었다면, 이제 브라우저를 열고 http://192.168.139.2 로 접속을 합니다.

Luci UI 접속 및 미꾸라지 설정​

Host 머신상에서 브라우저를 열고, http://192.168.139.2 로 접속하시면 됩니다. 접속 Root 암호는 없습니다.

만약 SSH 접속을 원할 경우, ssh root@192.168.139.2 로 접속하시면 console 작업을 할 수 있습니다.

가상 머신 상에서 동작하는 미꾸라지 UI 에 접속하기 위해서는 웹 Luch UI 접속 후, "서비스 -> Mudfish" 메뉴에 접속하시면 됩니다. 보통 http://192.168.139.2:8282 에 미꾸라지가 실행되고 있습니다. 해당 메뉴를 통해서 OpenWRT 상의 미꾸라지를 세팅하실 수 있습니다. ipTIME 미꾸라지 공유기 사용에 익숙하시다면, 쉽게 설정하실 수 있으실 것입니다.

Default Gateway 변경하기​

이제 가상 머신 상에 있는 OpenWRT with Mudfish 로 트래픽을 redirection 시킬 차례 입니다.

1회성으로 한번만 변경하고자 한다면 다음과 같이 설정하시면 됩니다. 즉, 컴퓨터를 재부팅하면 기존 설정이 원복되게 됩니다.

가상 머신에서 OpenWRT with Mudfish 가 실행되고 있어야 합니다.

  1. "명령 프롬프트"를 관리자 권한으로 실행합니다.

  2. ROUTE DELETE 0.0.0.0 으로 기존 경로를 삭제합니다.

  3. ROUTE ADD 0.0.0.0 MASK 0.0.0.0 192.168.139.2 METRIC 1 명령어로 새로운 default gateway 를 추가합니다.

  4. 이제 ping 192.168.139.2 로 핑이 제대로 전달되는지 확인합니다.