디바이스 연결

IronFlock은 하드웨어와 운영 체제에 따라 다양한 디바이스 연결 방법을 지원합니다. 아직 하드웨어가 없나요? 몇 분 만에 노트북에서 디바이스를 시뮬레이션해 볼 수 있습니다.

사전 요구사항

디바이스를 연결하기 전에 다음 사항을 준비하십시오:

IronFlock에서 생성된 프로젝트
해당 프로젝트 내에 생성된 디바이스 항목(프로젝트 설정 → 디바이스 패널에서 새 디바이스 클릭)
다운로드된 디바이스 구성 파일(.flock)

.flock 파일을 잃어버렸나요? 언제든지 다시 다운로드할 수 있습니다. 프로젝트 사이드바에서 디바이스를 열고 유지보수로 이동한 다음 구성 파일 다운로드를 클릭하십시오. 새 디바이스가 아니라 동일한 구성입니다. 디바이스에 대한 maintain 권한이 필요합니다. 디바이스 유지보수를 참조하십시오.

제한된 기업 네트워크의 디바이스인가요? 설치하기 전에 네트워크 구성을 계획하십시오 — 갓 설치한 디바이스가 오프라인 상태로 남는 가장 흔한 원인입니다:

ID 인식 방화벽 또는 프록시: 디바이스를 허용하는 규칙은 로그인한 사용자가 아니라 반드시 디바이스 자체를 기준으로 설정해야 합니다 — 그렇지 않으면 해당 사용자의 세션이 만료될 때마다 디바이스가 네트워크에서 끊깁니다. ID 인식 방화벽 및 프록시를 참조하세요.

회사 HTTP 프록시: 에이전트와 Docker에 프록시를 명시적으로 알려 주어야 합니다 — 회사 프록시 환경 사용 → 엣지 디바이스를 참조하세요.

온프레미스 어플라이언스에 연결하는 경우: 디바이스가 어플라이언스의 서비스 포트에 직접 도달할 수 있어야 합니다 — 또는 어플라이언스가 회사 인증서를 사용하는 HTTPS로 실행 중이라면 포트 443만 필요하며, 이때 디바이스가 회사 루트 CA를 신뢰해야 합니다. 어플라이언스 가이드의 디바이스 연결을 참조하세요.

시계 어긋남: 기업 방화벽은 갓 설치한 운영체제에 기본 설정된 공용 시간 서버를 대개 차단하므로 디바이스 시계가 조용히 어긋납니다 — 내부 NTP 서버를 설정하십시오. 시간 동기화 (NTP)를 참조하세요.

ID 인식 방화벽 및 프록시

모든 엣지 디바이스는 IronFlock 에이전트를 무인 시스템 서비스로 실행합니다. 에이전트는 부팅 시 시작되어 항상 연결을 유지하며, 디바이스에 누가 로그인해 있든 없든 계속해서 앱을 설치하고 이미지를 가져오며 스스로를 업데이트합니다. 이는 플랫폼이 IronFlock 클라우드, 프라이빗 클라우드, 온프레미스 어플라이언스 중 어디에서 실행되든 마찬가지입니다.

OT 네트워크는 점점 더 ID 인식 방화벽 및 프록시로 보호되고 있습니다. 이러한 장비는 네트워크 주소 대신 디렉터리 ID를 기준으로 접근을 허용합니다. 엣지 디바이스를 허용하는 규칙이 그 디바이스에 로그인한 사용자에 연결되어 있으면, 해당 사용자의 세션이 만료될 때마다 디바이스의 네트워크 접근이 끊깁니다:

이미 열려 있는 연결은 계속 동작하므로 디바이스는 여전히 온라인으로 표시됩니다.
모든 새 연결은 조용히 폐기됩니다 — 앱 설치, 이미지 가져오기, 에이전트 업데이트, 재연결이 실패합니다.
에이전트나 디바이스가 다음에 재시작된 뒤에는 전혀 재연결할 수 없으며, 누군가 디바이스에 다시 로그인하거나 규칙이 변경될 때까지 오프라인 상태로 남습니다.

