콘텐츠로 이동

System Configuration

Page: 관리 → 시스템 관리

시스템 관리 화면은 오른쪽 상단의 관리 메뉴에서 "시스템 관리"를 선택하면 열리며, 시스템 전반에 걸친 다양한 설정을 구성할 수 있는 영역입니다.

일반 설정~

Page: 관리 → 시스템 관리 → 일반 설정

설정 설명
언어 웹 사용자 인터페이스에 표시될 언어를 설정합니다. "브라우저 기본값"은 브라우저의 언어를 따릅니다.
도착 페이지 로그인 직후 열리는 페이지입니다. 대시보드, 실시간 측정, 시스템 정보 중에서 고릅니다.
메인 페이지 내비게이션 바의 브랜드(로고)를 눌렀을 때 열리는 페이지입니다. "랜딩 페이지와 동일"을 고르면 도착 페이지 선택을 그대로 씁니다.
시스템 시간대 시스템 전체의 기본 시간대로, Asia/Seoul 같은 IANA 이름을 씁니다. 데몬 로그 시각과, 위치가 없는 장치의 마지막 대체값으로 쓰입니다. 사람이 읽고 쓰는 시각은 각자의 계정 설정에 있는 개인 시간대를 따릅니다.
파이로 타임아웃 웹 애플리케이션과 데몬 사이 연결의 타임아웃(초)입니다. 바꾼 뒤에는 백엔드를 재시작해야 적용됩니다.
데몬 디버그 로깅 사용 진단을 위해 상세한 디버그 메시지를 데몬 로그에 남깁니다. 로그가 크게 늘어나므로 끝나면 꺼 두십시오. 바꾼 뒤에는 백엔드를 재시작해야 적용됩니다.
HTTPS 강제 사용 웹 브라우저가 SSL/HTTPS를 사용하도록 요구합니다. http:// 요청은 https://로 리디렉션됩니다. Docker에서는 이 설정이 꺼진 상태로 고정됩니다(그렇지 않으면 직접 http://로 붙는 접속이 끊깁니다). 다만 HTTPS 리버스 프록시로만 접속하는 컨테이너라면 환경변수 AOT_BEHIND_TLS=1을 설정해 이 제한을 풉니다. 보안 문서의 "리버스 프록시 뒤에서의 쿠키(Docker)" 절을 참고하십시오.
성공 메시지 숨기기 페이지 상단에 표시되는 모든 성공 알림 박스를 숨깁니다.
정보 메시지 숨기기 페이지 상단에 표시되는 모든 정보 알림 박스를 숨깁니다.
경고 메시지 숨기기 페이지 상단에 표시되는 모든 경고 알림 박스를 숨깁니다.
툴팁 숨기기 입력란에 마우스를 올렸을 때 나타나는 툴팁을 숨깁니다.
통계 수집 거부 익명 사용 통계 전송을 비활성화합니다. 이 기능은 개발에 도움이 되므로 가능하면 유지해 주세요. 수집된 통계 보기에서 무엇이 수집되는지 정확히 볼 수 있습니다.

AI 서비스~

설정 설명
AI 서비스 사용 AI 서비스를 켜거나 끕니다. 끄면 AI 메뉴가 숨겨지고 AI 기능을 쓸 수 없지만, AI 설정은 모두 그대로 보존됩니다. 켠다고 해서 AI가 스스로 움직이는 것은 아니며, AI 모델을 하나 이상 등록한 뒤 AI 페이지에서 자율 운영을 따로 시작합니다. 실험적 기능입니다.
사용자 지정 이름 번역 직접 입력한 이름(장치·구역·작물 이름)은 쓴 언어 그대로 표시됩니다. 켜면 인터페이스 언어로도 함께 보여 줍니다. 저장된 이름은 바뀌지 않습니다. 이름 번역 화면에 직접 넣은 번역은 AI 엔진이 없어도 표시됩니다.
외부 MCP 서버 활성화 이미 실행 중인 MCP 서버에 대한 외부 MCP 클라이언트(예: Claude Desktop)의 요청을 허용하거나 거부합니다. 바로 적용됩니다. 서버가 듣는 주소와 포트는 여기서 정하지 않습니다. Docker에서는 aot_mcp 서비스의 ports: 항목을 고친 뒤 docker compose up -d를 다시 실행하고, 직접 설치에서는 aotmcp systemd 서비스를 고쳐 재시작합니다.

이 페이지에는 사이트 이름 입력란이 없습니다. 내비게이션 바와 브라우저 탭에 나오는 이름은 관리 → 시스템 관리 → 사용자 정의 UI의 브랜드 텍스트에서 정합니다. 브랜딩과 색상은 아래 사용자 정의 UI를 참조하세요.

