UniFi - system.properteis 파일에 관하여

download at 2017-10-27T16:38:44Z origin

Overview

system.properties 파일은 <unifi_base>/data 디렉토리에 위치하고 있으며 UniFi 서버 인스톨 디렉토리 아래의 "Data" 폴더에 위치합니다. 해당 디렉토리는 UniFi 컨트롤러에 적요앟는 시스템 파라미터에 대하여 정의하고 있습니다. system.properties 파일이 유지하는 UniFi 시스템 설정은 아래와 같은 내용을 포함합니다:

  • Controller IP Interface 설정을 직접 오버라이드 (주소는 장치가 패킷을 통해서 전달하는 본인의 주소입니다)
  • Advanced Database 조정
  • 가장 많이 쓰이는 옵션은 Port Assignments , UniFi 컨트롤러가 관리하고 있는 장비, 리다이렉팅 되는 게스트 포탈 트래픽등과의 커뮤니케이션을 위해 사용합니다.

system.properties 파일은 텍스트 에디터에서 바로 수정이 가능합니다. 해시 태그(#)는 주석이므로 직접 설정에 적용되지 않습니다. 파일 가장 아래에 수정 사항을 추가하도록 하며, 수정이 완료되 이후에는 직접 프로비저닝을 각 사이트에 적용해야 합니다. UniFi - How to Trigger a Provision 문서를 참조하십시오.

info_i_25x25.png

Note

<unifi_base> 위치는 운영체제 마다 다르게 위치합니다. 이 문서 를 참조하십시오.

Table of Contents

  1. 기본 포트
  2. 컨트롤러 커뮤니케이션을 위한 IP 인터페이스 직접 설정하기
  3. 고급 데이터베이스 설정
  4. 사용자 노트 & 팁

기본 포트

맨위로 가기

UAP와 컨트롤러의 기본 포트를 변경하기 는 해당 문서를 참조하고, 다른 기본 포트는 아래와 같습니다:

  • unifi.shutdown.port=8081   # 관리 목적
  • unifi.http.port=8080           # 장치 알림
  • unifi.https.port=8443         # 컨트롤러 UI / API
  • portal.http.port=8880        # HTTP 포탈 리다이렉션 포트
  • portal.https.port=8843      # HTTPS 포탈 리다이렉션 포트
  • unifi.db.port=27117          # DB 서버 로컬 바운드 포트
  • unifi.stun.port=3478         # STUN을 위한 UDP 포트

컨트롤러 커뮤니케이션을 위한 IP 인터페이스 직접 설정하기

컨트롤러 장비가 다중 IP 인터페이스르 사용한다면 다음 설정을 통해서 특정 IP 인터페이스가 컨트롤러와 통신하도록 할 수 있습니다:

  • system_ip=a.b.c.d          # IP 장비가 반드시 서로 정보 교환을 해야합니다

고급 데이터베이스 설정

맨위로 가기

아래의 고급 데이터베이스 설정은 대부분의 사용자가 필요하지 않은 설정입니다. Note: 아래의 설정들에 대하여 별도 테스트를 진행하지 않았으며, 고급 데이터베이스 사용자에게만 권장합니다. 해당 옵션을 사용할만한 시나리오로는 몇몇 사용자가 컨트롤러를 NAS에서 사용하거나, 요구하는 자원을 최소화 하려고 할 때 사용합니다.

  • unifi.db.nojournal=false    # disable mongodb journaling
  • unifi.db.extraargs            # extra mongod args

아래의 환경 설정은 컨트롤러 설치를 할 때 사용합니다. 대부분의 사용자는 이 옵션이 필요하지 않으며 is_default 옵션이 true로 설정 되어 있다면, 컨트롤러는 공장 초기 옵션으로 수행합니다. 일반적으로 모든 사용자는 언인스톨을 하고 재설치를 권장합니다.

  • is_default=false

(v3.1.7+) 아래의 환경설정은 v3 이전에 발생했던 버그(일반 사용자가 슈퍼 관리자를 삭제하는 버그)를 고치기 위한 옵션입니다. 해당 이슈를 해결하였지만, 일부 사용자는 이미 해당 슈퍼 계정을 삭제했을 수도 있습니다. 그런 경우에는 아래의 옵션을 사용합니다.

  • super_admin.name=account_id_to_be_promoted

(v5.1.0+) v5.1.0 부터는 컨트롤러 UI에 백업 기능이 추가되었습니다. UI에서 백업 주기, 백업의 양, 백업하는 시간 등을 설정할 수 있습니다. 해당 값을 설정하고 난 이후에는 UI에서 스토리지 위치를 변경할 수 있습니다. system.properties 파일에 옵션을 추가하여 해당 경로를 변경할 수 있도록 하였으며 현재 기본 경로는 아래와 같습니다:

  1. Cloud Key: /data/autobackup (SD 카드가 마운트 되면 기본 값으로 /data에 마운트 됩니다.)
  2. 소프트웨어 인스톨: {data.dir}/backup/autobackup
  • autobackup.dir=/some/path

UAP-AC-EDU는 로컬 컨트롤러에서 관리하는 것을 권장합니다. 현재 EDU 모바일 앱에서 통신을 하기 위해서는 앱에서 컨트롤러로 릴레이 하였다가 EDU로 통신을 진행할 수 있습니다. 모바일 장비가 EDU와 다른 네트워크 대역에 존재한다면, 적절한 포트를 개방해야합니다. 컨트롤러가 EDU와 다른 네트워크 대역에 있다면 아래의 설정을 추가합니다.

  • stream.playback.url.type=inform

(5.5.15+/5.6.7+) 이제 컨트롤러에서 HSTS를 지원합니다. 기본 값으로는 비활성화되어 있습니다. 이 옵션이 무슨 행위를 하는지 아는 경우 사용하십시오. 이 옵션은 system.properties의 값이며, 손쉽게 변경이 가능합니다. 해당 옵션을 수행하게되면, 브라우저의 캐시를 비우는 작업을 수행해야 합니다. HSTS를 추가하려면 아래의 내용을 수행합니다:

  • unifi.https.hsts=true
  • unifi.https.hsts.max_age=31536000
  • unifi.https.hsts.preload=false
  • unifi.https.hsts.subdomain=false

*현재는 직접 설정을 추가할 때에는 다른 문자(스페이스와 주석 등을 포함하여)를 추가해서는 안됩니다.*

사용자 노트 & 팁

맨위로 가기

아래의 노트는 사용자들이 기여한 내용이며, 추가로 기여하고 싶은 내용이 있다면**Give Feedback* 버튼을 클릭하십시오!*

  • RPi UniFi 컨트롤러에서 로깅 비율을 낮추고 싶다면, Community thread 를 확인하십시오. Note: 로그 없이는 적절한 지원을 받기 어려우며, 상황에 따라서 어떤 로그를 사용할지는 다음 문서 `UniFi - What log files exist and where can I view them? <https://help.ubnt.com/hc/en-us/articles/204959834-UniFi-What-log-files-exist-and-where-can-I-view-them->`__ 를 참조하십시오.