네트워크 팀에 규칙을 사람이 아니라 디바이스를 기준으로 설정하도록 요청하십시오:

디바이스	규칙에 사용할 ID
도메인에 가입된 Windows 디바이스	해당 디바이스의 컴퓨터 계정 — 컴퓨터 개체 또는 IronFlock Edge Devices 같은 그룹
Linux 또는 IronFlockOS 디바이스, 또는 도메인에 가입되지 않은 Windows	예약된 IP 주소를 가진 이름이 지정된 호스트 객체, 또는 네트워크 접근 제어(802.1X 또는 MAC 인증)가 할당하는 ID

주요 제품별 적용 방법:

Check Point Identity Awareness: Access Role에서 사용자 대신 머신(컴퓨터 개체 또는 그룹)을 선택하십시오. 머신 ID는 컴퓨터 자체의 도메인 활동으로 갱신됩니다. 게이트웨이에서 머신 ID가 만료될 수 있다면 대신 네트워크 객체를 사용하십시오.
Palo Alto Networks User-ID: 컴퓨터 계정은 IP-사용자 매핑을 생성하지 않으므로, 주소 객체, 태그 또는 Device-ID를 사용하십시오.
Fortinet FSSO 및 유사한 디렉터리 기반 방화벽: 디바이스에 대한 주소 객체, 또는 네트워크 접근 제어가 할당하는 동적 주소를 사용하십시오.
Zscaler, Prisma Access 및 기타 클라우드 보안 게이트웨이: 디바이스 네트워크를 IoT 또는 서버 위치(신뢰할 수 있는 소스)로 등록하여, 디바이스 트래픽이 사용자가 아닌 위치로 식별되도록 하십시오.

이는 ID 정책의 예외가 아닙니다. 디바이스가 실제로 가진 ID로 디바이스를 식별하는 것입니다. 온프레미스 어플라이언스를 운영한다면 어플라이언스 호스트에도 똑같이 적용됩니다. IronFlock 호스트의 네트워크 ID를 참조하세요.

장애 식별하기. 디바이스가 온라인 상태를 유지하는데 앱 설치, 이미지 가져오기 또는 에이전트 업데이트가 타임아웃으로 실패하고 ping은 여전히 성공한다면, 원인은 디바이스가 아니라 만료된 ID 규칙에 있습니다. 디바이스에서 새 연결이 다시 성공할 때까지 에이전트나 디바이스를 재시작하지 마십시오. 아직 열려 있는 세션이 유일하게 동작하는 연결이며, 그동안 이 세션 덕분에 디바이스를 원격으로 계속 관리할 수 있습니다.

먼저 테스트하기: 노트북에서 디바이스 시뮬레이션

IronFlock을 살펴보는 데 물리적 하드웨어가 꼭 필요한 것은 아닙니다. FlockFlasher 앱은 IronFlock 에이전트를 노트북에서 직접 실행할 수 있으므로, 노트북이 프로젝트 내에서 실제 디바이스처럼 동작합니다 — 실제 하드웨어에 배포하기 전에 앱과 대시보드를 테스트하기에 안성맞춤입니다.

Docker Desktop(Linux에서는 Docker Engine)을 설치하고 실행 중인지 확인합니다.
사용 중인 OS에 맞는 FlockFlasher 앱을 다운로드하여 설치합니다.
다운로드한 디바이스의 .flock 파일을 더블 클릭합니다 — 파일이 FlockFlasher에서 열리고 디바이스가 목록에 표시됩니다. (또는 FlockFlasher를 열고 + 버튼으로 파일을 추가할 수도 있습니다.)
디바이스 항목에서 Test Device(▶, 디바이스 테스트) 버튼을 클릭합니다. FlockFlasher가 처음 사용할 때 IronFlock 에이전트를 자동으로 다운로드하고 디바이스 구성으로 시작합니다.

이제 노트북이 IronFlock 프로젝트 내에서 이 디바이스 역할을 합니다. 온라인 상태로 표시되며, 실제 디바이스와 똑같이 앱을 설치하고 실행할 수 있습니다. 앱은 노트북에서 Docker 컨테이너로 실행됩니다.