사용자 정의 UI~

Page: 관리 → 시스템 관리 → 사용자 정의 UI

이 페이지에서는 웹 인터페이스의 브랜딩과 색상 팔레트를 바꿀 수 있습니다 — AoT에 자체 이름과 로고를 붙이거나, 단순히 색상 구성을 바꾸고 싶을 때 사용합니다. 페이지 상단의 실시간 미리보기가 값을 바꿀 때마다 즉시 반영되어 보이지만, 저장을 눌러야 실제 화면에 적용됩니다.

설정 설명
브랜드 표시 내비게이션 바에 표시할 내용을 정합니다: 기본 AoT 브랜딩, 호스트명, 사용자 지정 텍스트, 업로드한 이미지 중 하나입니다.
제목 표시 브라우저 탭 제목에 표시할 내용을 정합니다: 호스트명 또는 사용자 지정 브랜드 텍스트입니다.
브랜드 텍스트 브랜드 표시나 제목 표시를 텍스트로 설정했을 때, 호스트명 대신 표시할 사용자 지정 텍스트입니다.
브랜드 이미지 브랜드 표시를 브랜드 이미지로 설정했을 때 사용할 로고 업로드입니다(JPG, PNG, GIF, SVG, WebP).
브랜드 이미지 높이 업로드한 브랜드 이미지의 높이(픽셀)입니다.
파비콘 표시 기본 AoT 파비콘을 쓸지, 업로드한 아이콘을 쓸지 정합니다.
파비콘 이미지 파비콘 표시를 사용자 지정으로 설정했을 때 사용할 아이콘 업로드입니다.

브랜딩 아래로는 색상이 그룹으로 정리되어 있습니다. 브랜드 색상은 항상 보이고, 나머지는 탭으로 전환하며 편집합니다. 각 색상은 자체 16진값 입력란과 색상 선택기를 가지며, 실시간 미리보기의 요소를 클릭하면 그 요소를 결정하는 색상 설정으로 바로 이동합니다.

색상 그룹적용 대상
브랜드 색상 강조 아이콘·드래그 손잡이·AI 채팅 요소 등에 쓰이는 주/보조/강조 색조입니다.
텍스트 색상 기본·보조 텍스트 색상과, 채워진 버튼·배지 위 텍스트에 쓰이는 3차 색상입니다.
배경 색상 카드와 페이지 배경 색상입니다.
상태 색상 장치 켜짐/꺼짐/대기/경고 상태의 줄 배경색과, 측정값 상태·알림·확인 표시 등 앱 전체에서 쓰이는 4가지 의미 색상(성공·경고·위험·정보)입니다. 각 의미 색상은 옅은 배경/텍스트/테두리 변형을 함께 갖습니다.
버튼 색상 주/보조 버튼 배경색과 켜짐/꺼짐/일시정지/보류 조작 버튼 색상입니다.
배지 색상 AI(LLM) 배지, MCP 도구 배지, 업그레이드 가능 배지 색상입니다.
측정값 구간 색상 게이지 위젯과 센서 값 라벨에서 쓰이는 5단계 임계 구간(매우 낮음~매우 높음) 색상입니다.
차트 시리즈 색상 그래프·PID·달력 위젯 시리즈에 기본으로 배정되는 6가지 선 색상입니다.

테마 프리셋은 내장 팔레트(AoT 기본, Ocean Blue, Warm Sunset, Minimal Gray, Night Mode) 또는 프리셋 저장으로 직접 저장한 팔레트로 전환합니다. 기본값으로 초기화를 누르면 AoT의 내장 색상으로 되돌아갑니다.

설정설명
사용자 정의 CSS 위의 색상 설정만으로 부족할 때 모든 페이지에 추가로 적용할 CSS입니다.
사용자 정의 레이아웃 페이지 레이아웃에 삽입할 사용자 지정 HTML입니다.

시계열 데이터베이스 설정~

Page: 관리 → 시스템 관리 → 일반 설정

측정값은 시계열 데이터베이스에 저장됩니다. 현재 AoT에서 사용할 수 있는 옵션은 InfluxDB 1.x와 InfluxDB 2.x입니다. InfluxDB 1.x는 32비트 및 64비트 운영 체제 모두에서 작동하지만, 2.x는 64비트 운영 체제에서만 작동합니다. 따라서 32비트 운영 체제를 사용하는 경우 InfluxDB 1.x를 사용해야 합니다. AoT 설치 중 influxDB 1.x, 2.x 또는 설치하지 않음을 선택할 수 있습니다. InfluxDB를 설치하지 않은 경우에는 AoT가 측정값을 저장하고 조회할 수 있도록 별도의 설치 주소와 인증 정보를 지정해야 합니다.

