설치 방법 (공유기)

공유기 용 미꾸라지 Cloud VPN 은 OpenWRT 기반의 패키지들로 구성되어 있는데, 미꾸라지 Core 패키지와 Luci 웹 인터페이스를 위한 미꾸라지 UI 패키지가 그것입니다.

아래의 목록을 살펴보셔서 자신의 환경에 맞는 섹션을 참고하시기 바랍니다.

설치

지원되는 OpenWRT 버전

현재 아래의 OpenWRT 버전을 공식적으로 지원합니다.

  • 18.06.1
  • 15.05.1 (Chaos Calmer)

지원되는 공유기

현재 미꾸라지가 제대로 동작된다고 확인된 공유기 목록으로는 다음과 같은 것이 있습니다.

의존하는 패키지

미꾸라지 프로그램이 공유기에서 제대로 동작하기 위해서는 다음과 같은 패키지의 설치가 필요합니다.

  • ip

    미꾸라지 아이템의 라우팅 테이블 세팅에 사용됩니다.

  • kmod-tun: tun(4) 드라이버

  • libopenssl

  • libpthread

  • librt

  • zlib

자신의 공유기에 맞는 개별 패키지들은 모두 https://downloads.openwrt.org/ 링크에서 찾으실 수 있으며 미꾸라지 패키지 설치전에 미리 설치하셔야 합니다. 각 공유기에 대한 링크는 각각 다음과 같습니다.

Luci 웹 인터페이스 설치

만약 ssh 를 통한 설정보다 Luci 웹 인터페이스를 통한 설정을 원하실 경우, Luci 패키지를 설치하실 수 있습니다. 아래와 같이 패키지를 설치하시면 브라우저를 이용하여 공유기 설정을 하실 수 있습니다.

# opkg update
# opkg install luci
# opkg install luci-i18n-base-ko

opkg 를 이용한 미꾸라지 설치

opkg 명령어 사용법 문서를 참조하여 미꾸라지 패키지를 설치할 수 있으며 https://mudfish.net/releases/openwrt/ 링크에서 현재 릴리즈된 미꾸라지 패키지 정보를 확인하실 수 있습니다.

Note

만약 미꾸라지 패키지가 기존에 설치되어 있다면 아래의 명령으로 먼저 삭제를 하신 후 설치를 진행하십시오.

# opkg remove mudfish-pi

미꾸라지 패키지를 설치하기 위해서는 공유기에 맞는 바이너리를 URL 경로를 확인 후 opkg 명령으로 설치 가능합니다.

예를 들어 Mi Wi-Fi Nano / Youth (R1CL) 공유기에 설치하기 위해서는 아래와 같은 명령을 사용할 수 있습니다.

Note

반드시 설치 전 https://mudfish.net/releases/openwrt/packages-18.06 디렉토리에 접속하셔서 최신 미꾸라지 버전인지 확인하시기 바랍니다. 간혹 문서가 업데이트가 늦어 최신 버전 정보를 반영하지 않을 수 있습니다.

# opkg install http://mudfish.net/releases/openwrt/packages-18.06/mipsel_24kc/base/mudfish-pi_2.1.18-1_mipsel_24kc.ipk
# opkg install http://mudfish.net/releases/openwrt/packages-18.06/mipsel_24kc/luci/luci-app-mudfish-pi_git-18.285.02627-b9e5d56-1_all.ipk

사용하기

Luci 웹 인터페이스 (관리자 웹 UI) 에 접근하셔서 OpenWRT 장비에 로그인하시면 “Service -> Mudfish” 에서 미꾸라지 관련 메뉴를 확인하실 수 있습니다.

현재 존재하는 분류로는 아래와 같은 것이 있습니다.

  • 기본 섹션

    미꾸라지 Launcher 의 시작 및 종료를 할 수 있는 버튼이 있습니다. 미꾸라지가 시작하게 되면 미꾸라지 Launcher 접속을 위한 링크가 표시되게 됩니다.

    미꾸라지 Launcher 접속 후 나오는 대시보드에 대한 자세한 사용법은 관리자 페이지 문서를 참고 바랍니다.

  • 기술 지원

    Support Tunnel 기능이 있으며 해당 터널을 생성할 경우 원격 기술 지원을 받을 수 있도록 시스템이 구성됩니다.