테스트가 끝나면 FlockFlasher에서 테스트를 중지하십시오. 나중에 동일한 .flock 파일을 사용하여 실제 디바이스를 프로비저닝할 수 있습니다 — 단, 하나의 디바이스 구성은 한 번에 한 대의 머신에서만 실행해야 합니다.

방법 1: SD 카드 플래싱

SD 카드에서 부팅하는 Raspberry Pi 및 기타 ARM 디바이스에 적합합니다.

사용 중인 OS에 맞는 FlockFlasher 앱을 다운로드합니다.
SD 카드(최소 16GB)를 컴퓨터에 삽입합니다.
FlockFlasher를 열고 + 버튼을 클릭하여 .flock 파일을 불러옵니다.
SD 카드 드라이브를 선택합니다(FlockFlasher가 외부 드라이브를 자동으로 감지합니다).
디바이스에 맞는 이미지를 선택합니다(Raspberry Pi 3/4, Zero 등).
선택적으로 WiFi를 구성하여 디바이스가 목적지에서 연결할 수 있도록 합니다.
Flash를 클릭하고 쓰기, 검증, 구성이 완료될 때까지 기다립니다.
SD 카드를 디바이스에 삽입하고 전원을 켭니다.

디바이스는 20분 내에 온라인 상태가 되어야 합니다.

경고: 플래싱 과정은 선택한 드라이브의 모든 데이터를 삭제합니다. FlockFlasher는 기본적으로 내부 드라이브를 숨기지만, 플래싱 전에 항상 선택한 드라이브를 다시 확인하십시오.

방법 2: 산업용 PC를 위한 USB 설치

EFI 부팅을 지원하는 AMD64 디바이스(예: Siemens SIMATIC Box IPC)에 적합합니다.

USB 스틱(최소 16GB)을 삽입하고 FlockFlasher를 엽니다.
.flock 파일을 불러오고 USB 드라이브를 선택합니다.
Industrial PC x86_64 (EFI) 이미지를 선택합니다.
Flash를 클릭하고 완료될 때까지 기다립니다.
필요한 경우 디바이스의 BIOS에서 부팅 순서를 변경하여 USB에서 부팅하도록 설정합니다.
USB 스틱을 삽입하고 디바이스의 전원을 켭니다.

디바이스는 60분 내에 온라인 상태가 되어야 합니다.

명령줄에서 플래싱

IronFlock CLI는 데스크톱 앱 없이 방법 1과 2의 드라이브를 준비합니다. Linux와 macOS에서 실행되며, Raspberry Pi 4, 400, 5, CM4, CM5용과 UEFI를 사용하는 PC 및 ARM 머신용 IronFlockOS를 씁니다.

컴퓨터에 ironflock 명령을 설치합니다:


curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash

SD 카드나 USB 스틱을 삽입하고 드라이브 이름을 확인합니다:
```
ironflock os drives
```
IronFlockOS와 .flock 파일을 드라이브에 씁니다. /dev/sdb를 실제 드라이브로 바꾸십시오:
```
sudo ironflock os flash -c mydevice.flock -d /dev/sdb
```
산업용 PC에는 --installer를 추가합니다. 그러면 이 스틱으로 시작하는 PC의 내부 디스크에 스틱이 IronFlockOS를 설치합니다:
```
sudo ironflock os flash -c mydevice.flock -d /dev/sdb --installer
```

이 명령은 .flock 파일에 지정된 하드웨어용 이미지를 다운로드하고 확인합니다. 무엇을 쓸지 보여 주고, 드라이브를 지우기 전에 묻습니다. 그런 다음 드라이브에 쓰고 다시 읽어 확인합니다. 디바이스에 .flock 파일과 다른 WiFi 네트워크를 지정하려면 --wifi-ssid와 --wifi-password-file을 추가하십시오. 모든 옵션은 IronFlockOS를 드라이브에 쓰기를 참조하십시오.