Docker로 설치할 경우, 설치 후 InfluxDB Docker 컨테이너에 연결하기 위해 호스트 이름을 "aot_influxdb"로 변경해야 합니다.

설정 설명
데이터베이스 사용할 influxdb 버전을 선택합니다.
보존 정책 보존 정책을 선택합니다. 기본값은 v1.x는 "autogen", v2.x는 "infinite"입니다.
호스트 이름 시계열 서버에 연결할 호스트 이름입니다. 기본값은 "localhost"입니다.
포트 시계열 데이터베이스의 포트입니다. 기본값은 8086입니다.
데이터베이스 이름 AoT가 저장하고 조회할 데이터베이스 이름(v1.x) 또는 버킷(v2.x)입니다. 기본값은 "aot_db"입니다.
사용자 이름 데이터베이스에 접근하기 위한 사용자 이름입니다(인증이 필요한 경우). 기본값은 "aot"입니다.
비밀번호 데이터베이스에 접근하기 위한 비밀번호입니다(인증이 필요한 경우).

대시보드 설정~

Page: 관리 → 시스템 관리 → 일반 설정

설정 설명
그리드 셀 높이(px) 각 위젯 셀의 높이를 픽셀 단위로 설정합니다.

업그레이드 설정~

Page: 관리 → 시스템 관리 → 일반 설정

설정 설명
인터넷 테스트 IP 주소 업그레이드 전에 인터넷 연결이 살아 있는지 테스트할 때 사용할 IP 주소입니다. 직접 설치에서만 쓰입니다. Docker의 업그레이드 화면은 이 검사를 하지 않습니다.
인터넷 테스트 포트 인터넷 연결 활성 여부를 테스트할 때 사용할 포트입니다. 직접 설치에서만 쓰입니다.
인터넷 테스트 타임아웃 인터넷 연결 테스트 시의 타임아웃 시간입니다. 직접 설치에서만 쓰입니다.
업데이트 확인 2일마다 자동으로 업데이트를 확인하고 웹 인터페이스를 통해 알림을 표시합니다. 새 업데이트가 있는 경우, 관리 메뉴의 업그레이드 항목이 강조 표시됩니다.

에너지 사용 설정~

Page: 관리 → 시스템 관리 → 일반 설정

정확한 에너지 사용 통계를 계산하려면, 전기 시스템의 몇 가지 특성을 알아야 합니다. 이 변수들은 릴레이를 통해 전기 장치를 작동시키는 전기 시스템의 특성을 설명해야 합니다.

Note

전류 센서를 사용하지 않는 경우, 정확한 에너지 사용 계산을 위해 각 출력에 대해 정확한 전류 사용량을 설정해야 합니다 (출력 설정 참조).

설정 설명
최대 전류(A) 한 번에 허용되는 최대 전류를 설정합니다. 출력이 켜질 경우 활성 장치들의 총합이 이 값을 초과하면 손상을 방지하기 위해 출력을 켤 수 없습니다.
전압(V) 출력을 통해 스위칭되는 교류(AC) 전압입니다. 일반적으로 120 또는 240입니다.
kWh당 비용 kWh당 전기 요금을 입력합니다.
통화 단위 전기 요금에 사용되는 통화 단위입니다.
검침일 전기 계량기를 확인하는 날짜(1~30일)입니다. 전기 요금 청구일과 일치해야 합니다.
사용량/비용 보고서 생성 에너지 사용량 보고서를 생성할 시점을 정의합니다. 현재는 출력 시간 기반 계산 방식만 지원됩니다.
보고서 생성 주기 사용량/비용 보고서를 자동으로 생성할 주기를 설정합니다.
보고서 생성 요일/일자 보고서를 생성할 요일(Daily: 1~7, 월요일=1) 또는 월별 생성일(1~28)을 설정합니다.
보고서 생성 시간(시) 보고서를 생성할 시간을 0~23 사이에서 설정합니다.

컨트롤러 샘플링 주기 설정~

Page: 관리 → 시스템 관리 → 일반 설정

입력, 출력, 함수용 각 컨트롤러는 주기적으로 동작합니다. 각 컨트롤러가 응답할 수 있는 가장 빠른 속도는 해당 컨트롤러의 샘플링 주기로 결정됩니다. 컨트롤러는 해당 주기 동안 루프를 일시 중지합니다. 예를 들어 출력 컨트롤러의 샘플링 주기가 1초로 설정되어 있다면, 출력 on/off 명령은 최대 1초 내에 반응합니다.

