본문으로 건너뛰기

미꾸라지 패키지 설치

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

지원되는 OpenWRT 버전

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

  • 23.05
  • 22.03
  • 21.02
  • 19.07
  • 18.06

지원되는 공유기

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

의존하는 패키지

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

  • 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

만약 미꾸라지를 OpenWRT 19.07 펌웨어에 설치하고자 하신다면, luci-compat 패키지 또한 설치하셔야 UI 상에 메뉴가 제대로 보입니다.

# opkg install luci-compat

opkg 를 이용한 미꾸라지 패키지 설치

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

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

# opkg remove mudfish-pi

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

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

반드시 설치 전 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.22-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