머신에서 이미 Linux가 실행 중이고 스틱으로 시작할 수 없나요? ironflock os install은 실행 중인 Linux를 같은 디스크의 IronFlockOS로 교체하며, SSH로 원격 머신에서도 실행할 수 있습니다. 그 디스크의 모든 내용은 사라집니다. Linux를 IronFlockOS로 교체를 참조하십시오.

방법 3: 커스텀 설치

기존 Linux OS를 유지하는 디바이스에 적합합니다. NVIDIA Jetson 및 커스텀 하드웨어에 이상적입니다.

참고: 이 수동 설치 방법은 산업용 PC, 게이트웨이, 임베디드 디바이스와 같은 실제 프로덕션 하드웨어를 위한 것이며, 노트북용이 아닙니다. 노트북에서 IronFlock을 간단히 사용해 보고 싶다면 대신 먼저 테스트하기: 노트북에서 디바이스 시뮬레이션을 따르십시오 — 수동 에이전트 설치가 필요하지 않습니다.

Linux / Unix 디바이스

디바이스에 SSH로 접속합니다.
컴퓨터에서 디바이스로 .flock 파일을 복사합니다:
```
scp mydevice.flock user@device-ip:/home/user/
```
설치 프로그램을 다운로드하고 실행합니다:
```
curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash -s -- agent install -c mydevice.flock
```
IronFlock 어플라이언스를 사용 중인가요? 명령은 동일합니다. ironflock agent install은 .flock 파일이 지정하는 어플라이언스의 다운로드 미러에서 디바이스 에이전트를 가져오고, 미러에 없는 것은 인터넷에서 가져옵니다. 설치 스크립트, ironflock, 배포판의 패키지와 Docker는 여전히 인터넷에서 가져오므로, 설치하는 동안 디바이스는 인터넷에 접근할 수 있어야 합니다. 그 이후에는 어플라이언스에만 접근할 수 있으면 됩니다(엣지 디바이스 참조).
설치 프로그램의 질문에 답하세요. 설치가 끝나면 에이전트가 실행되고, 1분 안에 디바이스가 IronFlock에 온라인으로 표시됩니다. 재부팅은 필요하지 않습니다.

디바이스는 systemd를 사용하는 Debian 또는 Ubuntu 기반 Linux를 실행해야 합니다.

install.sh는 디바이스의 CPU에 맞는 IronFlock 명령줄 도구 ironflock을 다운로드합니다. 스크립트에 내장된 IronFlock 키로 다운로드한 파일의 서명을 확인하고, 도구를 /usr/local/bin/ironflock으로 설치한 뒤, 전달한 인자와 함께 실행합니다. 인자가 없으면 도구만 설치합니다. 이후 sudo ironflock agent install -c mydevice.flock으로 디바이스를 연결하세요.

ironflock agent install은 먼저 설치가 성공할 수 있는지 확인합니다. 그런 다음 Docker(없는 경우)와 디바이스 에이전트를 설치하고 다음을 설정합니다:

프로젝트 소유자를 위한 SSH 사용자 — 키(디바이스 키)로만 로그인하며 sudo는 비밀번호 없이 사용
.flock 파일의 WiFi 설정(NetworkManager 사용)
로그인 배너

설치할 내용을 알려 주고, 실행하기 전에 묻습니다. 무인 보안 업그레이드는 건드리지 않으며, --reboot를 지정하지 않는 한 디바이스를 재부팅하지 않습니다. 변경한 모든 내용은 /opt/ironflock/device-init/installed.json에 기록되므로 agent remove가 정확히 그 변경만 되돌립니다:


sudo ironflock agent remove

ironflock agent install의 추가 옵션:

--yes — 질문 없이 기본값 사용
--disable-suspend — 디바이스가 절전 모드로 들어가지 않게 함
--reboot — 설치가 끝나면 디바이스 재부팅
--http-proxy, --https-proxy, --no-proxy, --proxy-password-file — 설치, Docker, 에이전트가 프록시를 거치게 함
--download-base — 다른 서버에서 다운로드(다운로드 베이스 참조)

