미꾸라지 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" 버튼을 클릭하여, 반드시 인터넷선이 물려 있는 네트워크 장치를 선택하고, 나머지는 선택을 해제합니다.

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

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

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

  3. 재부팅이 제대로 되었다면, 이제 브라우저를 열고 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 로 핑이 제대로 전달되는지 확인합니다.

← 주의사항