운영
로컬 운영
어플라이언스를 온라인 상태로 유지하지 않으려는 경우에도, 동일 로컬 네트워크상의 브라우저에서 어플라이언스의 IP 주소 또는 호스트네임으로 언제든지 접근할 수 있습니다:
http://<appliance-host>admin 사용자로 로그인하십시오:
- 사용자 이름:
admin - 비밀번호: 어플라이언스용으로 생성된 초기 admin 비밀번호
설치 프로그램은 설치가 끝날 때 이 비밀번호를 표시합니다. 이 비밀번호는 어플라이언스 호스트의 /opt/ironflock/.env에도 APPLIANCE_ADMIN_PASSWORD로 저장되며, 이 파일은 root만 읽을 수 있습니다:
sudo grep '^APPLIANCE_ADMIN_PASSWORD=' /opt/ironflock/.env첫 로그인 후 비밀번호를 변경하십시오.
admin 비밀번호를 잊어버렸다면 어플라이언스 호스트에서 다음 명령을 실행하여 새 비밀번호를 설정하십시오. 명령이 새 비밀번호를 표시합니다:
curl -fsSL https://instance-registry.ironflock.com/dl/appliance/install_ironflock.sh \
| sudo bash -s -- --reset-admin-password이전 어플라이언스: 설치 프로그램이 admin 비밀번호를 생성하기 전에 설치된 어플라이언스는
ironflock비밀번호로 시작합니다. 이 비밀번호로 처음 로그인하면 새 비밀번호를 설정하라는 메시지가 표시됩니다.
앱 웹 UI
연결된 디바이스의 앱이 웹 인터페이스를 노출하면, 어플라이언스는 내장 터널을 통해 이를 접근 가능하게 만듭니다. 기본 상태에서는 회사 IT에서 필요한 것이 아무것도 없습니다 — 각 앱 UI는 어플라이언스 주소의 자동으로 할당된 포트에서 일반 HTTP로 게시되며(http://<appliance-host>:<port>), IronFlock UI에 해당 링크가 표시됩니다. 접근은 여전히 어플라이언스 로그인으로 보호됩니다.
공유 회사 네트워크에서 신뢰할 수 있는 https:// URL이 필요한 경우 — 회사 CA의 와일드카드 인증서 또는 TLS를 종단하는 리버스 프록시 사용 — 앱 UI 및 HTTPS를 참조하십시오.
계정 연결
어플라이언스의 프로젝트 설정에서 팀원을 이메일로 초대하여 로컬 사용자 계정을 생성합니다. 초대 이메일에는 초대받은 사람에게 필요한 모든 것이 포함되어 있습니다:
- 개인 연결 링크 — ironflock.com에서 이 링크를 열면 초대받은 사람의 ironflock.com 계정이 어플라이언스에 연결됩니다. 아직 ironflock.com 계정이 없다면 먼저 초대받은 이메일 주소를 사용하여 계정을 생성합니다(두 이메일 주소가 일치하는 경우에만 연결이 허용됩니다). 연결이 완료되면 어플라이언스가 해당 사용자의 ironflock.com 프로젝트 선택기에 표시되며 즉시 원격으로 작업할 수 있습니다 — 수동 키 입력도, 로컬 가입도 필요 없습니다.
- 로컬 가입 링크 — 선택 사항: 로컬 가입을 완료하면 추가로 어플라이언스 UI(
http://<appliance-host>)에 직접 로그인할 수 있습니다.
알아두면 좋은 사항:
- 기존 로컬 사용자는 프로젝트 소유자의 새 초대가 필요 없습니다. 어플라이언스 UI에서 자신의 프로필을 열고 ironflock.com에 연결 섹션에서 연결 링크를 이메일로 보내기를 클릭하면 됩니다.
- 재발송: 동일한 이메일 주소를 다시 초대하면(또는 프로필의 버튼을 다시 클릭하면) 새 연결 링크가 발급됩니다. 가장 최근 이메일에 포함된 링크만 유효합니다.
- 어플라이언스가 이메일을 보낼 수 없는 경우 — 예를 들어 메일 릴레이를 차단하는 제한된 회사 네트워크의 경우 — 연결 링크가 대신 UI에 직접 표시됩니다. 초대한 사람이 링크를 복사하여 원하는 채널로 전달하면 됩니다. 링크는 인터넷에 접속 가능한 브라우저에서 열어야 합니다.
- 연결 해제: 사용자는 ironflock.com의 Profile → Instances → 연결된 인스턴스에서 언제든지 연결을 제거할 수 있습니다. 가장 최근의 연결 링크를 다시 열면 연결이 복원됩니다.
인스턴스 소유자 — ironflock.com에서 Instance Key를 생성한 사용자 — 는 인스턴스의 로컬 admin 계정에 자동으로 연결되므로, 소유자에게는 초대가 필요하지 않습니다.
온라인 스토어에서 앱 동기화
Appliance에는 로컬 네트워크상의 디바이스에 앱을 제공하는 프라이빗 앱 카탈로그 및 컨테이너 레지스트리인 local App Store가 포함되어 있습니다. 동기화 시점에 Appliance가 인터넷에 연결되어 있다면 공개 온라인 IronFlock Store에서 앱을 동기화하여 이 로컬 스토어를 채울 수 있습니다. 영구적인 인터넷 연결은 필요하지 않으며, 필요한 앱을 가져오기 위한 일시적인 연결만으로도 충분합니다.
사전 요건
- 공개 ironflock.com 플랫폼의 계정.
- 어플라이언스 계정이 ironflock.com 계정과 연결되어 있어야 합니다(계정 연결 참조). 인스턴스 소유자의 admin 계정은 자동으로 연결됩니다.
앱 동기화 작동 방식
┌────────────────────┐ ┌────────────────────┐
│ Online IronFlock │ ◄──── account ─────► │ Appliance │
│ Store (cloud) │ connection │ local Store │
└────────────────────┘ └────────────────────┘
│ │
apps available to sync button shown
the connected account instead of install- local App Store 열기 — Appliance에 활성 인터넷 연결이 있는 경우, App Store에는 연결된 ironflock.com 계정이 온라인 플랫폼에서 사용할 수 있는 모든 앱이 표시됩니다.
- 필요한 앱 동기화 — 각 앱에는 Install 버튼 대신 Sync 버튼이 표시됩니다. 이를 클릭하면 컨테이너 이미지와 메타데이터를 포함한 앱이 온라인 스토어에서 로컬 스토어로 다운로드됩니다.
- 디바이스 추가 — 동기화가 완료되면 앱은 로컬 스토어에서 완전히 사용 가능해지며, 인터넷 연결 없이도 평소처럼 디바이스를 추가할 수 있습니다.
업데이트 워크플로
동기화된 앱의 새 버전이 온라인 스토어에 게시되면 해당 앱에 다시 Sync 버튼이 나타납니다. Appliance를 잠시 인터넷에 연결하여 업데이트된 릴리스를 동기화한 다음, 표준 앱 업그레이드 플로우를 통해 디바이스에 롤아웃하십시오.
이러한 설계는 네트워크에 들어오는 항목에 대한 완전한 제어권을 제공합니다. 자동으로 다운로드되는 것은 없으며, 인터넷 연결은 동기화 단계에서만 필요합니다.
사용자 지정 이메일 발신자 (SMTP)
기본적으로 계정 확인, 비밀번호 복구, 초대, 알람 알림을 포함한 모든 플랫폼 이메일은 IronFlock 클라우드 SMTP 프록시를 통해 전달되며 [email protected]으로 표시됩니다. 이메일이 회사에서 보낸 것처럼 표시되도록 하려면 어플라이언스를 자체 SMTP 서버로 연결할 수 있습니다.
어플라이언스 호스트에서 설치 프로그램이 생성한 환경 파일 /opt/ironflock/.env를 편집하고 다음 변수를 설정합니다:
SMTP_CONNECTION_URI=smtps://USERNAME:[email protected]:465/
SMTP_FROM_ADDRESS=[email protected]
SMTP_FROM_NAME=Your Company- 암묵적 TLS의 경우
smtps://(일반적으로 포트465)를, STARTTLS의 경우smtp://(포트587)를 사용하십시오. - 사용자 이름 또는 비밀번호의 특수 문자는 URL 인코딩해야 합니다 (예:
@→%40). SMTP_FROM_ADDRESS와SMTP_FROM_NAME은 수신자가 각 플랫폼 이메일의 보낸 사람 헤더에서 보게 되는 값입니다.
스택을 재시작하여 변경 사항을 적용합니다:
sudo systemctl restart ironflock.service재시작 후 모든 인증 이메일, 플랫폼 알림 및 알람 이메일은 회사의 발신자 주소와 표시 이름을 사용하여 자체 SMTP 서버를 통해 전송됩니다.
SMTP_CONNECTION_URI가 설정되지 않은 경우, 어플라이언스는 라이선스 키로 인증된 IronFlock 클라우드 SMTP 프록시를 통해 계속 이메일을 라우팅합니다 — 추가 설정은 필요 없지만, 이메일에는 IronFlock 브랜딩이 표시됩니다.
유지 관리
어플라이언스의 IronFlock 시스템을 업데이트하려면, 새 버전이 제공될 때마다 admin이 자신의 프로필 라이선스 섹션에 있는 업데이트 버튼을 사용할 수 있습니다. 업데이트를 다운로드하려면 어플라이언스에 인터넷 연결이 필요합니다. 업데이트가 완료되면 IronFlock이 자동으로 재시작됩니다.
Linux OS 업데이트의 유지 관리는 사용자의 책임입니다.
라이선스 라이프사이클
라이선스는 하나의 물리적 어플라이언스에 종속됩니다. 동일한 라이선스로 서로 다른 하드웨어에서 두 번째 IronFlock 인스턴스를 동시에 실행할 수 없습니다. 일상적인 운영에서 어플라이언스는 오프라인으로 동작합니다 — 프로덕션 데이터, 대시보드, 앱 관리, 엣지 디바이스 제어가 모두 박스 내부에 로컬로 유지됩니다.
어플라이언스가 인터넷을 필요로 하는 시점
인터넷 연결은 다음과 같은 경우에만 필요합니다:
- 최초 설치 및 어플라이언스 업데이트 — 어차피 IronFlock 배포 서버에서 소프트웨어를 가져와야 하므로 필요하며, 같은 단계에서 라이선스가 활성화됩니다.
- 주기적 라이선스 재확인 — 플랜에 따라 다릅니다:
- 월간 라이선스: 30일마다 한 번.
- 연간 라이선스: 365일마다 한 번.
- 영구 라이선스: 주기적 재확인 없음 — 설치 및 업데이트 시에만 인터넷이 필요합니다.
- 새 하드웨어로의 라이선스 이전 (아래 참조).
- AI Multi Agent 서비스 — 실제로 사용 중인 동안에만 필요합니다.
유예 기간 및 잠금
주기적 재확인이 클라우드에 도달하지 못하는 경우(네트워크 장애, 일시적인 클라우드 오류), 어플라이언스는 7일의 유예 기간에 진입합니다. 유예 기간 동안 어플라이언스는 정상적으로 계속 실행되며 자동으로 재시도합니다.
7일이 모두 지나도 재확인이 성공하지 못하면, 어플라이언스는 스스로 잠깁니다: 대부분의 작업이 거부되고 UI에 라이선스가 유효하지 않은 것으로 표시됩니다. 복구하려면 어플라이언스의 인터넷 연결을 복원한 다음, 어플라이언스 UI(로컬 http://<appliance-host> 화면 또는 ironflock.com을 통해 접근하는 인스턴스)의 프로필 내 라이선스 패널에서 지금 재검증을 클릭하십시오.
새 하드웨어로 라이선스 이전 (핸드오버)
라이선스는 하나의 머신 하드웨어 지문에 바인딩됩니다. 다른 머신으로 옮기려면 IronFlock 클라우드 프로필에서 핸드오버를 시작합니다:
- ironflock.com에서 Profile → Instances를 엽니다.
- 이전하려는 인스턴스에서 하드웨어 지문 재설정을 클릭합니다.
핸드오버를 위해서는 현재 바인딩된 어플라이언스가 온라인 상태여야 합니다. 클라우드가 해당 어플라이언스로 다시 연결하여 로컬 측에서 스스로 폐기하도록 요청한 후에야 클라우드 측 지문을 해제합니다. 이 핸드셰이크는 새 어플라이언스가 바인딩되는 동안 기존 어플라이언스가 계속 실행될 수 없도록 보장하여 동일 라이선스의 우발적 이중 사용을 방지합니다.
해제가 성공하면:
- 동일한 인스턴스 키를 사용하여 설치 단계에 따라 새 하드웨어를 설정합니다.
- 새 어플라이언스가 검증되어 자체 지문을 바인딩하고 활성 디바이스가 됩니다.
기존 하드웨어가 고장났거나 접근할 수 없는 경우
이전에 바인딩된 어플라이언스가 죽었거나 그 외의 이유로 도달할 수 없는 경우 핸드셰이크가 타임아웃되며 클라우드 UI에 appliance_unreachable_contact_support가 표시됩니다. 이 경우 IronFlock 팀에 문의하십시오 — 소유권을 확인한 후 바인딩을 수동으로 해제해 드릴 수 있습니다.
팁: 기존 하드웨어가 아직 온라인 상태일 때, 즉 폐기하기 전에 핸드오버를 트리거하십시오. 기존 어플라이언스에 여전히 접근할 수 있을 때 프로세스가 훨씬 빠르며 — 사용자와 저희 지원팀 모두에게 그렇습니다.