설치된 디바이스에 다른 .flock 파일을 적용하려면 sudo ironflock agent configure -c new.flock을 실행하세요. 모든 명령과 옵션은 디바이스 에이전트 명령에서 설명합니다.

디바이스에서 에이전트는 /opt/ironflock/device-agent에 있으며 systemd 서비스 ironflock-device-agent로 실행됩니다. sudo ironflock status 또는 systemctl status ironflock-device-agent로 상태를 확인하세요. 로그는 sudo ironflock agent logs로 읽을 수 있으며, journalctl -u ironflock-device-agent와 /var/log/ironflock/device-agent.log에도 있습니다. 설정 파일은 /opt/ironflock/device-agent/device-config.flock이며(root만 읽을 수 있고 /boot에는 더 이상 사본이 없습니다), Docker는 데이터를 /opt/ironflock/device-agent/docker-apps에 두고, 앱 데이터는 계속 /apps에 있습니다.

에이전트는 스스로 업데이트하며 별도의 업데이트 관리자는 없습니다. 업데이트는 서명되고 검증되며, 실패한 업데이트는 자동으로 롤백됩니다. 업데이트는 에이전트가 시작될 때, 사용자가 Studio에서 업데이트를 시작할 때, 또는 디바이스에서 sudo ironflock agent update를 실행할 때만 적용됩니다.

2026년 10월 이전에 설치된 디바이스는 /opt/reagent와 서비스 reagent.service를 사용했습니다. 이런 디바이스가 에이전트 1.3.x를 실행하면 위 구성으로 스스로 이동하며(Docker와 앱은 한 번 다시 시작됩니다), /opt/reagent는 링크로 남습니다.

회사 프록시 환경에 있나요? 설치 프로그램 다운로드에도 프록시를 지정하고, 3단계의 인자에 --http-proxy / --https-proxy를 추가하면 ironflock agent install이 Docker와 에이전트를 대신 구성합니다. 전체 명령과 기업 CA 절차는 회사 프록시 환경 사용에서 확인하세요.

내 컴퓨터에서 SSH로 설치하기

직접 사용하는 Linux 또는 macOS 컴퓨터에 ironflock을 설치하면, 먼저 디바이스에 로그인하지 않고도 디바이스를 연결할 수 있습니다. --host는 SSH로 디바이스에서 명령을 실행하며 .flock 파일도 함께 가져가므로, 복사할 것이 없습니다:


ironflock --host user@device-ip agent install -c mydevice.flock

로그인 계정은 root이거나 디바이스에서 sudo를 사용할 수 있어야 합니다. --host는 컴퓨터의 ssh를 사용자의 키와 ~/.ssh/config로 사용합니다. 디바이스에 ironflock 명령을 남기지 않으며, 이후의 명령도 같은 방식으로 컴퓨터에서 실행합니다. 예: ironflock --host user@device-ip status. SSH를 통한 원격 머신을 참조하세요.

선택 사항: 설치 프로그램 먼저 검증하기

root로 실행되기 전에 스크립트를 확인하려면, 서명과 함께 다운로드하여 IronFlock 부트스트랩 키로 검증하세요:


curl -fsSLO https://instance-registry.ironflock.com/dl/cli/install.sh
curl -fsSLO https://instance-registry.ironflock.com/dl/cli/install.sh.asc
curl -fsSL https://instance-registry.ironflock.com/dl/cli/ironflock-bootstrap.asc | gpg --import
gpg --verify install.sh.asc install.sh

gpg가 IronFlock Bootstrap <[email protected]>의 올바른 서명이며 지문이 F6C9 4D96 CE31 5377 ACA7 C8EA 4990 5433 7321 2788라고 보고해야 합니다. 그런 다음 검증된 스크립트를 실행하세요:


sudo bash install.sh agent install -c mydevice.flock

Windows 장치