설정 설명
최대 전류 한 번에 허용되는 최대 전류(A)를 설정합니다. 만약 출력을 켜는 명령이 현재 켜져 있는 장치들과 합쳐서 이 값을 초과하게 된다면, 출력은 손상을 방지하기 위해 켜지지 않습니다.
전압 출력을 통해 스위칭되는 교류(AC) 전압입니다. 일반적으로 120 또는 240입니다.
kWh당 비용 kWh당 전기 요금을 입력합니다.
통화 단위 전기 요금을 지불할 때 사용하는 통화 단위입니다.
검침일 전기 계량기를 확인하는 날짜(1~30일)입니다. 전기 요금 청구일과 일치해야 합니다.
사용량/비용 보고서 생성 에너지 사용량 보고서가 생성될 시점을 정의합니다. 현재는 출력 시간 기반 계산 방식만 지원됩니다.

입력 설정~

Page: 관리 → 시스템 관리 → 사용자 입력

입력 모듈은 AoT에 가져와 사용할 수 있습니다. 이 모듈은 특정 형식을 따라야 합니다. 자세한 내용은 사용자 입력을 참조하세요.

설정 설명
입력 모듈 가져오기 입력 모듈 파일을 선택한 후, 이 버튼을 클릭하여 가져오기를 시작합니다.

출력 설정~

Page: 관리 → 시스템 관리 → 사용자 출력

출력 모듈은 AoT에 가져와 사용할 수 있습니다. 이 모듈은 특정 형식을 따라야 합니다. 자세한 내용은 사용자 출력을 참조하세요.

설정 설명
출력 모듈 가져오기 출력 모듈 파일을 선택한 후, 이 버튼을 클릭하여 가져오기를 시작합니다.

함수 설정~

Page: 관리 → 시스템 관리 → 사용자 함수

함수 모듈은 AoT에 가져와 사용할 수 있습니다. 이 모듈은 특정 형식을 따라야 합니다. 자세한 내용은 사용자 함수를 참조하세요.

설정 설명
함수 모듈 가져오기 함수 모듈 파일을 선택한 후, 이 버튼을 클릭하여 가져오기를 시작합니다.

액션 설정~

Page: 관리 → 시스템 관리 → 사용자 동작

액션 모듈은 AoT에 가져와 사용할 수 있습니다. 이 모듈은 특정 형식을 따라야 합니다. 자세한 내용은 사용자 동작을 참조하세요.

설정 설명
액션 모듈 가져오기 액션 모듈 파일을 선택한 후, 이 버튼을 클릭하여 가져오기를 시작합니다.

위젯 설정~

Page: 관리 → 시스템 관리 → 사용자 위젯

위젯 모듈은 AoT에 가져와 사용할 수 있습니다. 이 모듈은 특정 형식을 따라야 합니다. 자세한 내용은 사용자 위젯을 참조하세요.

설정 설명
위젯 모듈 가져오기 위젯 모듈 파일을 선택한 후, 이 버튼을 클릭하여 가져오기를 시작합니다.

측정값 설정~

Page: 관리 → 시스템 관리 → 측정

AoT의 내장 타입 및 수식을 넘어 기능을 확장할 수 있도록 새로운 측정값, 단위, 변환식을 생성할 수 있습니다. 측정값을 만들기 전에 단위를 먼저 생성해야 하며, 이는 측정값을 생성할 때 단위를 선택해야 하기 때문입니다. 이미 존재하는 측정값에 추가 단위를 지정할 수도 있습니다. 예: altitude는 이미 존재하지만 fathom 단위를 추가하고 싶다면 먼저 fathom 단위를 만든 후, fathom이 선택된 상태로 altitude 측정값을 생성하면 됩니다.

설정 설명
측정값 ID 입력 모듈의 measurements_dict에서 사용할 측정값의 ID (예: "length", "width", "speed")
측정값 이름 측정값의 일반 이름 (예: "길이", "무게", "속도")
측정값 단위 측정값과 관련된 단위를 모두 선택합니다.
단위 ID 입력 모듈의 measurements_dict에서 사용할 단위의 ID (예: "K", "g", "m")
단위 이름 단위의 일반 이름 (예: "킬로그램", "미터")
단위 약어 단위의 약어 (예: "kg", "m")
변환 기준 단위 변환의 기준이 되는 단위
변환 대상 단위 변환할 단위
변환식 한 단위를 다른 단위로 변환하는 데 사용할 식입니다. 소문자 "x"가 포함되어야 하며 (예: "x/1000+20", "250*(x/3)"), 실제 측정값이 해당 x로 대체됩니다.

사용자 설정~

Page: 관리 → 시스템 관리 → 사용자

