.. _설치 방법 (공유기):

설치 방법 (공유기)
******************

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

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

.. contents:: :local:

설치
====

지원되는 OpenWRT 버전
---------------------

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

* 18.06.1
* 15.05.1 (Chaos Calmer)

지원되는 공유기
---------------

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

* TP-Link

  * `Archer C7 AC1750`_

* Buffalo Inc.

  * `WZR-HP-AG300H`_

* GL.inet

  * `GL-AR300M`_
  
* Western Digital

  * `My Net N750`_

* Xiaomi

  * `Mi Wi-Fi Nano / Youth (R1CL)`_

.. _Archer C7 AC1750: https://www.tp-link.com/en/products/details/Archer-C7.html
.. _GL-AR300M: https://www.gl-inet.com/ar300m/
.. _WZR-HP-AG300H: http://buffalo.jp/products/catalog/network/wzr-hp-ag300h/
.. _My Net N750: https://support.wdc.com/product.aspx?ID=1702
.. _Mi Wi-Fi Nano / Youth (R1CL): https://www.mi.com/miwifilite/

의존하는 패키지
---------------

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

* ip

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

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

* libopenssl

* libpthread

* librt

* zlib

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

* Mi Wi-Fi Nano / Youth (R1CL)

  https://downloads.openwrt.org/releases/18.06.1/targets/ramips/mt76x8/

  다음과 명령어를 통해서 패키지들을 설치하실 수 있습니다.

  .. code-block:: bash

     # opkg update
     # opkg install kmod-tun
     # opkg install ip zlib libpthread librt libopenssl

Luci 웹 인터페이스 설치
-----------------------

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

.. code-block:: bash

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

opkg 를 이용한 미꾸라지 설치
----------------------------

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

.. _opkg 명령어 사용법: https://wiki.openwrt.org/doc/techref/opkg

.. note::

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

   .. code-block:: bash

      # opkg remove mudfish-pi

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

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

.. note::

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

.. code-block:: bash

   # 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 접속 후 나오는 대시보드에 대한 자세한 사용법은
  :ref:`관리자 페이지` 문서를 참고 바랍니다.

* 기술 지원

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