장치에 Docker Desktop 를 설치하고 Docker Desktop 설정에서 Start Docker Desktop when you sign in 을 활성화하세요. 무인 장치의 경우 재부팅 후 로그인 없이도 Docker를 사용할 수 있도록 Windows 자동 로그인도 설정하세요.
장치에서 device-agent.exe 를 다운로드하세요. 브라우저가 파일을 다운로드 폴더에 저장합니다.
.flock 파일을 장치에 복사하여 같은 다운로드 폴더에 넣으세요.
관리자 권한으로 PowerShell을 여세요. 시작 메뉴를 열고 PowerShell 을 입력한 다음 관리자 권한으로 실행 을 선택하고, 사용자 계정 컨트롤 확인 창에서 예 를 클릭하세요. 창 제목이 “관리자:“로 시작해야 합니다. 일반 PowerShell 창에서는 this command must be run from an elevated (Administrator) prompt 메시지와 함께 설치가 중단됩니다.
관리자 PowerShell은 C:\Windows\System32 에서 시작됩니다. 다운로드 폴더로 이동하여 두 파일이 모두 있는지 확인하세요:
```
cd $env:USERPROFILE\Downloads
dir device-agent.exe, *.flock
```
에이전트를 Windows 서비스로 설치하고 시작하세요:
```
.\device-agent.exe service install -config .\myaccount_myproject_mydevice.flock
```
myaccount_myproject_mydevice.flock 을 실제 파일 이름으로 바꾸세요. Studio는 프로젝트 소유자, 프로젝트, 장치 이름으로 파일 이름을 짓습니다. 이름의 처음 몇 글자를 입력하고 Tab 키를 누르면 자동 완성됩니다. device-agent.exe 앞의 .\ 를 빼지 마세요. PowerShell은 이것이 있어야만 현재 폴더의 프로그램을 실행합니다.

ironflock-device-agent 서비스는 즉시 시작되며 이후 부팅할 때마다 시작되고, 오류 발생 시 자동으로 재시작되며 에이전트를 최신 상태로 유지합니다. 시작하지 않고 설치하려면 -noStart 를 추가하세요. 설치 프로그램이 device-agent.exe 와 .flock 파일을 에이전트 폴더로 복사하므로, 이후 다운로드 폴더에서 두 파일을 모두 삭제해도 됩니다.

디바이스에서 에이전트는 %ProgramData%\IronFlock\DeviceAgent에 있습니다. 여기에는 device-agent.exe, 설정 파일 device.flock, 로그 device-agent.log, 그리고 apps\ 아래의 앱 데이터가 들어 있습니다. 업데이트는 서명되고 검증되며, 실패한 업데이트는 자동으로 롤백됩니다. 업데이트는 에이전트가 시작될 때 또는 사용자가 Studio에서 업데이트를 시작할 때만 적용됩니다.

에이전트 확인 및 로그 보기

에이전트 폴더는 관리자만 읽을 수 있으므로 이 명령들도 관리자 PowerShell에서 실행하세요. 서비스가 실행 중인지 확인합니다:


Get-Service ironflock-device-agent

Status 가 Running 이어야 합니다. 에이전트 로그의 마지막 100줄을 표시하고, 에이전트가 새 줄을 쓸 때마다 계속 출력합니다:


Get-Content "$env:ProgramData\IronFlock\DeviceAgent\device-agent.log" -Tail 100 -Wait

로그 추적을 멈추려면 Ctrl+C 를 누르세요. 로그에서 오류만 검색하려면:


Select-String -Path "$env:ProgramData\IronFlock\DeviceAgent\device-agent.log" -Pattern "error" | Select-Object -Last 20

에이전트를 다시 시작하려면 에이전트 자체 명령을 사용하세요. 에이전트가 다시 실행될 때까지 장치는 오프라인 상태입니다:


& "$env:ProgramData\IronFlock\DeviceAgent\device-agent.exe" service stop
& "$env:ProgramData\IronFlock\DeviceAgent\device-agent.exe" service start

에이전트에는 Restart-Service 를 사용하지 마세요. 에이전트가 중지되는 데 최대 15초가 걸릴 수 있으며, Restart-Service 는 그 전에 포기하고 서비스를 중지된 상태로 둘 수 있습니다.