AoT의 로그인 시스템이 활성화되기 위해서는 최소한 하나의 관리자(Admin) 사용자가 필요합니다. 관리자 사용자가 존재하지 않으면, 웹 서버는 관리자 생성 폼으로 리디렉션됩니다. 이는 AoT를 처음 시작할 때 표시되는 첫 번째 페이지입니다. 관리자 사용자가 생성된 후에는 사용자 설정 페이지에서 추가 사용자를 생성할 수 있습니다.

설정 설명
사용자 이름 영문과 숫자만 사용해 3자에서 64자 사이의 사용자 이름을 선택합니다. 대소문자를 구분하지 않으며 모두 소문자로 변환됩니다.
이메일 해당 계정에 연결할 이메일 주소입니다.
비밀번호/재입력 8자 이상의 비밀번호를 선택합니다. 흔히 쓰이는 비밀번호는 길이 조건을 만족해도 거부됩니다. [보안](Security.ko.md#password-requirements) 참조.
키패드 코드 키패드를 이용해 로그인할 때 사용할 4자리 이상의 숫자 코드입니다 (선택 사항).
역할 사용자의 권한을 설정하기 위한 역할입니다. 아래의 기본 4가지 역할에 대한 설명을 참조하세요.
테마 웹 사용자 인터페이스에 적용할 테마입니다. 색상, 디자인 요소 등을 포함합니다.

역할~

역할은 각 사용자의 권한을 정의합니다. 사용자가 AoT의 특정 영역을 볼 수 있는지 또는 편집할 수 있는지를 결정하는 5개의 기본 역할(관리자·편집자·모니터·게스트·키오스크 — 키오스크는 카메라와 통계만 볼 수 있는 표시 전용 역할)이 제공됩니다. 기본 역할 외에도 사용자 정의 역할을 생성할 수 있습니다.

역할 관리자 편집자 모니터 게스트 키오스크
사용자 편집 X
컨트롤러 편집 X X
설정 편집 X X
설정 보기 X X X
카메라 보기 X X X X
통계 보기 X X X X
로그 보기 X X X

컨트롤러 편집 권한은 조건문, 그래프, LCD, 메서드, PID, 출력, 입력의 편집을 보호합니다. 사람이 하는 작업 예정(제초, 점검 등)도 이 권한으로 보호합니다 — 스케줄러, 노트 구간, AI 어시스턴트나 MCP, Google 캘린더 가져오기 등 어디서든 작업 예정을 만들고 고치고 취소하려면 이 권한이 필요합니다. 이 권한이 없는 역할은 설정 편집 권한이 있더라도 작업 예정을 볼 수만 있습니다.

통계 보기 권한은 사용 통계, 시스템 정보, 에너지 사용 페이지의 보기를 보호합니다.

그룹~

Page: 관리 → 시스템 관리 → 사용자 → 그룹

역할과 그룹은 서로 다른 질문에 답합니다. 역할은 사용자가 무엇을 할 수 있는지(설정 편집, 컨트롤러 편집, 통계 보기 등 — 위의 역할 참조)를 정하고, 그룹은 사용자가 어떤 대시보드·지도·시설·탭(그리고 그 탭에 놓인 입력·출력·함수·컨트롤러)을 조작할 수 있는지를 정합니다. 둘은 함께 작동합니다 — 어떤 대상을 조작하려면, 그 동작에 대한 역할 권한과, 그 대상이 부여된 그룹의 소속이 둘 다 있어야 합니다.

기본적으로 어떤 자원도 어느 그룹에도 속하지 않으므로, 그룹이 없던 때와 동작이 같습니다 — 역할이 어떤 동작을 허용하는 사용자는 누구에게나 그 동작을 수행할 수 있습니다. 이 상태는 특정 자원에 그룹을 부여하는 순간부터 바뀝니다. 그 시점부터는 부여된 그룹의 구성원(그리고 역할에서 "모든 그룹 접근"이 켜진 사용자)만 그 자원을 조작할 수 있습니다. 나머지 사용자는 즉시 조작 권한을 잃으므로, 그룹을 부여하기 전에 그 자원을 지금 누가 쓰고 있는지 먼저 확인하세요.

그룹은 자원을 조작하는 것만 제한합니다 — 장치를 켜고 끄는 것, 설정을 바꾸는 것, 삭제하는 것, 대시보드/지도/시설/탭 페이지를 여는 것입니다. 보기는 제한하지 않습니다. 센서 측정값, 기록, 내보내기 데이터는 그룹 소속 여부와 관계없이 로그인한 모든 사용자에게 그대로 보입니다.

AI 어시스턴트나 외부 MCP 클라이언트에게 변경을 시킬 때도 같은 제한이 적용됩니다 — 다른 그룹 자원을 건드리는 변경은 그 자원을 이름으로 가리키든, id 로 주든, 일정·시퀀스 단계를 거치든, 노트나 요청의 글 속에 적기만 하든 거부됩니다. 예약 작업은 실행될 때마다 그 책임자 기준으로 다시 확인합니다.

이 페이지(사용자 아래의 그룹 탭)는 그룹을 만들고 구성원을 정하는 용도일 뿐입니다. 자원을 그룹에 부여하는 것은 여기서 하지 않습니다.

설정 설명
그룹 이름 그룹의 이름입니다.
설명 이 그룹이 무엇을 위한 것인지입니다. 적어 두지 않으면 나중에 이 그룹이 아직 필요한지 아무도 알 수 없습니다.
구성원 이 그룹에 속한 사용자입니다.

그룹을 자원에 부여하는 것은 이 페이지가 아니라 그 자원 자신의 설정에서 합니다. 아래 자원은 각자의 설정 화면에 "이 ___을(를) 조작할 수 있는 그룹" 항목을 갖고 있습니다.

자원 그룹을 부여하는 위치
탭 그 탭 자신의 설정입니다. 그 탭에 놓인 모든 입력·출력·함수·조건문·트리거·PID·사용자 정의 컨트롤러도 함께 적용받습니다 — 장치 자체는 그룹을 따로 갖지 않고 항상 자신이 속한 탭을 따릅니다. 어떤 사용자에게 장치가 안 보이거나 조작이 막혀 있다면, 그 장치가 속한 탭에 부여된 그룹을 확인하세요.
대시보드 그 대시보드 자신의 설정입니다.
지도 그 지도 자신의 설정입니다.
시설 그 시설 자신의 설정입니다.

노트와 예정된 작업은 탭·대시보드·지도·시설뿐 아니라 지도 위에 그려진 구역·부지 외곽선·시설 자체의 경계·시설 안의 구획에도 붙을 수 있습니다. 이런 도형은 그룹에 직접 부여되지 않습니다 — "이 ___을(를) 조작할 수 있는 그룹" 항목이 따로 없습니다. 대신 그 도형에 붙은 노트나 작업은, 그 도형이 시설 안에 있으면 그 시설을 따르고, 아니면 그것이 그려진 지도를 따릅니다. 그래서 시설을 제한하면 그 외곽선 안 어디에 남기는 노트·작업도 함께 제한되고, 지도를 제한하면 그 지도 위에서 시설 밖에 그려진 모든 것이 함께 제한됩니다. 노트·일정 화면에서도 AI 도우미나 MCP 클라이언트를 통할 때와 똑같이 적용됩니다.

시설은 지도의 그룹을 물려받지 않습니다. 지도만 제한하면 그 안 시설의 노트·작업은 제한되지 않으니, 시설도 함께 제한하세요.

한 사용자가 여러 그룹에 속할 수 있습니다. 어떤 자원에 대해 사용자가 속한 그룹들의 결과가 다르면, 더 넓은 접근 쪽이 적용됩니다 — 그 자원이 부여된 그룹 중 하나에라도 속해 있으면 조작할 수 있습니다.

역할 화면에서 역할에 "모든 그룹 접근"을 켤 수 있습니다. 이 역할을 가진 사용자는 모든 그룹 제한을 건너뛰고 부여 여부와 상관없이 모든 자원을 조작할 수 있습니다 — 특정 영역이 아니라 시스템 전체를 관리하는 소수의 사용자를 위한 설정입니다. 기본 제공되는 관리자 역할은 기본값으로 이 설정이 켜져 있습니다.

라즈베리파이 설정~

Page: 관리 → 시스템 관리 → 라즈베리파이

라즈베리파이 설정은 AoT가 실행되는 Linux 시스템의 일부를 구성합니다.

이 화면은 raspi-config가 있는 라즈베리파이 설치에서만 동작합니다. Docker(또는 raspi-config가 없는 시스템)에서는 설정 대신 안내 문구가 표시됩니다.

PWM 출력 및 PWM, RPM, DHT22, DHT11, HTU21D 입력을 사용하려면 pigpiod가 필요합니다.

설정 설명
기능 활성화/비활성화 raspi-config 명령을 통해 웹 UI에서 활성화 및 비활성화할 수 있는 시스템 인터페이스(I2C, 1-Wire, 직렬 하드웨어, 직렬 로그인 셸, SPI, SSH)입니다. 각 행에는 raspi-config에서 읽은 현재 상태가 표시되고 그 반대 동작 버튼이 나타납니다. 직렬 장치를 쓰려면 직렬 하드웨어는 켜고 직렬 로그인 셸은 꺼야 합니다. 변경 내용은 관리 -> 시스템 재시작 후에 적용됩니다. Bookworm의 부팅 설정 파일은 /boot/firmware/config.txt입니다.
pigpiod 샘플링 속도 pigpiod 서비스가 작동할 샘플링 속도입니다. 숫자가 낮을수록 더 빠른 PWM 주파수를 사용할 수 있지만, Pi Zero에서는 프로세서 부하가 크게 증가할 수 있습니다. pigpiod는 필요하지 않은 경우 완전히 비활성화할 수도 있습니다 (위의 참고 사항 참조).

알림 설정~

Page: 관리 → 시스템 관리 → 알림

알림 설정에는 AoT가 이메일을 보낼 때 쓰는 SMTP 계정을 입력합니다. 조건부 기능(Conditional)의 이메일 보내기 액션(또는 알림에 설명한 다른 이메일 경로)이 실행되어야 비로소 이메일이 나가므로, 이 화면만 설정해서는 알림이 발송되지 않습니다.

설정 설명
SMTP 호스트 이메일을 보낼 때 사용할 SMTP 서버입니다.
SMTP 포트 SMTP 서버와 통신할 포트입니다. 비워 두면 선택한 프로토콜의 기본 포트를 사용합니다 (SSL 465, TLS 587, 암호화되지 않음 25).
SMTP 프로토콜 선택 상자에서 SSL, TLS, 암호화되지 않음, 암호화되지 않음 (로그인 없음) 중 하나를 고릅니다. 마지막 항목은 SMTP 로그인을 아예 하지 않으며, 로그인이 필요 없는 사내 중계 서버용입니다. 암호화되지 않는 프로토콜을 고르면 경고가 표시됩니다.
SMTP 사용자 SMTP 서버에 로그인할 사용자 이름입니다. 이름만 입력하거나 전체 이메일 주소를 입력할 수 있습니다.
SMTP 비밀번호 계정의 비밀번호입니다. 저장된 비밀번호는 화면에 표시되지 않으며, 바꾸려는 경우에만 입력합니다.
보낸 사람 이메일 보낸 사람으로 표시할 주소입니다. 대부분의 서비스는 로그인한 계정 자체이거나 그 계정이 대신 보낼 수 있도록 허용된 주소여야 합니다.
시간당 최대 이메일 수 이메일 보내기 액션이 한 시간에 보낼 수 있는 최대 이메일 수입니다 (1 이상). 한도를 넘는 이메일은 대기열에 쌓이지 않고 버려집니다. 아래 시간당 한도를 참고하세요.

설정을 저장하려면 저장을 누릅니다.

테스트 이메일 보내기~

테스트 이메일 보내기 영역은 테스트 수신자에 입력한 주소로 메일 한 통을 보냅니다. 테스트는 화면에 지금 입력한 값이 아니라 이미 저장된 설정을 사용하므로, 먼저 저장을 누른 뒤 테스트하세요. 성공 또는 실패 메시지가 화면 위쪽에 표시됩니다.

Gmail 사용하기~

Google은 SMTP에 일반 계정 비밀번호를 받지 않습니다. Google 계정에서 2단계 인증을 켠 다음 Google 앱 비밀번호(Google 계정 -> 보안 -> 앱 비밀번호)를 만들어 SMTP 비밀번호로 입력합니다. 호스트는 smtp.gmail.com, 프로토콜은 SSL(포트 465) 또는 TLS(포트 587)을 쓰고, SMTP 사용자에는 Gmail 전체 주소를 입력합니다. 보낸 사람 이메일도 같은 주소로 맞추세요. Gmail은 다른 보낸 사람 주소를 바꾸거나 거부합니다.

시간당 한도~

이 한도는 이메일 보내기와 사진과 함께 이메일 보내기 액션에 적용됩니다. 첫 발송부터 한 시간 구간이 시작되고, 그 구간에서 보낸 횟수가 한도에 이르면 구간이 끝날 때까지 나머지 이메일은 버려집니다. 버려진 이메일은 나중에 다시 보내지지 않으며, 하나마다 데몬 로그에 오류 줄(Wait N seconds to email again)이 남습니다(로그 뷰 참고). 한도에 이른 뒤의 시도도 횟수에 포함됩니다.

카운터를 비우고 새 구간을 바로 시작하려면 진단 화면의 이메일 카운터 재설정을 사용합니다.

카메라 설정~

Page: 관리 → 시스템 관리 → 카메라

AoT는 여러 대의 카메라를 동시에 사용할 수 있습니다. 각 카메라는 카메라 설정에서 설정한 후 소프트웨어 전반에서 사용할 수 있습니다.

Note

제조사별 하드웨어 및 소프트웨어 차이로 인해 일부 옵션(예: 색조 또는 화이트 밸런스)은 특정 카메라에서 사용할 수 없을 수 있습니다.

설정 설명
유형 카메라가 Raspberry Pi 카메라인지 USB 카메라인지 선택합니다.
라이브러리 카메라와 통신하기 위해 사용할 라이브러리를 선택합니다. Raspberry Pi 카메라는 picamera를 사용하며, USB 카메라는 fswebcam으로 설정해야 합니다.
장치 카메라에 연결할 장치를 지정합니다. fswebcam 라이브러리만 이 옵션을 사용합니다.
출력 스틸 이미지 캡처(타임랩스 포함) 중에 활성화될 출력을 설정합니다.
출력 지속 시간 이미지 캡처 전에 출력이 활성화될 시간을 설정합니다.
이미지 회전 이미지를 회전할 각도를 설정합니다.
... 이미지 너비, 이미지 높이, 밝기, 대비, 노출, 게인, 색조, 채도, 화이트 밸런스. 이러한 옵션은 직관적입니다. 모든 옵션이 모든 카메라에서 작동하지 않을 수 있습니다.
사전 명령 스틸 이미지가 캡처되기 전에 'root' 사용자로 실행할 명령입니다.
사후 명령 스틸 이미지가 캡처된 후 'root' 사용자로 실행할 명령입니다.
수평 반전 이미지를 수평으로 뒤집거나 미러링합니다.
수직 반전 이미지를 수직으로 뒤집거나 미러링합니다.

진단 설정~

Page: 관리 → 시스템 관리 → 진단

시스템에서 비호환 구성으로 인해 문제가 발생할 수 있습니다. 이는 시스템의 일부(입력, 출력 등)가 잘못 구성되었거나 데이터베이스 업그레이드가 제대로 처리되지 않은 업데이트, 또는 기타 예기치 못한 문제로 인해 발생할 수 있습니다. 문제의 원인을 파악하거나 문제 자체를 해결하기 위해 진단 작업을 수행해야 할 때가 있습니다. 아래 옵션은 문제를 완화하기 위한 것입니다. 예를 들어, 데이터 -> 대시보드 페이지에서 오류를 일으키는 잘못 구성된 대시보드 요소로 인해 해당 페이지에 접근할 수 없는 경우, 모든 대시보드 요소를 삭제하는 것이 다시 접근할 수 있는 가장 경제적인 방법일 수 있습니다. 단, 이 경우 기존의 모든 대시보드 요소를 다시 추가해야 합니다.

설정 설명
모든 대시보드 삭제 데이터 -> 대시보드 페이지에 저장된 모든 대시보드를 삭제합니다.
모든 입력 삭제 설정 -> 입력 페이지의 모든 입력을 삭제합니다.
모든 노트 및 태그 삭제 더보기 -> 노트 페이지의 모든 노트와 태그를 삭제합니다.
모든 출력 삭제 설정 -> 출력 페이지의 모든 출력을 삭제합니다.
설정 데이터베이스 삭제 aot.db 설정 데이터베이스를 삭제합니다 (경고: 이 작업은 모든 설정과 사용자를 삭제합니다).
파일 삭제: .dependency .dependency 파일을 삭제합니다. 종속성 설치 페이지에 접근하는 데 문제가 있는 경우 시도해 보세요.
파일 삭제: .upgrade .upgrade 파일을 삭제합니다. 업그레이드 페이지에 접근하거나 업그레이드를 실행하는 데 문제가 있는 경우 시도해 보세요.
InfluxDB 1.x 데이터베이스 재생성 InfluxDB 1.x 측정 데이터베이스를 삭제한 후 재생성합니다. 이 작업은 모든 측정 데이터를 삭제합니다!
InfluxDB 2.x 데이터베이스 재생성 InfluxDB 2.x 측정 데이터베이스를 삭제한 후 재생성합니다. 이 작업은 모든 측정 데이터를 삭제합니다!
이메일 카운터 재설정 시간당 이메일 카운터를 비우고 새 한 시간 구간을 시작합니다. 한도에 막혀 이메일이 나가지 않을 때 사용합니다.
종속성 설치 AoT 시스템 전체에 필요한 모든 종속성을 설치하는 스크립트를 시작합니다.
마스터로 업그레이드 설정 config.py에서 FORCE_UPGRADE_MASTER를 True로 변경합니다. GitHub의 main 브랜치로 업그레이드하도록 업그레이드 시스템에 지시하는 방법으로, 로그인하여 config.py 파일을 수동으로 편집하지 않아도 됩니다.