에이전트 1.4.0 이전에 설치된 Windows 디바이스는 %ProgramData%\IronFlock\Reagent와 서비스 reagent를 사용했습니다. 에이전트 1.4.0은 이런 디바이스를 위의 구조로 옮기며, 에이전트와 앱은 한 번 재시작됩니다.

회사 프록시 환경인가요? service install 명령에 -proxy http://proxy.example.com:3128 를 추가하고, Docker Desktop의 프록시는 Settings → Resources → Proxies 에서 설정하세요. 자세한 내용과 회사 CA 설정 단계는 회사 프록시 환경 사용 을 참조하세요.

도메인에 가입된 Windows 장치인가요? 에이전트 서비스는 로그인한 사람이 있든 없든 LocalSystem으로 실행되므로, 로그인한 사용자에 연결된 방화벽 규칙은 이 서비스에 적용되지 않습니다. 규칙을 장치의 컴퓨터 계정을 기준으로 설정하도록 요청하세요 — ID 인식 방화벽 및 프록시를 참조하세요.

시간 동기화 (NTP)

디바이스 에이전트에는 정확한 시계가 필요합니다. 플랫폼과의 TLS 핸드셰이크, 이미지 다운로드를 인가하는 토큰, 그리고 디바이스가 발행하는 모든 데이터 포인트의 타임스탬프가 여기에 의존합니다. 시계가 15분 넘게 어긋난 디바이스는 파일 저장소에서도 CLOCK_SKEW로 거부됩니다.

기업 네트워크에서 이것은 당연히 갖춰진 것이 아니라 설정 단계입니다. UDP 123 포트의 아웃바운드 NTP가 흔히 차단되어 운영체제에 기본 설정된 공용 시간 서버에 도달할 수 없고, 시계는 아무런 오류 표시 없이 어긋납니다. IT 부서에 내부 시간 서버를 확인해 디바이스에 설정하거나, 디바이스 네트워크에 대해 아웃바운드 UDP 123을 허용하도록 요청하십시오.

Linux

systemd-timesyncd 사용 시 (Debian 및 Ubuntu 기본값):


sudo mkdir -p /etc/systemd/timesyncd.conf.d
sudo tee /etc/systemd/timesyncd.conf.d/corporate.conf > /dev/null <<'EOF'
[Time]
NTP=ntp.your-company.com
EOF
sudo systemctl restart systemd-timesyncd
timedatectl status

chrony 사용 시:


echo "server ntp.your-company.com iburst" | sudo tee -a /etc/chrony/chrony.conf
sudo systemctl restart chrony
chronyc sources

timedatectl status가 System clock synchronized: yes를 보고해야 합니다.

Windows

관리자 권한 프롬프트에서:


w32tm /config /manualpeerlist:"ntp.your-company.com" /syncfromflags:manual /update
w32tm /resync
w32tm /query /status

완성된 IronFlock 이미지로 플래싱한 디바이스(방법 1과 2)는 기본적으로 공용 시간 서버와 동기화합니다. 이를 차단하는 네트워크에서는 디바이스 서브넷에 대해 아웃바운드 UDP 123을 허용하거나, 첫 부팅 후 SSH로 위의 Linux 예시와 똑같이 내부 시간 서버를 설정하십시오.

연결 확인

연결 후 프로젝트에서 디바이스 상태를 확인합니다:

녹색 표시기 — 디바이스가 온라인 상태이며 IronFlock과 통신 중입니다.
빨간색 표시기 — 디바이스가 오프라인 상태입니다. 네트워크 연결을 확인하고 에이전트가 실행 중인지 확인하십시오.
녹색 표시기이지만 앱 설치, 이미지 가져오기 또는 에이전트 업데이트가 타임아웃되는 경우 — 방화벽 규칙이 디바이스의 새 연결을 더 이상 허용하지 않고 있을 수 있습니다. 무엇이든 재시작하기 전에 ID 인식 방화벽 및 프록시를 읽어 보십시오.

디바이스 지도 보기에서 프로젝트의 모든 디바이스의 지리적 위치를 확인할 수 있습니다.