제III부
서버를 하나의 플릿으로 연결한 다음, Mac, Linux 및 BSD 서버, Raspberry Pi, Windows 호스트까지 모두 하나의 윈도우에서 네트워크를 구성하고, 강화하고, 모니터링합니다.
제8장
서버 연결: 위치와 플릿
Mac 한 대는 시작에 불과합니다. FrontierStack은 SSH를 통해 운영 중인 다른 모든 서버에 연결하며, 그때 자신이 네트워크의 어디에 있는지도 파악합니다.
지금까지는 눈앞에 있는 Mac에 관한 내용이었습니다. 매뉴얼의 이 부분에서는 시야를 관리 대상 전체로 넓힙니다. 랙에 설치된 Linux 서버, 아직 macOS Server를 실행 중인 오래된 Xserve, 선반 위의 Raspberry Pi, 클라우드 VPS, 심지어 Windows 호스트까지 포함됩니다. 각 서버는 SSH로 한 번만 연결하면 되며, 그 이후 FrontierStack은 이들을 하나의 플릿으로 취급하여 진단을 실행하고, 명령을 여러 서버에 일괄 실행하고, 사이트를 배포하고, 상태를 감시합니다. 또한 이 Mac이 네트워크상 어디에 있는지도 추적하므로, 집과 사무실, 카페를 오가는 노트북이 지금 단지 보이지 않을 뿐인 서버에 대해 잘못된 경보를 울리지 않습니다.
이 장에서는 플릿의 연결과 운용을 다룹니다. 네트워크와 경계 보안은 9장, 보안 강화와 보안 감사는 10장, 지속적인 모니터링과 알림은 11장에서 더 자세히 다룹니다. AI 관리자는 같은 도구를 사용하여 여기 나오는 거의 모든 작업을 수행할 수 있습니다. 13장을 참조하십시오.
8.1위치 및 장소
위치 및 장소 ▸ 위치를 여십시오. 위치는 단순히 이름이 붙은 네트워크(집, 사무실, VPN 연결 중 등)이며, 여러 신호로 인식됩니다. Wi-Fi SSID, 라우터(게이트웨이) MAC 주소, Wi-Fi BSSID, IP 주소의 서브넷 접두사(예: 192.168.1.), 공인 IP 대역, 그리고 VPN 연결 여부입니다. 헤더에는 현재 위치(현재: 사무실)가 표시되고, 그 아래에 Wi-Fi 이름, IP, 게이트웨이, VPN 상태로 구성된 실시간 스냅샷이 표시됩니다. 감지는 30초마다 실행됩니다.
FrontierStack이 인식하지 못하는 네트워크를 발견하면 새 네트워크가 감지됨 배너를 표시합니다. 추가…를 클릭하여 저장하십시오. 현재 네트워크를 위치로 추가를 누른 다음 조건을 세부 조정할 수도 있습니다. 위치는 설정된 조건이 모두 충족될 때 일치하며(SSID와 라우터 MAC은 그중 하나만 일치하면 됨), 비워 둔 필드는 무시됩니다. 여러 위치가 일치하면 목록의 첫 번째 항목이 아니라 가장 구체적인 위치가 선택됩니다. 자동 감지 대신 위치를 수동으로 고정하려면 모드 선택기를 사용하십시오. 신호가 모호할 때 유용합니다.
모든 신호의 신뢰도가 같지는 않으며, 이는 생각보다 중요합니다. 서브넷 접두사는 식별자가 아닙니다. 가정용 라우터, 카페, 호텔은 어디서나 192.168.1.× 주소를 할당하므로, 서브넷만으로 정의된 위치는 전혀 다른 건물에서도 그대로 일치해 버립니다. 라우터 MAC은 가장 강력한 신호입니다. 하나의 하드웨어에 고유하며 특별한 권한 없이 읽을 수 있습니다. 그래서 라우터 일치 기능이 생기기 전에 저장된 위치는 현재 네트워크에서 모든 조건 업데이트를 클릭 한 번으로 바로잡을 수 있습니다.
8.25.1GPS로 장소 고정
두 장소가 실제로 같은 서브넷을 사용하고 MAC 주소를 일일이 다루고 싶지 않은 까다로운 경우에는 위치에 GPS 핀을 추가할 수도 있습니다. 해당 장소에서 위치를 열고 이 지점 고정(GPS)을 누르십시오. 반경 슬라이더로 어디까지를 “여기”로 볼지 설정합니다(기본값 150 m. 실내 측위는 정밀하지 않고, 장소는 점이 아니라 건물이기 때문입니다).
핀은 필수 조건이 아니라 교차 확인용입니다. 핀은 두 가지 역할을 합니다. 약한 일치를 확인해 주고, 더 유용하게는 잘못된 일치를 거부합니다. 따라서 집이 우연히 같은 서브넷을 쓰는 카페를 자기 위치라고 주장하지 않게 됩니다. 이 기능이 감지를 결코 악화시키지 않도록, 공유될 수 있는 조건(서브넷, VPN 연결 여부)만으로 식별된 위치는 현재 위치 정보가 있고 그것과 모순될 경우 더 이상 확인됨으로 보고되지 않습니다. 확신에 찬 잘못된 답 대신 외부 / 알 수 없음이 표시됩니다.
기기도 위치에 속합니다. 기기 검색에서 모니터링 중인 기기의 ⋯ 메뉴 ▸ 위치에 할당을 선택하면 특정 장소에 배치됩니다. 자동으로 두면 해당 서브넷을 소유한 위치에 자동으로 속하게 됩니다. 기기 자체의 패널에서도 설정할 수 있으며, 각 위치의 행에는 해당 위치에 할당된 기기가 나열됩니다. 사설 서브넷은 장소마다 반복되므로, 다른 곳에 고정된 기기가 서브넷에 의해 어떤 위치에 들어갈 수 있습니다. 그 목록에서 기기의 ×를 누르거나 위치 없음을 선택하면 제거되며, 일치하는 서브넷이 있어도 다시 추가되지 않습니다. Mac이 인식된 위치에 도착하면 FrontierStack은 해당 기기들을 확인하고(VPN 등을 통해 최근에 확인된 기기는 건너뜀) 각각의 상태를 표시합니다. 녹색은 연결 가능, 빨간색은 이곳에 있어야 하지만 응답이 없음, 주황색은 이 Mac이 도달할 수 없는 Wi-Fi 구간에 있음을 뜻합니다. 주황색은 대개 다른 액세스 포인트나 대역에 있는 경우로, 예를 들어 Mac은 5 GHz에 연결되어 있는데 센서는 2.4 GHz 전용인 경우입니다. 주황색은 “사라짐”이 아니라 “여기서는 확인할 수 없음”을 의미합니다.
연결된 서브넷. 위치는 Mac이 직접 연결되어 있지 않은 서브넷의 기기도 가질 수 있습니다. 연결된 서브넷 필드에 10.20.0.0/24 같은 IPv4 CIDR을 입력하거나, tailnet의 서브넷 경로를 나열하는 Tailscale 경로 메뉴에서 고르십시오. Tailscale 서브넷 라우터를 통해 접근하는 원격 사이트에 그 사이트의 기기를 배치하는 방법입니다. 연결된 서브넷은 기기 배치에만 쓰이며, 다른 위치의 비슷해 보이는 서브넷 접두사보다 우선합니다. 라우팅된 서브넷은 어디서나 응답하므로 Mac이 그 위치에 “있다”고 판별되지는 않습니다. tailnet의 100.x 주소는 tailnet 전체에 흩어져 있으므로 해당 기기는 직접 할당하십시오.
같은 주소, 다른 하드웨어. 두 사이트가 모두 192.168.0.1에 라우터를 둘 수 있으므로, FrontierStack은 주소만 믿지 않고 하드웨어(MAC) 주소로 라우터와 기기를 식별합니다. 고정된 라우터는 MAC이 일치할 때만 작동 중으로 보며, 위치의 라우터 MAC과 일치하는 라우터는 그 위치에 속합니다. 라우터 MAC 없이 저장된 위치는 다음에 액세스 포인트(BSSID)나, Wi-Fi 이름과 핀 범위 안의 GPS 위치로 식별될 때 MAC을 자동으로 기록합니다. 트래블 라우터는 어디서나 같은 이름을 쓰므로 Wi-Fi 이름만으로는 기록하지 않습니다. 기기의 주소가 바뀌면(대개 새 DHCP 임대), MAC을 아는 고정된 기기가 신뢰하는 위치의 LAN에서 응답하지 않을 때 그 서브넷 전체에서 MAC을 찾아 새 주소로 고정을 옮깁니다(Followed by MAC from …). 이 확인은 서브넷마다 최대 5분에 한 번이며, 찾지 못하는 동안에는 간격을 1시간까지 늘립니다.
이 모든 것의 목적은 위치 기반 모니터링 섹션입니다. 개요 ▸ 알림에서 기기, Wi-Fi 네트워크, Cloudflare 영역 또는 감시 항목을 중요 항목으로 표시한 다음, 여기에서 범위를 사무실에서만으로 지정하십시오. 그러면 그 검사는 다른 모든 곳에서 일시 중지됩니다. 호텔에 있을 때 NAS가 DOWN으로 울리지 않고, 회사에 있을 때 집 Wi-Fi가 끊겼다는 알림도 오지 않습니다. 일시 중지된 항목은 돌아오면 조용히 재개됩니다. 위치 자체가 바뀌면 FrontierStack은 로컬 알림을 게시하거나, 메시징 게이트웨이를 통해 “📍 현재 위치: 사무실” 알림을 보내거나, 둘 다 할 수 있습니다.
get_location 도구로 이 정보를 읽을 수 있습니다. 활성 위치, 그 위치가 결정된 방식(고정 또는 자동 감지), 실시간 스냅샷, 그리고 설정된 모든 위치의 조건입니다. AI 관리자는 이를 바탕으로 LAN 전용 서비스가 현재 위치에서 연결 가능한지, 아니면 외부에서 VPN으로 접속 중인지를 판단합니다.8.2SSH로 서버 연결
서버는 서버 연결 시트를 통해 플릿에 합류합니다. 이 시트는 기기 패널, 기기 검색, 또는 클라우드 서버 및 원격 도구 패널에서 열 수 있습니다. 이름, 호스트 또는 IP, 포트, SSH 사용자 이름(root, ubuntu, ec2-user…), 로그인 암호를 입력하십시오. 이 암호는 단 한 번만 사용됩니다. 앱은 이 Mac의 관리형 SSH 키를 서버의 authorized_keys에 설치하고, 그 이후로는 키로만 연결합니다. 서버 주소 외에는 아무것도 저장되지 않으며, 암호는 폐기됩니다.
암호 로그인이 없는 키 전용 서버의 경우 암호를 사용할 수 없습니까? 키를 수동으로 설치를 펼치고, 표시된 공개 키를 서버의 authorized_keys에 직접 복사한 다음 연결하십시오. 모니터링 헬퍼도 설치를 선택하면 같은 단계에서 호스트 모니터도 설정됩니다(아래에서 설명).
Windows 서버와 Tailscale 서버. OpenSSH를 실행하는 Windows PC도 같은 방법으로 연결됩니다. FrontierStack은 Windows 셸을 감지하고 PowerShell로 키를 설치합니다. 관리자 계정이면 C:\ProgramData\ssh\administrators_authorized_keys에(sshd가 요구하는 권한으로), 그렇지 않으면 사용자의 .ssh\authorized_keys에 설치합니다. 서버의 SSH 호스트 키는 FrontierStack 자체의 신뢰 저장소에 기록되므로, ~/.ssh/config가 일부 주소의 호스트 키를 버리도록 설정되어 있어도 연결할 수 있습니다(Tailscale용으로 UserKnownHostsFile /dev/null을 지정한 Host 100.* 규칙이 흔히 쓰입니다).
로그인 셸이 sh가 아닌 서버. FreeBSD의 root 계정(FreeBSD 13 이하에서는 csh 또는 tcsh), OPNsense의 콘솔 메뉴 셸, fish 사용자도 평소처럼 연결하고 명령을 실행할 수 있습니다. FrontierStack은 앱을 실행할 때마다 첫 명령 전에 서버의 로그인 셸을 한 번 확인합니다. sh와 호환되지 않으면 스크립트를 그 셸이 해석하게 두지 않고 그대로 /bin/sh에 넘깁니다. sh, bash, zsh, ksh, dash 서버에는 이전과 똑같이 명령을 보냅니다.
연결된 서버에는 연결 가능 여부를 나타내는 작은 녹색 또는 빨간색 상태 점이 표시됩니다. 서버를 재설치한 뒤나 키가 처음부터 설치되지 않은 경우처럼, 점이 빨간색으로 바뀌고 Permission denied (publickey)가 표시되면 AI 도구 repair_ssh_access가 오래된 호스트 키를 지우고 관리형 키를 다시 설치합니다. 이때 보관함 비밀 값으로 보관해 둔 일회용 로그인 암호를 사용합니다. 암호는 로컬에서 읽혀 키 접근을 다시 설치하는 데 쓰이며, 성공하면 점이 다시 녹색으로 바뀝니다.
Tailscale을 통해 LAN 서버에 연결. 서버에 저장된 주소가 이 Mac이 있는 곳에서 응답하지 않으면(외출 중인 상태에서 LAN 서버에 연결하는 경우 등) FrontierStack은 대신 그 서버의 Tailscale 주소로 연결하므로, 개요, 서비스, 로그 등 패널에서 SSH를 사용하는 모든 부분이 계속 동작합니다. 이때 패널 머리글에는 Tailscale 경유가 표시되고 연결 경로 행에 사용 중인 주소가 표시됩니다. 저장된 주소가 다시 응답하면 자동으로 원래대로 돌아갑니다. Tailscale 주소는 서버의 상태 확인이나 모니터에서 자동으로 알아내며, 서버 설정의 Tailscale 주소에 직접(IP 또는 MagicDNS 이름) 입력할 수도 있습니다. 어느 경로든 서버가 신뢰받는 것과 동일한 SSH 호스트 키를 제시해야 합니다.
호스트의 상태 섹션에는 연결 행도 표시됩니다. 서버의 기본 경로를 실제로 담당하는 연결을 보여 줍니다. 협상된 Ethernet 속도(10 GbE, 2.5 GbE, 1 GbE), 채널 폭을 포함한 Wi-Fi 세대(Wi-Fi 7 = 802.11be, Wi-Fi 6E/6/5), 또는 VPN 터널입니다. Linux, macOS, FreeBSD 호스트에서는 일반 상태 점검 중에 읽히고, 에이전트 전용 호스트에서는 호스트 모니터 에이전트(v1.17 이상)가 보고합니다. 이 Mac에도 같은 행이 표시되며, SNMP 기기에서는 인터페이스 조회 시 각 포트의 협상된 링크 속도가 나열됩니다.
각 서버에는 대화형 셸을 위한 연결 방식 설정(편집 시트에 있음)도 있습니다. 일반 SSH(기본값), mosh(SSH 설정으로 로그인한 다음 자체 UDP 전송으로 전환하므로, 잠자기, 네트워크 이동, 불안정한 연결에도 세션이 유지됩니다), 또는 실험적인 SSH3(QUIC/HTTP3 기반이며, 서버를 UDP 443의 비밀 URL 뒤에 숨길 수 있습니다) 중에서 선택할 수 있습니다. 셸 열기와 SSH 열기는 이 선택을 따르며, 상태 점검과 파일 전송은 항상 일반 SSH를 사용합니다. 두 클라이언트 모두 서비스 카탈로그에 있습니다(mosh는 Homebrew, SSH3는 Go로 설치).
repair_ssh_access 도구는 로컬 .env 보관함에서 이름으로 일회용 암호를 읽으며, 그 값은 AI 모델에 전송되지 않습니다.8.3관리형 키와 저장된 sudo 암호
키 접근으로 앱은 서버에 연결할 수 있지만, /var/log 읽기, Apache 구성 편집, 방화벽 다시 로드 같은 유용한 작업의 상당수는 서버의 root 권한이 필요합니다. FrontierStack은 이를 호스트별 sudo 암호로 처리하며, 이 암호는 macOS 키체인에 저장됩니다(일반 파일에는 절대 저장되지 않음). 서버를 연결할 때 자동으로 저장되며, 나중에 호스트 패널이나 원격 도구의 대상 섹션(Sudo 암호 필드)에서 설정하거나 변경할 수 있습니다.
root 전용 명령이 실행되면 헬퍼는 SSH 세션을 통해 저장된 암호로 sudo의 자격 증명 캐시를 미리 채운 다음 명령을 실행합니다. 저장된 암호가 없으면 root 작업은 암호 없는 sudo -n으로 대체되며, 그것이 설정되어 있지 않으면 단순히 “sudo 필요”라고 보고합니다. 비밀 값은 이름으로 참조되므로 여러 개를 보관할 수 있습니다. 예를 들어 .env 보관함에 서버마다 다른 MySQL 암호를 둘 수 있습니다.
sudo -S에 전달되며, AI 모델에 표시되거나 로그에 기록되지 않습니다. 필드를 비우면 폐기됩니다. 다른 호스트에 영향을 주지 않고 특정 호스트 하나만 다시 등록하거나 키를 다시 설정할 수 있습니다.8.4플릿 실행: 모든 노드에서 명령 하나 실행
플릿 및 원격 ▸ 플릿 실행은 하나의 작업을 연결된 모든 서버 또는 선택한 일부 서버에 동시에 실행하고, 호스트별 결과를 실시간으로 보여 줍니다. 대상을 선택하고(호스트를 켜고 끄며, 연결 가능 여부 점으로 어느 호스트가 작동 중인지 확인), 작업을 고른 다음 N대 서버에서 실행을 누르십시오. 모든 작업이 SSH를 통해 동시에 실행되고, 각 호스트의 결과가 아래에 표시되며 펼치면 전체 출력을 볼 수 있습니다.
작업은 OS를 인식합니다. 패키지 업데이트는 호스트에 따라 apt, dnf, pacman, zypper, apk 또는 brew로 매핑되고, 서비스 재시작은 systemd를 먼저 시도한 다음 Homebrew를 시도합니다. OS별 명령을 직접 작성할 필요가 없습니다.
| 작업 | 플릿 전체에서 수행하는 일 |
|---|---|
| 모든 패키지 업데이트 / 업그레이드 | 호스트 패키지 관리자의 update + upgrade를 실행합니다. 일괄 실행 전에 확인을 거칩니다. |
| 패키지 설치 | 지정한 패키지(예: htop)를 선택한 모든 호스트에 설치합니다. |
| 서비스 재시작 | 지정한 유닛(예: nginx)을 systemd 또는 brew로 재시작합니다. |
| 재부팅 필요 여부 확인 | 업데이트 후 재부팅을 기다리는 호스트를 보고합니다. |
| 디스크 사용량(df) | 플릿 전체에서 df를 한 번 실행하여 가득 차 가는 디스크를 찾아냅니다. |
| 가동 시간 및 부하 | 호스트별 가동 시간과 평균 부하를 표시합니다. |
| 저장소 git pull | 각 호스트의 지정한 경로에서 저장소를 pull합니다. 간단한 배포 방법입니다. |
| 사용자 지정 명령 | 선택한 모든 호스트에서 셸 명령을 그대로 실행합니다. 일괄 실행하기 전에 다시 확인하십시오. |
| PHP 버전 및 보안 수정 | 읽기 전용입니다. 각 호스트의 모든 PHP를 나열하고 php.net의 해당 브랜치 최신 릴리스와 비교합니다(아래 참조). |
플릿 실행은 구성 편차를 찾아내는 가장 빠른 방법입니다. 디스크 사용량이나 가동 시간 및 부하를 실행하여 호스트를 한눈에 비교하거나, 원격 도구(다음 절)의 파일 체크섬 및 상태 검사 도구를 사용하여 플릿 전체에서 달라진 구성을 찾으십시오.
PHP 버전 및 보안 수정은 PHP 보안 릴리스가 나올 때마다 생기는 질문, 즉 어느 서버에 아직 적용해야 하는지에 답합니다. 각 호스트의 모든 PHP(Homebrew, MacPorts, MAMP, Apple 기본 PHP, 배포판 패키지, SSH를 통한 OPNsense 또는 pfSense 펌웨어)를 나열하고, 호스트가 php-fpm, php-cgi, mod_php로 웹에 PHP를 제공하는지 표시하며, 각 설치를 php.net의 해당 브랜치 최신 릴리스와 비교합니다. 보안 릴리스보다 오래되었거나 더 이상 수정이 제공되지 않는 브랜치의 설치는 결과에 표시됩니다. 아무것도 변경하지 않습니다. 표시가 붙으면 AI 프롬프트 복사로 Claude Code, AI 관리자 또는 다른 에이전트용 프롬프트를 클립보드에 넣으십시오. 찾은 서버와 버전을 알려 주고, 각 서버의 설치 출처에서 한 번에 한 대씩 PHP를 업데이트하며 변경할 때마다 확인을 받고, PHP를 제공하는 서비스를 재시작해 새 버전을 확인하도록 에이전트에 요청하는 내용입니다.
8.5이 Mac 또는 서버에서 컨테이너 만들기
FrontierStack에서 컨테이너를 나열하는 곳에는 모두 Create Container… 버튼이 있으며, 어느 곳에서 누르든 같은 시트가 열립니다. 이 Mac의 Docker 패널, 호스트 선택기에서 연결된 서버를 고른 같은 패널, 그리고 서버 활동 윈도우의 Docker 탭이 그렇습니다. 만든 컨테이너는 시작한 곳의 대상에서 실행됩니다 — 로컬에서는 docker 바이너리를 통해, 서버에서는 이미 갖고 있는 SSH 연결을 통해 실행됩니다.
프리셋에서 시작하거나 빈 상태에서 시작하십시오. 프리셋에는 일반 이미지 — nginx, PostgreSQL, MySQL, Redis, 일회용 Ubuntu 셸 — 와 함께, n8n, Flowise, Langflow, Vaultwarden, Checkmk처럼 앱이 단일 컨테이너로 실행할 수 있는 모든 자체 호스팅 서비스가 포함됩니다. 하나를 선택하면 이미지, 포트, 볼륨, 환경 변수가 채워지며 모두 변경할 수 있습니다. docker-compose 스택이 필요한 서비스는 대신 이 Mac의 해당 서비스 패널에서 설치하며, 시트에 그 이름이 표시되므로 빠진 것처럼 보이지 않습니다.
| 필드 | 역할 |
|---|---|
| Image | 이미지 참조입니다. 대상에 이미 있는 이미지를 메뉴에서 고를 수 있습니다. |
| Name | 선택 사항이며, 대상에서 이미 사용 중인 이름과 겹치는지 확인합니다. |
| Published ports | 각 포트에는 127.0.0.1에 바인딩하는 This machine only 스위치가 있어, 명시하지 않는 한 포트가 네트워크에 노출되지 않습니다. |
| Volumes | 일반 이름은 Docker가 관리하는 볼륨이고, /로 시작하는 경로는 대상의 폴더입니다. |
| Environment | 어떤 변수든 비밀 값으로 표시할 수 있으며, 그러면 암호처럼 입력되고 미리 보기에서 숨겨집니다. |
| Advanced | 재시작 정책, 네트워크, 명령 재정의, 추가 Docker 인수, 백그라운드 실행 여부입니다. |
실제로 실행하기 전에 시트는 비밀 값을 점으로 가린 정확한 docker run 명령줄을 보여 주며, 이를 복사할 수 있습니다. 만들기를 실행하면 먼저 이미지를 가져온 다음(이 동작을 끄지 않은 경우) 실행하고, 출력을 시트에 실시간으로 표시합니다.
docker 그룹에 속해 있지 않으면 명령이 암호 없는 sudo docker로 대체됩니다 — 새로 설치한 Linux 서버에서 첫 시도가 권한 오류를 보고하는 일반적인 이유가 이것입니다.8.25.2모니터로서의 Containers 보드
Containers 패널은 단순한 목록이 아닙니다. 이 Mac의 모든 런타임을 하나의 판정으로 모은 상태 점이 있어, 사이드바를 한 번 보는 것만으로 주의가 필요한 것이 있는지 알 수 있습니다. 녹색은 설치된 모든 것이 정상이라는 뜻이고, 주황색은 무언가가 중지되었거나 아직 확인 중이라는 뜻이며, 빨간색은 설치된 엔진이 다운되었거나 컨테이너가 비정상, 재시작 반복 중이거나 오류로 종료되었다는 뜻입니다. 설치한 적이 없는 런타임은 문제로 보지 않습니다 — 따라서 녹색은 “모든 것이 실행 중”이 아니라 “존재하는 모든 것이 정상”이라는 의미입니다.
섹션은 서비스 목록과 같은 순서를 따릅니다. Apple Containers, Docker, Kubernetes, OrbStack, 컨테이너 머신, 그리고 Vagrant 순입니다. Kubernetes는 여기서 읽기 전용으로 표시되며, Kubernetes Clusters에서 고정한 클러스터를 보여 줍니다. 고정과 클러스터별 작업은 그 패널에서 하며, 그 패널은 이 Mac에 있는 것만이 아니라 어디서 실행되든 클러스터 전체를 감시합니다. 런타임이 설치되어 있지 않으면 버튼은 다운로드 페이지로 보내는 대신 해당 런타임을 설치하는 패널을 엽니다.
헤더의 고정 버튼은 작은 플로팅 팔레트를 엽니다. 전체 상태 점과 실행 중인 개수를 보여 주는 상태 막대 하나 아래에 실행 중인 항목의 짧은 목록이 있고, 설정되었지만 유휴 상태인 항목은 Waiting 아래에 묶입니다. 일부러 아주 작게 만들었습니다 — 다른 작업을 하는 동안 화면 구석에 놓아두기 위한 것입니다. 행을 클릭하면 메인 윈도우가 해당 항목으로 이동합니다.
8.25.3Kiri
Kiri(runkiri.com)는 Rust로 작성된 작고 빠른 무료 Docker Desktop 대안입니다. 가벼운 Linux VM에서 Docker Engine API를 제공하고 kiri docker 컨텍스트를 등록하므로, Docker 패널의 모든 기능이 그대로 Kiri에서 작동합니다. 컨테이너 섹션의 Kiri 패널은 Kiri 고유의 작업을 다룹니다. 설치(체크섬, 서명, 공증을 확인하는 Kiri 공식 설치 프로그램 사용), 엔진 상태와 VM 설정, 그리고 docker가 어느 엔진을 사용할지 — Docker에 Kiri 사용으로 컨텍스트를 전환하고, 되돌리기로 이전 엔진으로 돌아갑니다. 같은 패널에서 Kiri 업데이트, Linux 머신과 k3s Kubernetes 클러스터 관리, OrbStack 또는 Docker Desktop에서 이미지, 볼륨, 컨테이너 가져오기, 진단 보고서 저장도 할 수 있습니다.
8.25.4Docker Swarm
Swarm은 별도로 설치하는 제품이 아니라 Docker 엔진에 내장되어 있습니다. 그래서 FrontierStack은 Swarm에 별도의 패널을 두지 않고 Docker 패널에서 모니터링합니다. 보고 있는 엔진이 스웜에 속해 있으면 Docker Swarm 섹션이 나타나, 클러스터의 노드(준비 또는 다운, 드레인 중인지 여부, 어느 노드가 매니저인지)와 서비스 및 그 복제본 수를 나열합니다 — 서비스가 요청한 모든 태스크를 갖추면 3/3, 그렇지 않으면 1/3처럼 표시됩니다. 서버 활동 윈도우의 Docker 탭에도 같은 내용이 Swarm 세그먼트로 있어, 어느 연결된 서버에서든 클러스터를 확인할 수 있습니다.
상태는 docker info에서 가져옵니다. 패널이 엔진 상태 확인을 위해 이미 호출하는 명령이므로, 스웜에 속하지 않은 머신은 확인에 추가 비용이 들지 않습니다. Swarm의 규칙 하나가 표시되는 내용을 좌우합니다. 클러스터를 나열할 수 있는 것은 매니저뿐입니다. 워커에 요청하면 데몬이 거부하므로, 워커에서는 FrontierStack이 실패처럼 보이는 빈 표 대신 그 사실을 분명히 알려 줍니다.
8.25.5미리 구성된 스택
어떤 것은 컨테이너 하나가 아니라, 따로 떼어 놓으면 쓸모없는 여러 컨테이너로 이루어집니다. Containers 패널과 서버 활동 윈도우의 Docker 탭에 있는 Install Stack…은 그룹 전체를 한 번에 설정합니다. 앱에는 네 가지가 포함되어 있습니다. *arr 미디어 스택(다른 앱이 읽는 인덱서 목록을 보관하는 Prowlarr, 시리즈용 Sonarr, 영화용 Radarr, 음악용 Lidarr, 도서용 Readarr, 자막용 Bazarr, 그리고 다운로드 클라이언트), Monitoring(Prometheus, Grafana, node-exporter), Media server(Jellyfin, 요청 관리를 위한 Jellyseerr 선택 가능), 그리고 서버, 머신 러닝, Redis, PostgreSQL의 네 컨테이너가 실제로 필요한 자체 호스팅 사진 라이브러리 Immich입니다.
포함할 구성원, 설정 폴더와 미디어 폴더의 위치, 컨테이너가 파일을 기록할 때 사용할 사용자와 그룹, 그리고 이미 수신 대기 중인 것과 겹치지 않도록 스택 전체를 옮기는 포트 오프셋을 선택합니다. 공개 포트는 따로 지정하지 않는 한 127.0.0.1에 바인딩됩니다. 그런 다음 FrontierStack은 프로젝트 폴더에 docker-compose.yml을 작성하고 docker compose up -d를 실행합니다. 스택을 스택답게 만드는 것이 Compose입니다. 구성원들은 네트워크를 공유하고 서로를 이름으로 부르므로, Sonarr의 인덱서 설정을 그냥 http://prowlarr:9696으로 지정할 수 있습니다.
docker compose up -d를 다시 실행하는 것이 일반적인 방법입니다 — FrontierStack은 아무것도 숨기지 않았습니다.container CLI에는 compose에 해당하는 기능이 없고, 사용자 지정 네트워크에서 아직 다른 컨테이너를 이름만으로 확인하지 못하므로, 스택에 필요한 방식으로 구성원들이 서로를 찾을 수 없습니다.8.25.6Apple 컨테이너와 권장 GUI
Apple 실리콘에서는 macOS가 Apple의 자체 container 명령으로 Linux 컨테이너를 기본 실행할 수 있으며, 각 컨테이너는 하나의 큰 Linux VM을 공유하는 대신 자체 경량 가상 머신을 갖습니다. Containers 패널에는 이를 위한 Apple Containers 섹션이 있습니다. 실행 중인 항목을 나열하고, 컨테이너 시스템을 시작 및 중지하고, 이미지를 가져오고, 새 컨테이너를 만들며, 구성은 위의 Docker 섹션과 같습니다. Apple의 도구는 명령줄 프로그램이며, FrontierStack은 GitHub 릴리스에서 이를 설치합니다.
Apple 컨테이너를 일상적으로 다룰 때는 Davit을 권장합니다. 같은 container 명령에 제대로 된 그래픽 프런트엔드를 제공하는 독립 macOS 앱으로, 하위 명령을 기억하지 않고도 컨테이너와 이미지를 살펴보고, 시작 및 중지하고, 로그를 따라볼 수 있습니다. Apple Containers 섹션에서 Homebrew cask로 설치한 뒤 바로 열 수 있습니다. Davit에는 Apple 실리콘과 macOS 15 이상이 필요합니다.
container CLI를 구동하므로 두 앱은 실행 중인 항목에 대해 항상 같은 내용을 보여 줍니다 — 하지만 어느 쪽이든 통신할 대상이 있으려면 Apple의 container가 설치되어 있어야 합니다. Davit만 설치해서는 충분하지 않습니다.8.25.7서버의 Watchtower
Watchtower는 새 이미지를 받아 컨테이너를 다시 만들어 Docker 컨테이너를 최신 상태로 유지합니다. 연결된 서버에서 실행 중이면 FrontierStack은 정기 상태 확인에서 해당 컨테이너를 찾고, 설정과 로그를 SSH로 최대 한 시간마다 읽습니다. 서버 패널, 서버 활동 윈도우의 Docker 탭, 컨테이너 아래의 Watchtower 패널에 마지막 스캔(확인·업데이트·업데이트 실패한 컨테이너 수)을 표시합니다. 일정과 모드, 그 이후의 오류도 표시합니다. 알림 URL과 API 토큰은 읽지 않습니다. Watchtower가 멈추거나, Docker가 거부하거나, 업데이트가 실패하거나, 스캔이 더 이상 오지 않으면 알림이 뜹니다.
containrrr/watchtower는 2025년 12월에 보관되었습니다. Docker Engine 29 이상은 그 API 버전을 거부하므로 아무것도 업데이트하지 못한 채 재시작을 반복합니다. FrontierStack은 그 원인을 알려 주고, 아직 보관된 이미지를 쓰는 서버를 표시합니다. 같은 옵션을 받는 관리되는 포크 nickfedor/watchtower로 바꾸십시오. Watchtower 패널에 바로 쓸 수 있는 docker run 명령이 있습니다.8.25.8SWAG 리버스 프록시
SWAG(LinuxServer.io의 Secure Web Application Gateway)는 nginx, Let’s Encrypt 클라이언트, fail2ban을 하나의 컨테이너에 담은 것입니다. FrontierStack은 연결된 서버의 정기 상태 확인과 이 Mac의 Docker에서 SWAG를 찾습니다. 최대 한 시간마다 인증서의 남은 일수와 이름, nginx 실행 여부와 nginx -t 통과 여부, 사용 중인 프록시 conf, fail2ban jail을 읽습니다. 결과는 서버 패널, 서버 활동 윈도우의 Docker 탭, SWAG 패널에 표시됩니다. 거기서 테스트 후 다시 읽기, SWAG 샘플 프록시 conf 활성화(먼저 테스트하고 nginx가 거부하면 되돌림), conf 비활성화(.conf.off로 보관), 주소 차단 해제, 컨테이너 재시작을 할 수 있습니다. SWAG가 멈추거나, nginx가 꺼져 있거나, 설정 테스트가 실패하거나, 인증서가 14일 미만 남으면 알림이 뜹니다. SWAG는 30일 남았을 때 갱신하므로, 이는 갱신이 실패하고 있다는 뜻입니다.
dns-conf/cloudflare.ini에 기록), Cloudflare Tunnel이나 Tailscale Funnel을 포트 8543으로 지정하세요. 서버용 명령 복사는 같은 설정을 Linux 서버용 docker run으로 제공합니다.
8.6Remote Tools — 노드별 진단
Fleet & Remote ▸ Remote Tools는 실제 플릿 디버깅 작업에서 추려 낸 SSH 기반 진단 도구 모음입니다. 먼저 대상을 선택하십시오 — 고정된 서버, 또는 저장된 서버가 아닌 임시 주소를 위한 Other (IP / host)…(이 경우에도 sudo 암호가 키체인에 보존됩니다) — 그다음 도구와 매개변수를 선택합니다. 읽기 전용 검사는 root 권한이 필요 없고, 보호된 로그나 설정을 읽는 검사는 헬퍼를 통해 저장된 sudo 암호를 사용하며, 일부는 mutating(변경 작업)으로 표시됩니다.
| 도구 | 용도 |
|---|---|
| Ping · Traceroute · Whois | 기본 도달성, 경로, 등록 정보 조회를 선택한 노드에서 실행합니다. |
| Net Info · Netstat | 인터페이스와 주소, 라우팅 테이블, 인터페이스/프로토콜 통계, 활성 소켓. |
| Port Scan · Port Check · Web Check | 범위 스캔, 단일 포트 테스트, 또는 HTTP/HTTPS 엔드포인트를 가져와 상태를 보고합니다. |
| TLS Inspect · TLS Expiry | 인증서를 검사하고, 선택한 여러 노드의 만료일을 한 번에 확인합니다. |
| System Resources · Listening Ports | 노드의 부하, 메모리, 디스크, 그리고 수신 대기 중인 항목(선택적으로 sudo 사용). |
| Tail Log · Config Test | 임의의 로그 경로를 tail하고, 웹 서버 설정을 검증합니다. |
| File Diff · Healthcheck | 여러 노드 간 파일 내용을 비교하고(드리프트), 각 노드에서 루프백으로 가상 호스트의 경로에 요청을 보냅니다. |
| rsync Deploy | 로컬 폴더를 원격 경로로 푸시합니다 — 드라이런 미리 보기와 선택적 --delete 포함. |
| Security · SSH · Exposure · Auth · User audits | 임의의 노드나 임시 IP에 대한 읽기 전용 감사(10장 참조). |
| Flush DNS · Restart Backend | 리졸버 캐시를 비우고, macOS Server 웹 백엔드를 재시작합니다(변경 작업 — 사이트가 잠시 끊깁니다). |
일부 도구는 선택한 여러 노드에서 한 번에 동작합니다 — File Diff, Healthcheck, TLS Expiry, Serving Path Diagnosis(어느 노드가 살아 있는지, 각 노드가 어떤 공인 IP에 바인딩하는지, 프로세스별 CPU 포화 상태와 중지된 서비스를 고정된 모든 Cloudflare 영역의 오리진 IP와 대조)는 설계상 플릿 전체를 대상으로 합니다 — 모든 웹 노드가 유효한 인증서로 같은 콘텐츠를 제공하는지 확인하는 방법이 바로 이것입니다. 패널 하단에서는 /etc/hosts(헬퍼를 통한 root 권한)와 SSH 사용자의 ~/.ssh/known_hosts를 SSH로 안전하게 편집할 수도 있으며, 각각 먼저 .fsbak으로 백업됩니다.
8.7멈춘 서버 복구 — 그리고 SSH 없이 안전하게 전원 재설정하기
서버는 서비스는 계속 실행되는 상태에서 SSH에만 응답하지 않을 수 있습니다 — 다운된 것이 아니라 과부하 상태입니다. FrontierStack은 이를 표시합니다. SSH에는 연결할 수 없지만 서비스 포트(예: 3306의 MySQL)가 여전히 응답하면, 서버의 점은 빨간색이 아닌 주황색이 되고 패널에 "SSH가 멈췄지만 서버는 여전히 서비스 중입니다"라고 표시되며, 응답 중인 항목이 데이터베이스의 버전 배너와 함께 나열됩니다. 머신은 살아 있고 관리 채널만 멈춘 것이므로, 죽었다고 단정하거나 무작정 전원을 끊지 마십시오.
먼저 일반 Reboot를 시도하십시오. Reboot 후에는 FrontierStack이 유예 시간을 기다린 다음 폴링하는 동안 점이 깜박이며, 호스트가 돌아오는 즉시 새로 고침됩니다 — Refresh를 계속 누를 필요가 없습니다.
SSH 없이 전원 재설정을 안전하게 만드십시오. 데이터베이스가 여전히 응답하면 패널에 빨간 테두리의 EMERGENCY 상자, Prepare databases for a safe power reset이 표시됩니다. 각 단계는 데이터베이스 상태에 저장된 자격 증명을 사용해 데이터베이스 자체 연결(SSH 아님)로 위에서 아래로 실행됩니다. Stop accepting writes(읽기는 계속 가능, 되돌릴 수 있음), Quiesce & flush to disk, 그리고 Clean-shutdown입니다. 정상 종료 후에는 메모리에 손상될 수 있는 미기록 데이터가 남아 있지 않으므로 강제 전원 재투입이 안전합니다. 지원 범위는 엔진마다 다릅니다 — MySQL, Redis, MongoDB는 각 프로토콜로 정상 중지할 수 있고, PostgreSQL은 SQL로 정지 및 플러시할 수 있지만 중지할 수는 없으므로 플러시한 뒤 전원을 재투입합니다. 정상 종료 버튼은 빨간색이며 먼저 확인을 요청합니다.
전원을 재투입한 다음 되살리십시오. 하드웨어 전원 제어(SwitchBot 플러그, 스마트 멀티탭/PDU, KVM)는 각각 확인 단계에서 Shut Down Databases First를 제공하므로, 전원을 끊기 전에 데이터베이스를 플러시하고 중지할 수 있습니다. 그리고 종료로 부하가 해소되어 SSH가 복구되면 Start 버튼으로 SSH를 통해 데이터베이스를 다시 시작합니다 — 따라서 이상적인 순서는 대개 폭주한 데이터베이스를 정상 종료하고, 서버가 회복되게 둔 다음, Start로 다시 시작하는 것이며, 전원 재투입은 전혀 필요 없습니다.
8.8Host Monitor(원격 에이전트)
SSH 진단은 요청할 때만 실행됩니다. 지속적인 가시성이 필요하면 Host Monitor를 설치하십시오 — 서버에 상주하며 자체 상태를 보고하는 작은 읽기 전용 Go 헬퍼(fsagent)로, 주기마다 SSH를 사용하지 않습니다. 연결된 호스트의 패널에서 설치를 선택하거나 Link a Server에서 체크 상자를 선택하십시오. 앱은 기존 키를 통해 호스트의 OS와 아키텍처에 맞는 바이너리를 푸시하고, 플랫폼 서비스(systemd, launchd 또는 BSD rc.d)를 설정하고, TLS 인증서를 고정합니다. AI 도구 install_monitor도 요청에 따라 같은 작업을 수행합니다.
Slackware. Slackware는 systemd 대신 /etc/rc.d 스크립트로 서비스를 시작하므로, 모니터는 /etc/rc.d/rc.fsagent로 설치되어 부팅 시 rc.local에서 시작되고, 멈추면 자동으로 다시 시작됩니다. 서비스 재시작, 서버 재부팅, 재부팅 센티널은 다른 Linux 서버와 똑같이 동작합니다. rc 스크립트가 있으면 서비스가 설치된 것으로, 스크립트가 실행 가능하면 활성화된 것으로 봅니다. FrontierStack은 활성화된 서비스만 재시작하며 서비스를 임의로 활성화하지 않습니다. 보안 업데이트에는 릴리스의 /patches 디렉터리에서 대기 중인 패키지가 표시됩니다(목록을 최신으로 유지하려면 가끔 slackpkg update를 실행하십시오). Slackware 커널 업데이트는 부트 로더도 직접 업데이트해야 하므로 설치는 slackpkg로 직접 합니다.
LAN과 Tailscale을 동시에. 모니터는 이 Mac이 설치에 사용한 주소, 그리고 서버 자체의 LAN 주소와 Tailscale 주소에서 수신 대기합니다 — 모든 인터페이스에서 수신 대기하지 않으며, 공인 주소나 컨테이너 브리지 주소에서도 수신 대기하지 않습니다. 한 주소에서 응답이 멈추면(예: 사무실을 떠나 이제 Tailscale로 서버에 접속하는 경우), FrontierStack은 같은 고정 인증서를 제시하는 다른 주소로 전환합니다. 버전 1.22 이전에 설치된 모니터는 한 주소에서만 응답합니다. Detect monitor는 모니터가 실행 중이지만 연결할 수 없을 때 이를 알려 주며, Install & Enroll로 업그레이드할 수 있습니다.
등록이 완료되면 모니터는 실시간 지표를 스트리밍합니다. CPU, 메모리, 마운트별 디스크, 활성 네트워크 인터페이스, 감지된 서비스, 방화벽 및 fail2ban 상태를 보내며, GPU 호스트에서는 GPU별 온도와 사용률도 보내므로 채굴 장비나 ML 장비의 발열 상태가 드러납니다. list_monitors는 플릿의 헬퍼와 그 버전, 최신 지표를 보고합니다. 무엇보다 모니터는 Mac 앱이 오프라인일 때도 계속 감시하며 알림을 보낼 수 있습니다. 자체 채널로 직접 알리고, 앱이 돌아오면 버퍼에 쌓인 내용을 재전송합니다. 로그 윈도우도 모니터를 우선 사용합니다 — 모니터는 서버에서 root로 실행되므로 sudo 암호 없이도 권한이 필요한 로그를 읽습니다.
등록된 호스트의 패널에는 Behavior & History 차트도 있습니다. CPU, 메모리, 디스크, 온도를 5분 단위로 최대 30일간 기록하며, 학습된 기준선과 비교해 비정상적인 동작을 표시합니다. 온도는 도 단위의 별도 눈금을 사용하므로 백분율 기반 리소스 사용량 옆에서도 읽기 쉽습니다. 세로선은 같은 타임라인에 사건을 표시합니다. 빨간 실선은 서버 재부팅(보고된 가동 시간에서 산출)이고, 주황 점선은 워치독 문제 — 서비스 강제 재시작, 데이터베이스 손상 경고, 재부팅 에스컬레이션 — 입니다. OS 충돌 리포터가 CPU를 사용하기 시작하면(프로세스가 반복해서 충돌하는 경우) 주황색 Crashes 곡선이 차트에 추가되므로, "어젯밤 MySQL이 두 번 강제 재시작되었고 무언가가 충돌을 반복하고 있었다"는 사실을 한눈에 알 수 있습니다. 차트 아래의 충돌 로그 열기…를 누르면 서버의 충돌·멈춤·패닉 보고서(macOS DiagnosticReports)가 로그 뷰어에서 열려, 그 곡선이 어떤 프로세스 때문이었는지 확인할 수 있습니다.

모니터는 기본적으로 읽기 전용입니다. Host Monitor 패널에서 Allow actions를 켜면, 승인 절차를 거치는 monitor_action 도구로 실행되는 작고 고정된 제어 동작 집합이 열립니다 — 임의의 셸 명령은 절대 허용되지 않습니다. 허용 목록에 있는 서비스의 재시작/다시 로드/시작/중지, DNS 캐시 비우기, 방화벽 또는 fail2ban 다시 로드, 재부팅이 가능합니다. 각 작업은 서버에 기록됩니다. 지원 대상은 Linux(amd64/arm64/arm — 모든 Raspberry Pi 포함), macOS(OS X 10.11 El Capitan까지의 레거시 Intel 빌드 포함), FreeBSD(pfSense/OPNsense/TrueNAS), Windows입니다.
모니터를 장기간 건강하게 유지하는 일은 자동으로 처리됩니다. Rotate monitor credential은 베어러 자격 증명을 그 자리에서 교체합니다. 새 비밀 값은 Mac에서 생성되어 승인된 FS1 서명 키를 통해 전송되고, 화면에 표시되거나 AI에 전달되는 일 없이 서버에서 활성화됩니다. Allow self-update를 켜 두면 새 빌드 푸시는 구조적으로 안전합니다 — 후보 바이너리의 릴리스 서명을 검증하고, root 권한을 받기 전에 호환성 자체 테스트를 통과해야 하며, 이전 바이너리는 롤백용으로 보관됩니다. 새 바이너리가 상태 확인에 응답하지 않으면 FrontierStack이 자동으로 이전 바이너리를 복원합니다. 풀 방식 업데이트는 영구 토큰 대신 짧은 수명의 일회용 승인으로 바이너리를 가져옵니다. 모니터가 FS1 서명 요청을 검증하고 있으면 패널에 FS1 signed 배지가 표시됩니다.
8.25.9다른 Mac의 FrontierStack
헬퍼는 로그인 세션이 없는 시스템 서비스이므로 그것만으로는 그 Mac의 Wi-Fi 스캔, LAN 및 Bonjour 탐색, 키체인 사용, 화면 알림 표시, Apple Home과 Apple Intelligence 사용을 할 수 없습니다. 그 Mac에서 FrontierStack 자체도 실행 중이면(열려 있거나, 백그라운드로 시작했거나, 백그라운드 서비스만 실행 중) 정기 상태 확인이 버전 및 macOS 사용자와 함께 이를 감지합니다. 서버 패널의 이 Mac의 FrontierStack 섹션에 지금 그곳에서 쓸 수 있는 기능과 앱이 필요한 기능이 표시됩니다.
앞으로 가져오기는 SSH를 통해 그 Mac의 화면에 FrontierStack을 엽니다. 백그라운드로 시작된 앱은 이후 유휴 상태에서도 종료되지 않습니다. 기능 옆의 그 Mac에서 보기는 해당 패널을 열고, 필요하면 앱을 먼저 실행합니다. 둘 다 FrontierStack이 접속하는 것과 같은 사용자로 그 Mac에 로그인되어 있어야 합니다. AI 관리자도 list_targets의 각 서버 줄에서 같은 정보를 볼 수 있습니다.
8.25.10그 Mac의 기능을 여기서 실행하기
그 Mac의 기능을 이 Mac에서 사용하려면(예: 그 Mac이 있는 곳에서 Wi-Fi 스캔) 이 Mac에서 실행 아래의 이 Mac과 페어링…을 누릅니다. 이 Mac은 iPhone이나 Android 휴대폰과 똑같은 방식으로 그 Mac의 FrontierStack과 페어링합니다. 요청은 SSH로 전달되어 그 Mac의 화면에 나타나고, 그곳에 있는 사람이 승인합니다(App Lock이 보안 키를 요구하면 터치도 필요). 그러면 이 Mac이 그 Mac의 페어링된 기기에 휴대폰들과 함께 Mac: …(읽기 전용)으로 표시됩니다.
페어링한 후에는 Wi-Fi, 위치, 기기 검색, 속도 테스트 옆의 여기서 실행(입력한 호스트로의 Traceroute 또는 Ping 포함)이 그 Mac에서 기능을 실행하고, 어느 Mac이 응답했는지, 어떤 경로로 연결했는지, 언제 실행했는지와 함께 결과를 이 패널에 표시합니다. 이 Mac은 SSH 주소, 페어링할 때 알려 준 주소, Bonjour, 마지막으로 SSH 터널 순서로 그 Mac을 찾으므로 다른 서브넷이나 SSH만 통과시키는 방화벽 뒤에 있는 Mac에서도 작동합니다. 백그라운드 서비스만 실행 중이면 첫 요청이 그 Mac의 FrontierStack을 숨긴 상태로 시작합니다. 페어링 해제는 그 Mac에 이 Mac을 제거하도록 요청하고 여기서도 잊습니다. AI 관리자도 get_location의 mac 인수로 같은 정보를 읽을 수 있습니다.
8.9서버가 응답하지 않을 때: FrontierStack이 마지막으로 본 정보
응답하지 않는 서버야말로 세부 정보가 필요한 서버입니다. 다른 경로로 접속해 볼 주소, 랙에서 찾아낼 하드웨어, 영향 범위를 가늠할 실행 중 서비스가 필요하기 때문입니다. 그래서 FrontierStack은 연결된 서버마다 응답하던 동안 마지막으로 확인한 내용을 기록해 두고, 빈 “확인 중…” 항목이 늘어선 패널 대신 그 기록을 보여 줍니다.
서버가 응답하지 않으면 패널 맨 위에 주황색 줄 — “응답 없음 — 아래는 FrontierStack이 마지막으로 확인한 내용입니다”와 그 시각 — 이 표시되고, 기억된 값은 시계 아이콘과 함께 흐리게 표시됩니다. 서비스 아래에는 마지막 확인 시 실행 중 목록으로 당시 실행되던 서비스가 나타납니다. 흐리게 표시된 값은 실시간 값이 아니라 그 시점의 사실이며, 이후 서버가 바뀌었을 수 있습니다. 서버가 다시 응답하면 즉시 실시간 값으로 바뀝니다.
| 기억하는 항목 | 내용 |
|---|---|
| 시스템 | OS 버전, 하드웨어, 마지막 확인 시 가동 시간. |
| 주소 | IPv4와 모든 주소, 안정적인 IPv6 주소(링크 로컬 주소와 임시 개인정보 보호 주소는 바뀌거나 다른 머신에서 쓸 수 없으므로 제외), Tailscale IP와 MagicDNS 이름, 공개 이름. |
| 네트워크 | DNS 리졸버와 연결 유형(이더넷 속도, Wi-Fi 세대 또는 VPN). |
| 서비스 | 마지막으로 확인했을 때 실행 중이던 서비스. |
| 예약 재부팅 | 운영 체제 자체에 설정된 재시동: 에너지 설정의 반복 재시동(pmset), reboot나 shutdown을 호출하는 LaunchDaemon, cron 항목, systemd 타이머, unattended-upgrades의 Automatic-Reboot. 설정 없음도 기억하므로 예약 재시동 가능성을 배제할 수 있습니다. |
| 모니터 설정 | 모니터 버전, Allow actions와 Allow reboot, 감시 중인 서비스, 멈춤 시 재부팅 설정, 재부팅 센티널 상태, 켜져 있는 직접 알림의 종류. 알림 URL이나 토큰은 절대 기록하지 않습니다. |
Status 섹션에는 새 행이 두 개 있으며, 서버가 응답하는 동안에는 실시간으로 표시됩니다. IPv6는 안정적인 IPv6 주소를 나열하고, 예약 재부팅은 운영 체제가 스스로 수행하도록 설정된 재시동을 보여 줍니다. 서버가 매주 같은 시각에 “알 수 없는” 재부팅을 한다면 가장 먼저 확인할 항목입니다.
AI 관리자도 같은 기억된 정보를 마지막 확인 시각과 함께 봅니다. 따라서 서버 자체가 답할 수 없을 때도 “방금 다운된 서버의 IP가 뭐였지?”라는 질문에 답할 수 있습니다(13장).
8.10멈춤 시 재부팅: 전원은 켜져 있는데 아무도 들어갈 수 없을 때
서비스 워치독(11장)은 서비스를 하나씩 복구합니다. 그러나 내부에서 보면 모든 서비스가 정상인데도 머신 전체가 먹통이 되는 장애가 있습니다. SSH와 화면 공유가 응답하지 않는 Mac, 또는 어느새 네트워크를 잃은 서버입니다. 외부에서는 아무도 접근해 고칠 수 없으므로, 복구는 서버 스스로 해야 합니다. 서버 패널의 서비스 워치독 패널에 있는 멈춤 시 재부팅이 그 역할을 합니다. 모니터 1.23.0 이상이 필요하며, 서버의 모니터가 더 오래된 경우 패널에 그렇게 표시됩니다.
| 설정 | 동작 |
|---|---|
| SSH가 응답하지 않으면 재부팅 | 모니터가 SSH 포트(변경하지 않으면 22)에 연결하여 포트가 열려 있는지만이 아니라 sshd의 SSH 인사말을 기다립니다. 멈춘 Mac은 포트 22에서 TCP 연결을 받아 놓고 아무 말 없이 끊는 경우가 많으며, 포트 검사로는 이를 정상으로 판단합니다. |
| 서버가 네트워크를 잃으면 재부팅 | 모니터가 기본 게이트웨이에 도달할 수 있는지 확인합니다. 추가 대상을 host 또는 host:port로 지정할 수 있으며, 그중 하나라도 응답하면 온라인으로 간주합니다. |
| N분 동안 계속 실패하면 재부팅 | 기본값은 10분입니다. 그 사이에 한 번이라도 확인에 성공하면 처음부터 다시 셉니다. |
| 자동 재부팅은 N분마다 최대 한 번 | 부팅 루프 방지 장치입니다. 장애가 아무리 오래가도 자동 재부팅은 이 간격마다 최대 한 번입니다. |
각 검사는 모니터가 시작된 뒤 한 번 이상 성공해야 비로소 활성화됩니다. 따라서 sshd가 없는 서버나 모니터가 게이트웨이를 찾을 수 없는 서버는 이 검사로 재부팅되지 않으며, 검사는 계속 기다릴 뿐입니다. 또한 패널의 원격 작업에서 Allow actions와 재부팅 허용이 모두 켜져 있지 않으면 서버는 재부팅을 거부하며, 꺼져 있을 때는 패널에 경고가 표시됩니다.
멈춤 시 재부팅이 켜져 있는 동안 패널에는 각 검사의 실시간 상태(응답함 · 활성화됨, 첫 번째 정상 확인 대기 중, 특정 시각부터 실패 중), 네트워크 검사가 사용하는 게이트웨이, 마지막 자동 재부팅 시각이 표시됩니다.
8.25.11root로 실행되는 재부팅 센티널
이 기능의 계기가 된 먹통 현상은 충돌보다 기묘했습니다. 서버의 포트는 연결을 받아들이는데 sshd도 화면 공유도 전혀 응답하지 않았습니다. 머신이 더 이상 새 프로세스를 시작할 수 없었던 것입니다. 그렇게 되면 shutdown 명령을 시작하는 것으로 시작되는 재부팅도 실행할 수 없습니다. 모니터 1.24.0부터는 macOS와 Linux에서 모니터와 함께 재부팅 센티널이 설치됩니다. 같은 바이너리를 root로 실행하는 것으로, 네트워크 수신 대기도 토큰도 없습니다.
센티널에는 자체 정책이 없습니다. 모니터 자체의 멈춤 시 재부팅 설정과 권한에만 따르는 최후의 안전장치입니다. 모니터의 재부팅이 이루어졌어야 하는데 이루어지지 않았다면, 센티널이 그 3분 뒤에 서버를 재부팅합니다(기본값 10분이면 장애 발생 13분 후). 이 경로에서는 어떤 프로그램도 시작하지 않고 디스크를 기다리지도 않으며, 커널의 재부팅을 직접 호출하므로 서버가 새 프로세스를 시작할 수 없을 때도 동작합니다. 재부팅 직전에는 프로세스를 시작할 수 있었는지를 기록합니다. “이 서버는 프로세스 슬롯이 바닥났다”는 사실을 나중에 뒷받침하는 증거입니다. 패널에는 센티널이 설치되어 보고 중인지, 언제 동작할지, 마지막 재부팅이 표시됩니다. 센티널이 설치되지 않았다고 표시되면 모니터를 업데이트하십시오.
8.25.12프로세스 수
프로세스 슬롯이 바닥나면 서버는 연결은 받아들이면서도 sshd나 화면 공유를 시작하지 못하게 됩니다. 모니터는 1.24.0부터 매분 프로세스 수를 기록합니다. 커널 한도 대비 전체 수, 사용자별 한도, 프로세스를 가장 많이 실행하는 사용자입니다. 멈춤 시 재부팅 영역의 프로세스 행에는 현재 수치, 최고치가 표시된 최근 24시간 차트, 그리고 전체 수나 한 사용자의 수가 한도에 가까워지면 주황색 경고가 표시됩니다. 멈춤으로 이어지기 전에 폭주하는 프로세스를 찾아낼 때입니다.
8.11Cloud Servers, Server Clone 및 원격 Apache
컴퓨팅 패널과 함께 있는 AWS ▸ DynamoDB는 선택한 리전의 테이블을 상태, 항목 수, 크기, 파티션/정렬 키와 함께 나열합니다. 실제로 비용이 발생하는 두 가지에 초점을 맞춥니다. 용량 모드 캡슐은 사용 여부와 관계없이 읽기 및 쓰기 단위에 대해 계속 요금이 청구되는 프로비저닝 테이블과 요청당 요금이 청구되는 온디맨드 테이블을 구분합니다. 그리고 no PITR 플래그는 특정 시점 복구가 꺼진 테이블을 표시합니다. 특정 시점 복구는 모든 새 테이블에서 기본적으로 꺼져 있으며, 잘못된 쓰기 후 되돌릴 수 있는 유일한 방법입니다. 특정 시점 복구는 각 행의 메뉴에서 켜거나 끌 수 있습니다. DynamoDB에는 일괄 describe 호출이 없으므로 각 테이블을 개별적으로 조회하며, 목록은 리전당 40개로 제한됩니다.
Fleet & Remote ▸ Cloud Servers는 API 토큰이 설정된 모든 클라우드 제공업체 — DigitalOcean, Vultr, Linode, Hetzner, Sakura, Contabo — 와 AWS EC2, Lightsail, RDS의 인벤토리를 하나로 모읍니다. 읽기 전용 집계이며(전원 제어는 각 제공업체의 패널에 남아 있습니다. Contabo 패널에서는 스냅샷 만들기, 롤백, 삭제와 새 이미지로 인스턴스 재설치도 할 수 있습니다), IP가 있는 실행 중인 인스턴스마다 수신 대기 중인 항목을 찾는 Services 버튼과, SSH로 인스턴스를 연결하고 모니터를 한 번에 설치하는 + Helper 버튼이 있습니다 — 시트에서 올바른 사용자 이름과 키만 지정하십시오.
MacStadium에서 임대한 Mac에는 호스팅 아래에 전용 패널이 있습니다. 베어메탈 Mac은 다른 서버처럼 연결하고 월 정가를 지출 및 청구에 추가합니다. Orka 클러스터의 VM은 클라우드 서버에도 나타나지만 헬퍼는 MacStadium 패널에서 설치합니다. 그곳에서 FrontierStack 헬퍼 준비를 켜고 배포한 VM은 헬퍼용 전달 포트와 이 Mac의 SSH 공개 키를 가지고 시작하며, 헬퍼 설치로 마무리됩니다. Orka VM 디스크는 임시이므로 VM을 삭제하면 헬퍼도 함께 사라집니다.
호스팅 ▸ 임대 Mac은 시간 단위나 월 단위로 임대한 모든 Mac을 나열합니다. AWS EC2 Mac 호스트, Scaleway Apple silicon, Flow Swiss Mac은 각 API에서, MacStadium이나 MacinCloud Mac은 플릿에서 지정한 것입니다. 각 Mac의 24시간 최소 기간, 정가, 이번 달 시간 과금을 보여 주고, 과금 중인데 아무것도 실행하지 않는 EC2 Mac 호스트를 경고하며, 모든 Mac을 지출 및 청구에 추가합니다. 옆의 호스팅 ▸ CI 빌드 머신에서는 호스팅 CI 빌드 머신의 이번 달 비용, 머신을 기다리는 빌드, 제공업체 간 분당 가격을 비교하는 계산기를 볼 수 있습니다.
Google Cloud는 Google Cloud CLI 패널(Hosting)을 통해 같은 인벤토리에 합류합니다. 이 패널에서 설치하면 브라우저에서 gcloud auth login도 실행되며, 이후 FrontierStack은 키를 저장하지 않고 사용자의 로그인을 사용합니다. 프로젝트 또는 모든 프로젝트를 선택한 다음 Compute Engine VM에 SSH로 접속하거나 시작, 중지, 재설정할 수 있으며, 중지와 재설정은 먼저 확인합니다. AI Administrator는 diagnose로 읽으며 list 명령 외의 작업에는 사용자의 승인이 필요합니다.
Microsoft Azure도 Azure CLI 패널(Hosting)을 통해 같은 방식으로 합류합니다. 이 패널에서 설치하면 브라우저에서 az login도 실행됩니다. 구독 또는 모든 구독을 선택한 다음 Linux VM에 SSH로 접속하거나 VM을 시작, 중지, 재시작할 수 있으며, 중지와 재시작은 먼저 확인합니다. Azure에서는 전원만 꺼진 VM에도 컴퓨팅 요금이 청구되므로 중지는 VM의 할당을 취소합니다. AI Administrator는 diagnose로 읽습니다. 비밀 정보를 반환하는 Azure list 명령이 많아 정해진 명령으로만 제한되며, 그 외의 작업에는 사용자의 승인이 필요합니다.
Server Clone은 플릿 서버를 이 Mac과 같은 구성으로 세우는 안내형 마법사입니다. 감지된 Homebrew 스택을 설치하고, 설정과 사이트 파일을 원래 경로로 복사하고, 도메인 설정을 푸시하고 웹 서버를 다시 로드하며, MySQL 데이터베이스를 복제할 수도 있습니다(로컬 mysqldump를 SSH를 통해 대상의 mysql로 파이프). 모든 단계는 키 기반 SSH로 실행되고 다시 실행해도 안전하며, 기존 데이터는 삭제되지 않습니다.
Server Clone은 먼저 대상이 소프트웨어를 설치하는 방식을 확인합니다. Homebrew가 있으면 그것을 사용합니다(없으면 이전처럼 설치합니다). Nix나 GNU Guix가 있는 서버에서는 대신 nix profile이나 guix install로 스택을 설치할 수도 있습니다. NixOS와 Guix System은 시스템 구성에서만 서비스를 실행하므로, 스택과 사이트는 검토할 파일이 됩니다. 사이트별 가상 호스트를 포함한 NixOS 모듈(~/frontierstack-clone.nix) 또는 Guix 서비스 파일(~/frontierstack-clone.scm)입니다. 설치 및 재빌드는 구성이 그 파일을 참조하면 제자리에 복사하고 nixos-rebuild switch 또는 guix system reconfigure를 실행합니다. 참조하지 않으면 추가할 줄을 보여 줍니다. FrontierStack은 시스템 구성을 편집하지 않으며, 웹 포트는 직접 열 때까지 닫혀 있습니다. 이 Mac에 Nix 프로필 패키지가 있으면 Nix가 있는 대상에도 설치할 수 있습니다.
Guix나 Guix System을 실행하는 서버에는 서버 활동 윈도우에 Guix 탭도 생깁니다. 데몬과 스토어, 채널과 마지막 guix pull 이후 경과, 시스템 세대의 재구성·롤백·전환, Shepherd 서비스, Guix Home, 프로필 패키지를 다룰 수 있습니다. root가 필요한 작업은 콘솔에서 실행합니다.
하나의 사이트를 공개할 준비가 되면, 도메인의 컨텍스트 메뉴에서 Promote to Production 푸시를 사용하십시오. 가상 호스트 설정을 로컬과 같은 경로로 보내고, 선택적으로 문서 루트와 데이터베이스를 복사하고, Cloudflare를 통해 DNS를 대상으로 지정하며, certbot으로 실제 Let's Encrypt 인증서를 발급할 수 있습니다 — 파일, 데이터베이스, 가상 호스트, DNS, HTTPS를 한 번의 푸시로 처리합니다.
원격 서버의 Apache를 직접 관리할 수도 있습니다. 원격 호스트가 하나라도 있으면 Apache 패널에 호스트 선택기(This Mac / 각 연결된 서버)가 추가됩니다. 서버를 선택하면 FrontierStack이 SSH로 해당 서버의 Apache — 버전, 설정 구조, 실제 로그 경로를 포함한 모든 활성 가상 호스트 — 를 찾아내며, 가상 호스트, 모듈, MIME 유형, 포트, WebDAV를 편집할 수 있습니다. 각 변경 사항은 적용 전에 검증(httpd -t)되고 정상적으로 다시 로드되며, 설정이 유효하지 않으면 롤백됩니다. 레거시 macOS Server.app의 Apache 트리도 인식합니다. 사이트 목록의 Push to Server…는 로컬 사이트의 가상 호스트를 문서 루트를 바꿔 넣어 모니터가 연결된 서버에 생성합니다. 이 기능들이 대응하는 로컬 Apache 및 사이트 워크플로는 7장에서 다룹니다.
사이트가 5개 이상인 목록에는 연결된 서버든 이 Mac이든 옆에 모두 테스트가 나타납니다. 이 Mac에서 해당 서버로 직접 연결해 각 사이트에 한 번씩 요청하고, 각 응답을 문제가 있는 것부터 나열합니다. 웹 서버를 시작하거나 중지하려면 사이드바에서 서버를 Control-클릭한 다음 웹 서버 시작 또는 웹 서버 중지를 선택합니다. 중지할 때는 먼저 확인합니다.
8.12호스트 화면 공유
각 서버의 패널은 프로브가 감지한 원격 접속 방법을 제공합니다 — Mac은 Apple 화면 공유 / VNC, Windows는 RDP, 그리고 클라이언트가 있으면 AnyDesk, TeamViewer, RustDesk, NoMachine입니다. 이 Mac에 Apple Remote Desktop이 설치되어 있으면 vnc:// 핸들러를 등록해 클릭을 가로채므로, 패널은 항상 Apple의 내장 화면 공유 클라이언트를 여는 별도의 Screen Sharing (macOS) 작업을 제공합니다. 호스트에 둘 이상의 주소로 연결할 수 있으면 — 예를 들어 LAN IP와 VPN 또는 Tailscale 주소 — 이 작업은 연결할 네트워크를 고르는 메뉴가 됩니다. 각 선택 항목은 숫자 IP로 직접 연결하므로, 호스트 이름이 확인되지 않을 때(mDNS, 분할 DNS, VPN 문제)에도 동작합니다. 패널이 확인되지 않을 수 있는 이름을 사용하게 되는 경우에는 VNC와 RDP에도 그에 맞는 “— by IP” 버튼이 나타납니다.
8.25.13내 RustDesk 서버
RustDesk는 모든 것을 직접 운영할 수 있는 오픈 소스 원격 데스크톱이며, RustDesk 패널(Fleet & Remote ▸ RustDesk)은 클라이언트를 여는 데서 그치지 않습니다. 자체 호스팅 RustDesk 서버를 자격 증명 없이 모니터링합니다 — ID 서버(hbbs, TCP 21115 — 관계없는 포트가 열려 있는 것만으로는 통과하지 못함)와의 실제 랑데부 교환, TCP 21116, 릴레이(hbbr, TCP 21117)를 확인하고, 응답이 멈추면 알림을 발생시킵니다.
이 Mac의 RustDesk 클라이언트가 사용하는 서버도 보여 주며, 클라이언트가 아직 RustDesk 공개 서버를 쓰거나 키가 없거나 다를 때 경고합니다. 클라이언트를 옮기려면 서버마다 공개 키(id_ed25519.pub)를 붙여 넣고, RustDesk ▸ Settings ▸ Network에서 가져올 구성 문자열이나 Windows 설치 프로그램이 스스로 구성되게 하는 파일 이름을 복사하십시오. RustDesk Server에는 macOS 빌드가 없으므로, 직접 RustDesk 서버 운영은 Linux 서버나 VPS용 Docker compose 파일을 제공합니다. 포트를 명시적으로 매핑하고 hbbr -k _로 릴레이가 내 키를 가진 클라이언트에만 응답하게 합니다.
RustDesk2.toml의 서버 설정만 읽으며, 기기 비밀번호가 들어 있는 파일은 읽지 않습니다. 자체 호스팅하면 누가 누구에게 연결했는지에 대한 기록이 RustDesk 공개 서버에 남지 않으며, 세션은 어느 쪽이든 종단 간 암호화됩니다.8.13KVM-over-IP: 콘솔과 전원, 원격 관리
SSH와 화면 공유는 머신이 켜져 있고 네트워크에 연결되어 있어야 합니다. 그렇지 않을 때 — 커널 패닉, BIOS/펌웨어 화면, 끝내 올라오지 않은 네트워크 스택 — 에는 대역 외 접근이 필요합니다. 운영 체제와 무관하게 실제 HDMI 출력을 캡처하고 USB 키보드/마우스 입력을 주입하는 KVM-over-IP 장치입니다. Remote KVM 패널에는 보유한 장치를 몇 대든 등록할 수 있습니다 — PiKVM, JetKVM, TinyPilot, NanoKVM, GL.iNet Comet, 또는 일반 장치 — 각각 고정할 수 있고, 클릭 한 번으로 BIOS까지 내려가는 웹 콘솔을 열 수 있습니다.
전원 제어가 있는 장치는 마지막 고리를 채웁니다. ATX 보드를 단 PiKVM, 네트워크 PDU, 또는 KVM이자 스마트 전원 플러그인 GL.iNet의 Comet Pro (GL-RM10)는 주전원을 전환할 수 있어, 완전히 멈춘 서버의 전원을 강제로 재투입할 수 있습니다. 이런 장치를 서버의 Power 섹션(SwitchBot, UPS, PDU 명령 옆)에서 전원 소스로 연결하면 On/Off/Cycle을 사용할 수 있습니다. AI 관리자도 이를 제어할 수 있습니다. list_kvms, kvm_power, server_power가 있으며, 마지막 도구는 호스트에 연결된 플러그/PDU/KVM을 통해 reboot_host에 응답하지 않는 멈춘 서버를 재시작합니다.
8.14서버 BMC와 Intel AMT: 대역 외에서 하드웨어 상태 확인하기
랙 서버에는 운영 체제가 멈춰도 계속 동작하는 작은 컴퓨터 — 베이스보드 관리 컨트롤러(BMC) — 가 있고, Intel vPro 머신에는 Intel AMT가 내장되어 있습니다. FrontierStack은 이들에서 하드웨어 상태를 읽고 전원을 제어합니다. 원격 KVM 패널에서 KVM 추가 ▸ Server BMC (Redfish), Server BMC (IPMI over LAN) 또는 Intel AMT / vPro로 추가하면 KVM 장치와 고정 및 서버 전원 연결을 공유합니다. 주소, 컨트롤러 계정과 암호(키체인에 보관)를 입력하거나, 부트 미디어에 이미 설정된 컨트롤러라면 부팅 미디어에서 복사…를 사용하십시오. FrontierStack은 각 컨트롤러를 10분마다, 그리고 지금 확인을 누를 때 읽으며, 읽기로 컨트롤러가 변경되는 일은 없습니다.
| 프로토콜 | 컨트롤러 | 읽는 내용 |
|---|---|---|
| Redfish | Dell iDRAC 8/9/10, HPE iLO 4/5/6, Lenovo XCC/XCC2, Supermicro X12 이상, 모든 DMTF Redfish 서비스 | 전원 상태. 시스템, 메모리, 프로세서, 스토리지, 컨트롤러의 종합 상태. 온도, 팬, 전원 공급 장치와 팬/전원 이중화. 하드웨어 이벤트 로그(iDRAC SEL, iLO Integrated Management Log, XCC 플랫폼 로그 또는 SEL, Supermicro 상태 이벤트 로그). 컨트롤러 펌웨어. 라이선스(평가판, 체험판, 임대, 구독 라이선스와 만료일 포함) |
| IPMI over LAN | 이전 iDRAC 및 iLO, Supermicro X9–X11, ASRock Rack, Gigabyte | 섀시 전원과 장애 상태, 센서 목록, 최신 시스템 이벤트 로그 항목(Homebrew의 ipmitool -I lanplus 사용) |
| Intel AMT | Intel vPro 머신 | 전원 상태, AMT 펌웨어 버전, AMT KVM 리디렉션 활성화 여부(WS-Management와 HTTP Digest, 포트 16993(TLS) 또는 16992) |
Redfish는 컨트롤러가 제공하는 것에 따라 기존 Thermal/Power 리소스, 새 ThermalSubsystem/PowerSubsystem 또는 Sensors 컬렉션을 읽습니다. AMT 머신의 VNC 포트가 열려 있으면 화면 공유 링크를 보여 주며, 그렇지 않으면 AMT를 지원하는 뷰어로 콘솔을 여십시오.
전원. 켜기, 끄기(강제 전원 차단), 재투입은 현재 상태를 먼저 읽은 뒤 컨트롤러를 통해 실행합니다(Redfish ComputerSystem.Reset, IPMI chassis power, AMT RequestPowerStateChange). 끄기와 재투입은 항상 확인을 요청합니다. 서버의 전원 섹션에서 컨트롤러를 전원 소스로 연결하면, 위의 KVM 장치와 마찬가지로 server_power로 그 서버를 복구할 수 있습니다.
알림은 컨트롤러에서 기본으로 켜져 있습니다(끄려면 알림 받기 선택을 해제하십시오). 컨트롤러가 응답하지 않거나 자격 증명을 거부할 때, 상태, 센서, 전원 공급 장치, 팬, 이중화 중 하나가 심각 상태가 될 때, 이벤트 로그에 새 심각 항목이 기록될 때, 기간 제한 라이선스가 14일 이내에 만료될 때 알립니다. 첫 번째 읽기는 기존 로그를 기록만 하므로 오래된 항목으로는 알림이 오지 않습니다. 새 항목은 확인 응답을 누르면 지워지고, 1주일이 지나도 저절로 지워집니다. 경고는 표시만 하고 알리지 않습니다. BMC 라이선스는 영구 라이선스이거나 서버와 함께 구매하므로 지출 및 청구에는 아무것도 추가하지 않습니다.
AI 관리자는 kvm 도구의 list 및 health 작업과 server_power의 status 작업으로 이 정보를 읽습니다. 전원 작업에는 변경 허용과 확인이 필요합니다.
.local 주소에서만 사용하며, IPMI 암호는 환경 변수로만 ipmitool에 전달하고 명령줄에는 넣지 않습니다. 인터넷에서 접근할 수 있는 BMC는 그 자체로 심각한 위험입니다. 컨트롤러는 관리용 네트워크에 두십시오.8.15콘솔 연결: 시리얼 및 콘솔 서버 접근
네트워크 설정을 잃은 라우터나 스위치는 SSH, 웹 UI, KVM으로 접근할 수 없지만 콘솔 포트는 여전히 동작합니다. Console Connections 패널(Fleet & Remote)은 FrontierStack에 내장된 시리얼 터미널입니다. USB-시리얼 어댑터(FTDI, Silicon Labs CP210x, WCH CH340/CH9102, Prolific)를 꽂거나 기기 자체의 USB 콘솔 포트(Cisco의 USB mini-B 또는 USB-C, Netgate 방화벽)를 연결하면, 몇 초 안에 Attached serial ports 아래에 어댑터의 칩 이름과 함께 나타납니다. Quick Connect는 아무것도 저장하지 않고 선택한 속도로 엽니다. Save as…는 제조사의 콘솔 설정으로 연결을 저장합니다. Cisco, Juniper, Arista, Aruba CX, ProCurve, Ruckus, Fortinet, Palo Alto, SonicWall, WatchGuard, pfSense/OPNsense, MikroTik, Ubiquiti, TP-Link Omada, Dell OS10, Allied Telesis, APC, Raspberry Pi, Linux, 그리고 OpenWrt 및 GL.iNet 라우터의 보드 레벨 UART를 지원합니다.
모든 설정은 편집할 수 있습니다. 속도(460800과 921600을 포함해 어댑터가 지원하는 모든 속도), 데이터 비트, 패리티, 정지 비트, 흐름 제어와 함께, Return 키가 보내는 값(CR, CR LF 또는 LF), ^H로 보내는 Backspace, 로컬 에코, 그리고 화면에 계단식으로 출력되는 기기를 위한 LF → CR LF 변환이 있습니다. 어댑터를 다른 USB 포트로 옮겨 macOS가 이름을 바꾸더라도 FrontierStack은 USB 일련 번호로 다시 찾아냅니다. 콘솔 서버(Lantronix, Opengear, Digi, Avocent ACS, Cisco 터미널 서버의 reverse telnet, 또는 Raspberry Pi의 ser2net)는 telnet, raw TCP 또는 SSH 연결로 추가합니다.
각 세션은 별도의 윈도우에서 열립니다. Break는 라인 브레이크를 보냅니다 — Cisco ROMMON, Juniper 및 대부분의 부트 로더가 암호 복구 중에 기다리는 신호입니다. DTR과 RTS를 켜고 끌 수 있습니다. 붙여넣기 지연은 붙여 넣은 설정을 한 줄씩 보내므로 9600보드 콘솔에서도 문자가 누락되지 않습니다. 세션 로그는 기기가 보낸 모든 내용을 ~/Library/Logs/FrontierStack/Console에 저장하며, Export로 화면을 저장하거나 이메일로 보낼 수 있습니다. 연결을 고정된 기기에 연결하면 해당 기기 페이지의 Console 섹션에 나타나며, 그곳에서 추가한 콘솔은 해당 플랫폼의 일반적인 설정으로 시작합니다. AI 관리자는 콘솔과 연결된 어댑터를 나열할 수 있지만(kvm, 작업 consoles), 세션을 열거나 세션에 입력하지는 않습니다.
8.16부트 미디어: 네트워크로 운영 체제 설치하기
예전에는 서버를 다시 설치하려면 USB 메모리를 들고 랙까지 가야 했습니다. Boot Media 패널(Fleet & Remote)이 그 USB 메모리를 대신합니다. 설치 이미지를 이 Mac의 라이브러리 한곳에 보관해 두면, 선택한 이미지를 FrontierStack이 대상 머신에 가상 CD로 제공합니다 — 서버의 관리 컨트롤러, PiKVM, Proxmox VE 가상 머신의 CD 드라이브 또는 네트워크 부트 메뉴를 통해서입니다. Mac은 Apple이 더 이상 그런 방식의 부팅을 허용하지 않으므로 다르게 처리합니다. 아래의 Mac을 참조하십시오.
8.25.14이미지 라이브러리
Add ISO or Disk Image…는 로컬 파일을 등록합니다. 파일은 원래 위치에 그대로 있으며 아무것도 복사되지 않습니다. Add Image URL…은 이미 웹 서버나 파일 서버(http, https, nfs 또는 cifs)에 있는 이미지를 등록합니다 — 원격 URL은 대상에 그대로 전달되므로 이 Mac이 데이터를 중계할 필요가 없습니다. Compute SHA-256은 파일의 체크섬을 기록하므로, 그 이미지로 무엇이든 설치하기 전에 제공업체가 공개한 체크섬과 비교할 수 있습니다. 각 항목은 이름 변경, Finder에서 보기, 라이브러리에서 제거가 가능하며, Copy Image URL로 제공 주소를 복사할 수 있습니다. 저장된 위치에 파일이 더 이상 없는 항목은 누락됨으로 표시됩니다.
8.25.15내장 미디어 서버
관리 컨트롤러는 설치가 진행되는 동안 ISO를 HTTP로 조금씩 읽어 들여 마운트합니다. 패널의 Media server는 바로 그 용도로 라이브러리의 로컬 이미지를 제공합니다. 가상 CD에 필요한 바이트 범위 요청과 keep-alive를 지원하며, 최근 요청 로그와 이미지별 전송 바이트 수를 보여 주므로 컨트롤러가 실제로 읽고 있는지 확인할 수 있습니다. 대상에 로컬 이미지가 필요하면 자동으로 시작되며, 직접 Start Serving을 눌러 시작할 수도 있습니다.
| 설정 | 기능 |
|---|---|
| Stop serving after | 1, 3, 6, 12 또는 24시간, 또는 Until I stop it. 읽기가 있을 때마다 타이머가 다시 시작되므로 느린 설치가 도중에 끊기지 않습니다. FrontierStack을 종료해도 제공이 중지됩니다. |
| Address in image URLs | Automatic은 이 Mac이 각 대상에 접근할 때 쓰는 주소를 사용하므로, 별도의 관리 VLAN에 있는 컨트롤러에도 실제로 접근 가능한 주소가 전달됩니다. 고정 주소 하나를 선택할 수도 있습니다. |
| Port | 기본값은 8742입니다. |
| Open Port… | pf 또는 애플리케이션 방화벽이 켜져 있어 컨트롤러를 차단할 수 있을 때 표시됩니다. 관리자 확인 후 포트를 엽니다. |
403을 반환합니다. 각 이미지는 추측할 수 없는 128비트 토큰 URL로, 제공이 켜져 있는 동안에만 공개됩니다. 설치용 ISO는 보통 비밀이 아니지만, 사용자 지정 이미지에는 키나 응답 파일이 들어 있을 수 있으므로 공유 네트워크에서는 Until I stop it을 선택하지 말고 타이머를 켜 두십시오.8.25.16서버 관리 컨트롤러(Redfish)
대부분의 랙 서버에는 이미지를 가상 CD로 제공할 수 있는 베이스보드 관리 컨트롤러가 탑재되어 있습니다. FrontierStack은 표준 DMTF Redfish API로 이를 제어합니다. 대상은 Dell iDRAC 8 및 9, HPE iLO 4, 5 및 6, Lenovo XClarity Controller(XCC), Supermicro X12 이상, 그리고 표준 Redfish 가상 미디어를 구현한 그 밖의 모든 컨트롤러입니다.
- Add Controller를 누르고 주소, 포트, 사용자 이름, 암호를 입력하십시오. 암호는 키체인에 보관되며 컨트롤러에만 전송됩니다. 필요하면 컨트롤러를 플릿 서버에 연결하여 둘을 함께 표시할 수 있습니다. Virtual Media 및 Control 권한이 있는 계정을 사용하십시오.
- Read Controller는 컨트롤러가 관리하는 대상을 검색합니다. 각 시스템의 모델과 전원 상태, 그리고 각 가상 CD 슬롯과 현재 마운트된 내용이 표시됩니다.
- System, Virtual CD, Image를 선택하십시오. Boot from it once를 켜 두면 CD로 한 번만 부팅하고, 그 후에는 서버가 원래 부팅 순서로 돌아갑니다.
- Then에서 Don't restart, Graceful restart 또는 Force restart를 선택하고 Mount(또는 먼저 확인을 요청하는 Mount and Restart)를 누르십시오.
- 설치가 끝나면 가상 CD를 Eject하십시오.
| 컨트롤러 | 가상 미디어 참고 사항 |
|---|---|
| Dell iDRAC 8 / 9 | Enterprise 또는 Datacenter 라이선스가 필요합니다. |
| HPE iLO 4 / 5 / 6 | iLO Advanced가 필요합니다. |
| Lenovo XClarity (XCC) | XCC Advanced 또는 Enterprise가 필요합니다. |
| Supermicro X12 이상 | 표준 Redfish 가상 미디어. X10 및 X11 보드는 자체 콘솔에서만 가상 미디어를 제공하므로, 복사한 URL을 사용해 그곳에서 이미지를 마운트하십시오. |
| 기타 Redfish 컨트롤러 | 표준 VirtualMedia 삽입/꺼내기 동작을 구현한 모든 컨트롤러. |
8.25.17IPMI 컨트롤러와 1회 네트워크 부팅
오래된 보드에는 Redfish가 없거나, Redfish는 있어도 가상 미디어가 없는 컨트롤러가 탑재되어 있습니다: Supermicro X10/X11, ASRock Rack, Gigabyte, Intel, iDRAC 7. 이러한 컨트롤러는 Protocol을 IPMI over LAN으로 설정하십시오. 그러면 FrontierStack이 ipmitool로 제어합니다(Install ipmitool은 앱 내 콘솔에서 Homebrew로 설치합니다). 암호는 키체인에 보관되며 명령줄이 아닌 환경 변수로 ipmitool에 전달됩니다. Read Controller는 전원 상태를 표시합니다. IPMI에는 표준 가상 미디어가 없으므로, IPMI로 OS를 설치하는 방법은 네트워크입니다. Network Boot Once는 다음 부팅을 PXE로 설정하고(chassis bootdev pxe, Legacy BIOS boot를 선택하지 않으면 UEFI 모드), 필요하면 하드 리셋을 보내거나 서버가 꺼져 있으면 전원을 켭니다. IPMI에는 정상 재시작이 없습니다.
Redfish 컨트롤러에도 Network Boot Once가 있습니다. 1회 Pxe 부팅 재정의 후 선택한 방식으로 재시작합니다. 아래의 내장 PXE 서버와 조합하면 가상 미디어 없이도 원격 서버를 이 Mac의 ISO 메뉴로 부팅할 수 있습니다.
8.25.18PiKVM 가상 미디어
PiKVM은 연결된 머신에 USB 드라이브를 에뮬레이트할 수 있습니다. Boot Media는 PiKVM의 문서화된 /api/msd 인터페이스를 사용하며, ATX 전원 제어와 같은 PiKVM API 계정을 씁니다(KVM-over-IP 참조). 먼저 이미지를 PiKVM 자체 저장소에 복사하십시오. 로컬 파일은 진행률 막대와 함께 업로드되며, 원격 URL은 PiKVM이 직접 다운로드합니다. 복사를 시작하기 전에 여유 공간을 확인합니다. 그런 다음 저장된 이미지를 As CD-ROM(ISO의 경우) 또는 As Flash(raw .img의 경우)로 연결하고, 머신의 부팅 메뉴에서 선택하거나 Power Cycle…(확인 후 수행하는 하드 ATX 전원 재투입)을 사용한 뒤, 콘솔을 열어 설치 과정을 지켜보십시오. 작업 후에는 Disconnect Drive와 삭제로 정리합니다.
8.25.19Proxmox VE 가상 머신
Proxmox VE의 가상 머신(아래 Proxmox VE에서 설명한 대로 연결)의 경우 Node, Virtual machine, ISO storage를 선택한 다음 Source를 선택하십시오. Image from the library는 Proxmox가 직접 이미지를 ISO 저장소로 다운로드하게 하므로(download-url 호출), 로컬 이미지는 이 Mac의 미디어 서버에서 가져옵니다. ISO already on Proxmox는 이미 그곳에 있는 ISO를 사용합니다. FrontierStack은 ISO를 VM의 CD 드라이브에 연결하고 부팅 순서에서 CD를 맨 앞에 둘 수 있습니다 — 원래 순서는 기억되었다가 꺼낼 때 복원됩니다. 마지막으로 VM을 그대로 둘지, 시작할지, 리셋할지(확인을 요청하는 하드 리셋) 선택하십시오.
API 토큰에는 다운로드를 위한 Datastore.AllocateTemplate과 Sys.AccessNetwork, 그리고 VM에 대한 VM.Config.CDROM, VM.Config.Options, VM.PowerMgmt 권한이 필요합니다. 패널은 컨트롤 옆에 이 목록을 표시합니다.
8.25.20네트워크 부팅(PXE / iPXE)
컨트롤러도 KVM도 없는 머신도 네트워크로 부팅할 수 있습니다. Serve an iPXE boot menu from this Mac을 켜면 미디어 서버가 iPXE 메뉴도 함께 공개합니다. 이 메뉴는 라이브러리의 모든 ISO를 HTTP로 SAN 부팅하고, 설치 프로그램 카탈로그가 있는 netboot.xyz로 체인하며, iPXE 셸과 boot from local disk를 제공합니다. Download iPXE Boot Loaders는 boot.ipxe.org에서 공식 로더(ipxe.efi, undionly.kpxe, arm64용 ipxe.efi)를 가져오므로 UEFI HTTP Boot 클라이언트가 이 Mac에서 직접 iPXE를 로드할 수 있습니다.
남은 일은 부팅하는 머신을 어디로 보낼지 DHCP 서버에 알려 주는 것입니다. 사용 중인 DHCP server를 선택하고 Copy Settings를 누르면 바로 쓸 수 있는 설정 조각이 복사됩니다.
| DHCP 서버 | 사용하는 경우 |
|---|---|
| dnsmasq | dnsmasq가 DHCP 서버인 경우. 내장 TFTP 서버도 있습니다. |
| dnsmasq (proxy-DHCP) | 라우터가 계속 주소를 할당하고 dnsmasq는 PXE 클라이언트에만 응답하는 경우. |
| ISC dhcpd · Kea | 직접 편집하는 Linux DHCP 서버인 경우. |
| OPNsense / pfSense | 방화벽이 DHCP 서버인 경우. 설정 조각에 해당 네트워크 부팅 필드 이름이 표시됩니다. |
| UEFI HTTP Boot (no TFTP) | 펌웨어가 TFTP 없이 이 Mac에서 HTTP로 iPXE를 다운로드하는 경우. |
8.25.21내장 PXE 서버
네트워크에 dnsmasq가 없고 DHCP 서버도 변경하지 않으려면, 네트워크 부팅 설정에서 Answer PXE clients from this Mac을 켜십시오. 그러면 제공이 켜져 있는 동안 Mac이 두 가지 작은 서비스를 실행합니다.
- ProxyDHCP(UDP 67 및 4011)는 네트워크 부팅을 요청하는 머신(PXE 펌웨어, UEFI HTTP Boot, iPXE)에만, 그리고 부트 파일만 응답합니다. 주소는 절대 할당하지 않으므로 라우터의 DHCP는 이전과 똑같이 계속 작동합니다.
- TFTP(UDP 69, 읽기 전용)는 세 가지 iPXE 로더만 제공하고 그 밖에는 아무것도 제공하지 않습니다. BIOS 머신은
undionly.kpxe, UEFI x64 머신은ipxe.efi, ARM64 머신은 ARM64용ipxe.efi를 받습니다. UEFI HTTP Boot 클라이언트는 대신 HTTP로 로더를 받습니다. iPXE가 실행되면 다시 요청하여 메뉴를 받습니다.
응답할 Network를 선택하고(서비스는 그 인터페이스 하나에만 바인딩됩니다), 필요하면 응답할 머신의 MAC 주소만 나열하십시오. 각 요청과 전송은 스위치 아래에 표시됩니다. 로더는 처음에 자동으로 다운로드됩니다. pf 또는 애플리케이션 방화벽이 켜져 있으면, 서버 섹션의 방화벽 버튼이 이제 UDP 67, 69, 4011도 함께 엽니다.
8.25.22기타 KVM-over-IP 장치
JetKVM 펌웨어. JetKVM, JetKVM Mini, Mini W의 경우 원격 KVM에 설치된 펌웨어와 업데이트 대기 여부가 표시됩니다. FrontierStack은 로그인 없이 KVM의 웹 인터페이스에서 버전을 읽고, 최신 릴리스를 JetKVM 업데이트 서버에 물어보며, 30분마다 다시 확인합니다. 0.5.4 이전 펌웨어는 다운로드한 업데이트가 실제로 JetKVM의 것인지 확인하지 않으므로(CVE-2026-32294) 업데이트 필요로 표시됩니다. JetKVM에서 MQTT를 켜고 기본 토픽을 입력하면 대신 KVM 자체의 업데이트 상태와 온라인 상태, CPU, 온도, 메모리, 저장 공간을 읽습니다. JetKVM은 보통 스스로 업데이트를 설치하지만, 자동 업데이트가 꺼져 있거나 항상 누군가 콘솔에 연결되어 있으면 대기 상태로 남습니다. KVM 행의 알림 받기를 켜면 응답하지 않을 때, 취약한 펌웨어일 때, 업데이트가 일주일 넘게 대기 중일 때 알립니다.
KVM 저장 공간. 소형 KVM은 대부분 SD 카드나 내장 eMMC에서 실행되며, 카드 마모는 부팅이 멈추는 흔한 원인입니다. 각 KVM의 저장 공간 섹션에는 실행 기반(microSD, SD, eMMC, USB, SSD), 용량, 카드 제조사와 모델, 설치 날짜, 예비 카드 보관 위치 같은 메모를 기록합니다. 3년 이상 사용한 이동식 카드에는 마모 경고가 표시됩니다. PiKVM은 PiKVM에서 읽기로 ATX 전원과 같은 API 계정을 사용해 카드의 이미지 파티션 여유 공간을 표시합니다. JetKVM의 저장 공간 사용률은 MQTT를 켜면 표시됩니다. FrontierStack은 카드 자체에서 읽거나 쓰지 않습니다.
JetKVM, GL.iNet Comet, NanoKVM, TinyPilot, Raritan, ATEN, Avocent, Lantronix, Adder 장치에는 가상 미디어용의 안정적인 공개 API가 없으므로, FrontierStack은 이를 제어하는 척하지 않습니다. 대신 Copy URL이 제공을 시작하고 KVM이 접근할 수 있는 이미지 주소를 복사하며, 패널은 해당 제공업체의 자체 콘솔에서 어디에 붙여넣어야 하는지 보여 줍니다.
8.25.23Mac
Mac은 설치 프로그램 ISO로 부팅할 수 없고 네트워크 부팅도 사라졌습니다. Apple silicon에는 네트워크 부팅이 없으며, Intel NetBoot는 macOS Server 5.7에서 서버 기능이 없어졌고 전체 보안 설정의 T2 Mac에서는 거부됩니다. 그래서 Mac의 경우 Boot Media는 Apple이 지원하는 방식으로 macOS를 설치합니다 — SSH로 Mac 자체에서 Apple의 전체 설치 프로그램을 다운로드해 실행하는 방식입니다. 플릿의 모든 원격 Mac에 카드가 표시됩니다(먼저 Remote Servers에서 Mac을 추가하십시오).
- Refresh는 macOS 버전, Apple silicon·Intel·T2 탑재 Intel 여부, 모델, 여유 공간, 이미 있는 설치 프로그램, 콘텐츠 캐싱 사용 여부를 읽어 옵니다.
- List는 사용 가능한 전체 설치 프로그램을 Apple에 조회하고(
softwareupdate --list-full-installers), Download on 해당 Mac은 그중 하나를 백그라운드에서 진행률과 함께 가져옵니다(--fetch-full-installer). - Install…은
startosinstall을 두 가지 모드 중 하나로 실행합니다: Upgrade / reinstall (keeps data) 또는 Erase and install. Apple silicon에서는 볼륨 소유자만 설치를 시작할 수 있으므로 관리자 사용자와 그 암호를 입력합니다. 암호는 표준 입력으로startosinstall에 전달되며 저장되지 않습니다. - Turn On Content Caching(이 Mac 또는 플릿의 아무 Mac에서)은 Apple의 업데이트와 설치 프로그램 사본을 LAN에 보관하므로, 다른 모든 Mac이 Apple 대신 그곳에서 다운로드합니다.
- KVM이 연결된 Intel Mac의 경우 Internet Recovery…는 확인 후 Apple 자체의 네트워크 복구로 재시작합니다. 복구 모드에는 화면 공유나 SSH가 없으므로 이를 조작하려면 KVM이 필요합니다.
8.25.24AI 관리자에서 사용하기
AI 관리자와 MCP 클라이언트는 기존 kvm 도구를 통해 Boot Media에 접근합니다. media_list(읽기 전용)는 라이브러리, 미디어 서버 상태, 각 컨트롤러의 전원과 마운트된 이미지, 각 PiKVM의 드라이브를 보고합니다. media_attach는 대상 — 이름으로 지정한 컨트롤러나 PiKVM, 또는 proxmox:<vmid> — 에 이미지를 마운트하며, boot=true를 지정하면 그 이미지로 재시작도 합니다. media_eject는 이미지를 제거합니다. 연결, 꺼내기, 재시작에는 Allow changes가 필요하며 항상 확인을 요청합니다(13장).
8.25.25시리얼 콘솔 설치
어플라이언스, UP Squared 같은 소형 x86 보드, 콘솔 포트만 연결된 서버에는 설치에 쓸 화면이 없으므로 설치 프로그램을 시리얼 회선에서 실행해야 합니다. 부팅 미디어에서 시리얼 콘솔로 설치를 켜고 머신의 포트(ttyS0–ttyS7, UP Squared의 디버그 UART는 ttyS4)와 속도(9600, 19200, 38400, 57600, 115200보드, 지원하는 UART와 어댑터라면 230400–921600)를 선택하십시오. 그러면 iPXE 메뉴가 netboot.xyz로 시작하는 모든 Linux 설치 프로그램에 console=tty0 console=ttySn,baudn8을 설정하고 netboot.xyz가 화면 지우기 코드를 보내지 않게 합니다.
ISO 자체 부팅 메뉴는 밖에서 바꿀 수 없으므로 설치 프로그램별로 정확한 편집 내용을 보여 줍니다. Ubuntu, Debian(설정이 설치된 시스템에도 이어지도록 --- 뒤에 추가), Rocky/Alma/RHEL(inst.text 포함) 및 기타 Linux ISO의 GRUB/ISOLINUX 커널 줄, Proxmox VE의 Terminal UI, Serial Console 항목(ttyS0, 115200 고정 — 다른 포트나 속도는 편집), pfSense memstick과 OPNsense 시리얼 이미지(다른 속도라면 FreeBSD 로더 명령), 그리고 시리얼 설치 화면이 없는 Windows에는 설치 후의 EMS 명령입니다. 설치된 시스템용 GRUB 설정 복사는 설치 후에도 시리얼 회선을 유지하는 /etc/default/grub 줄을 제공합니다. n보드로 콘솔 열기는 이 Mac에 꽂은 USB 어댑터에서 같은 속도로 세션을 열고, 다른 속도로 저장된 콘솔은 클릭 한 번으로 맞출 수 있습니다.
8.17Proxmox VE: 실시간 클러스터 상태와 게스트 전원
Proxmox VE 호스트는 서버로 가득 찬 서버이며, 노드에 SSH로 접속하는 것만으로는 게스트에 대해 알 수 있는 것이 많지 않습니다. 그래서 Proxmox VE 서비스 페이지(Containers 카테고리, 6장 참조)는 Proxmox 자체 API와 통신합니다. Add Connection을 누르고 클러스터 또는 단일 노드의 주소와 API 토큰을 입력하십시오 — 토큰 ID는 user@realm!name 형식이며, 그 비밀 값은 키체인에 보관되고 Authorization 헤더로만 전송됩니다. Proxmox의 자체 서명 인증서는 사설 주소에서만 허용됩니다. 상태 확인에는 PVEAuditor 역할의 토큰으로 충분하며, 전원 제어와 부트 미디어에는 위에 나열한 추가 권한이 필요합니다.
연결되면 페이지에 클러스터 이름, Proxmox 버전, 쿼럼이 표시되고, 노드별 CPU, 메모리, 루트 디스크, 가동 시간, 모든 VM과 컨테이너의 상태, 저장소별 사용량 막대가 표시됩니다. 각 게스트는 시작, 종료, 재부팅할 수 있으며, 확인 후 강제 중지나 리셋도 할 수 있습니다. Show in Server Activity와 Boot an ISO…는 Proxmox가 나타나는 다른 두 곳으로 이동합니다.
서버 활동 윈도우(11장)에서는 모든 노드가 All Servers, Cluster, Everything 레이아웃의 타일로 표시되며, CPU, 메모리, 디스크, 가동 시간 스파크라인과 “5/7 VMs · 2/3 containers running” 같은 줄이 함께 나타납니다. 노드 세부 정보에는 KPI, CPU 및 메모리 차트, 같은 전원 컨트롤이 있는 게스트 목록, 저장소와 클러스터 정보, 그리고 Open Web UI, Refresh, Boot an ISO…가 표시됩니다.
알림은 백그라운드에서 각 연결을 약 5분마다 새로 고치며 감시합니다: API 접근 가능 여부, 각 노드의 온라인 상태, 클러스터 쿼럼, 사용률이 90%를 넘은 저장소. AI 관리자는 kvm 도구의 proxmox_status 동작(읽기 전용)으로 같은 내용을 볼 수 있으며, proxmox_power로 게스트의 전원을 변경할 수 있습니다. 이때는 항상 확인을 요청합니다.
PVEAuditor로 충분합니다. 나중에 여기서 설치 프로그램을 부팅하기로 하면 VM 및 데이터스토어 권한을 추가하십시오.8.18Garage: 오브젝트 스토리지 클러스터를 한눈에
Garage는 데이터를 여러 개의 작은 노드(대개 서로 다른 장소)에 분산하는 경량 S3 호환 오브젝트 스토어입니다. Garage 서비스 페이지(오브젝트 스토리지 카테고리)는 Garage의 관리 API를 통해 여러 Garage 클러스터를 모니터링합니다. 클러스터 추가를 누르고 노드 하나의 관리 엔드포인트와 관리 토큰을 입력하십시오. LAN에서는 포트 3903과 일반 HTTP를 기본으로 가정하므로 10.0.0.5:3903만으로 충분합니다. 노드 하나가 클러스터 전체의 상태를 보고합니다. 다른 노드를 두 번째 엔드포인트로 추가하면 첫 번째 노드가 중지되어도 클러스터를 계속 볼 수 있습니다. 토큰은 Keychain에 보관되고 Authorization 헤더로만 전송되며, 일반 HTTP는 사설, Tailscale 또는 .local 주소에만 사용되고 그 밖의 주소는 https://여야 합니다. Garage 2.x(관리 API v2)와 0.9/1.x(v1)를 모두 지원합니다.
섹션의 첫 줄은 모든 클러스터를 정상, 확인 필요, 중지로 나누어 셉니다. 이어서 각 클러스터의 상태 — healthy, degraded(사본 수가 부족한 데이터가 있음) 또는 unavailable(읽거나 쓸 수 없는 데이터가 있음) — 를 연결된 노드 수, 가동 중인 스토리지 노드 수, 쿼럼이 있는 파티션 수와 완전히 복제된 파티션 수, 레이아웃 버전, 영역, 할당된 용량과 함께 표시합니다. 그 아래에는 중지된 노드와 가장 많이 찬 디스크부터 모든 노드가 표시됩니다: 영역, 용량, Garage 버전(다른 노드와 버전이 다른 노드는 강조), 드레인 상태, 데이터 및 메타데이터 디스크 사용량. /metrics도 읽기를 켜면 등록한 노드에서 재동기화에 실패한 블록 수(항상 0이어야 하는 값)도 셉니다.
알림은 약 5분마다 각 클러스터를 확인합니다: 관리 API 연결 가능 여부, 클러스터 상태, 레이아웃의 각 노드, 클러스터 임계값(변경하지 않으면 90%) 이상인 데이터 및 메타데이터 디스크, 오류가 난 블록. AI 관리자는 get_server_health의 area object_storage로 같은 내용을 읽습니다. 여기서는 클러스터를 변경하지 않습니다.
admin_token 대신 garage admin-token create로 FrontierStack 전용 토큰을 만들고 범위를 GetClusterHealth와 GetClusterStatus로 제한하십시오(그 토큰으로 /metrics도 읽는다면 Metrics를 추가하십시오).8.19Avid NEXIS 및 Avid 앱
Avid NEXIS는 Avid를 쓰는 편집실과 오디오 포스트 프로덕션 대부분이 사용하는 공유 스토리지입니다. Avid NEXIS 서비스 페이지(스토리지 및 NAS)는 여러 NEXIS 시스템을 모니터링합니다. NEXIS 추가를 누르고 System Director 주소를 입력하십시오. FrontierStack은 SNMP로 읽습니다 — NEXIS Management Console에서 SNMP를 켜고, 커뮤니티를 입력하거나(Keychain에 보관) 비워 두어 기기 검색의 SNMP 설정을 사용하십시오. System Director 상태, 라이선스 한도 대비 연결된 클라이언트 수, 가장 많이 찬 디스크, 워크스페이스 사용량과 할당량, 처리량, NEXIS가 이벤트 로그 확인을 요청하는지를 표시합니다. NEXIS 2025.2 이상에 API 라이선스가 있으면 Management API 사용자를 추가하여 스토리지 그룹, 워크스페이스, 미디어 팩, 라이선스 상태도 표시합니다. FrontierStack은 같은 확인 중에 로그인, 읽기, 로그아웃을 합니다. 시스템이 응답하지 않거나, System Director가 오프라인이 되거나, 사용률이 임계값(기본 90%)에 도달하거나, 모든 클라이언트 라이선스가 사용 중이거나, 이벤트 로그에 플래그가 서거나, 미디어 팩에 문제가 있으면 알림이 발생합니다. 같은 페이지에 이 Mac의 Avid NEXIS Client와 마운트된 워크스페이스도 표시됩니다.
Avid는 Media Composer, Pro Tools, Sibelius의 각 릴리스를 특정 macOS와 Mac에 대해 인증하며, 그 시기는 Apple 출시 후 몇 달이 걸리기도 합니다. 각 앱의 서비스 페이지(AV 및 무대)는 이 Mac에 있는 앱을 찾아 버전을 Avid가 공개한 표와 비교합니다. 대상은 실행 중인 macOS, 이 Mac의 칩, 다음 macOS입니다. 업데이트로 편집실이나 믹스 룸이 Avid가 인증하지 않은 macOS로 바뀌게 되면 보안 업데이트의 이 Mac macOS 업데이트 아래에도 경고가 표시되며, 설치된 앱이 이 Mac에서 인증되지 않은 동안 선택적 알림도 발생합니다. 각 구독을 페이지의 요금제 및 비용 카드에 기록하면 지출 및 청구에 반영됩니다.
8.20오래된 Mac, Raspberry Pi & Windows 호스트
플릿의 의미 중 하나는 오래되었거나 특이한 하드웨어를 계속 쓸모 있게 유지하는 것입니다. 아직 macOS Server를 실행하는 구형 Xserve나 Mac mini도 다른 호스트와 똑같이 연결됩니다. Remote Apache 검색은 Server.app 고유의 Apache 트리와 내부 포트를 이해하므로 해당 웹 사이트가 표시되고 편집할 수 있으며, 모니터의 레거시 Intel 빌드는 OS X 10.11 El Capitan까지 거슬러 올라가 실행됩니다. 선반 가득한 Raspberry Pi도 일반 Linux 머신으로 연결됩니다 — 모니터의 arm 빌드가 Zero를 포함한 모든 Pi를 지원합니다 — 따라서 다른 모든 것과 나란히 CPU, 디스크, 서비스를 지켜볼 수 있습니다.
Pop!_OS 등 Ubuntu 기반 시스템은 OS 이름에 들어 있는 “Linux”라는 단어가 아니라 배포판으로 식별합니다. Pop!_OS는 스스로를 “Pop!_OS 24.04 LTS”라고 보고하기 때문에 이전 릴리스에서는 Linux로 인식되지 않았고, (일부 Ubuntu 호스트처럼) 모니터의 자체 업데이트가 거부되었습니다. apt 계열에서는 서버의 패키지 도구(Manage in Server Activity…)에 있는 업데이트 확인이 apt만으로는 알 수 없는 정보도 보고합니다: 설치되었지만 아직 실행되지 않은 새 커널(Pop!_OS나 일부 Debian처럼 /var/run/reboot-required가 만들어지지 않는 환경에서도 감지), EFI 시스템 파티션의 여유 공간 — Pop!_OS는 systemd-boot로 부팅하고 kernelstub이 모든 커널과 initrd를 이곳에 복사하므로, 공간 부족은 커널 업데이트가 도중에 실패하는 흔한 원인입니다 — 그리고 Flatpak 앱의 업데이트 수.
Windows 호스트는 Microsoft의 OpenSSH 서버를 통해 참여합니다. SSH 진단을 위해 Linux 머신처럼 연결하고, 모니터를 네이티브 Windows 서비스로 설치하십시오(Windows 서비스는 머신 환경 변수를 안정적으로 상속하지 않으므로 설정은 실행 파일 옆의 파일에서 읽습니다). Windows용 모니터는 SSH로 푸시하지 않습니다. 대신 PC에서 frontierstack.app/windows-monitor에서 FrontierStack Monitor Setup을 다운로드해 실행하십시오(PowerShell은 필요 없습니다). 모니터 서비스를 설치하고, 개인/도메인 네트워크에서 로컬 네트워크와 Tailscale에만 방화벽 규칙 하나를 연 뒤 페어링 코드를 표시합니다. 그 코드를 PC의 ‘호스트 모니터’ 섹션(코드로 페어링)이나 기기 검색 ▸ 모니터 찾기에서 PC 주소와 함께 입력하십시오. 비밀을 보내기 전에 FrontierStack은 모니터가 제시한 인증서에 대해 코드를 알고 있음을 증명하게 하므로, 지문을 직접 비교할 필요가 없습니다. 코드는 한 번만 사용할 수 있습니다. 다른 Mac과 페어링하려면 설치 프로그램을 다시 실행하고 ‘신뢰하는 Mac을 삭제하고 다시 페어링’을 선택하십시오. 제거는 Windows의 ‘설치된 앱’에서 할 수 있습니다. 인터넷에 연결되지 않은 PC에는 여전히 Windows… ▸ 설치 키트 내보내기로 PowerShell 키트를 만들 수 있습니다.
진단을 넘어서는 대화형 제어를 위해 카탈로그에는 원격 접근 도구 — RustDesk, MeshCentral, Apache Guacamole, Windows 원격 데스크톱, WinRM — 도 들어 있지만, 이들은 직접 운영하는 서비스이지 SSH 플릿 자체는 아닙니다. 플릿의 강점은 모든 것을 하나의 윈도우에서 일관되고, 스크립트로 자동화할 수 있으며, 부담이 적게 관리한다는 점입니다 — 그리고 13장의 run_script로 어느 노드든 이름으로 지정할 수 있으므로, AI가 원격 서버를 두 단계씩 진단하고 수정할 수 있습니다: 읽기 전용 테스트, 그다음 최소한의 수정, 그리고 다시 실행하여 확인.
UP Squared 및 기타 UP 보드. AAEON의 UP 보드(UP Squared, UP Squared Pro / V2 / 6000 / Pro 7000, UP 7000, UP Xtreme)는 방화벽, Proxmox 노드, Linux 기기로 화면 없이 자주 사용되는 소형 x86 머신입니다. 다른 Linux 호스트처럼 연결되며, 상태 점검이 보드의 펌웨어 식별 정보(DMI, 시리얼 번호는 읽지 않음)를 읽으므로 서버 페이지에 모델 이름, 3.3V 디버그 UART의 위치와 Linux에서의 ttyS 이름(UP Squared는 ttyS4, 초기 UP Xtreme은 ttyS5), 펌웨어 키(F7 부팅 메뉴, Del 또는 Esc 설정), PXE를 켜는 BIOS 경로가 표시됩니다. 콘솔 연결에는 해당하는 UP Squared / UP 보드 프리셋이 있고, 기기 검색은 AAEON의 MAC 접두사를 인식하며, 이후는 부팅 미디어의 시리얼 콘솔 설치로 진행합니다. 같은 점검으로 다른 하드웨어(Dell, HPE, Supermicro 서버, 디바이스 트리 모델명으로 Raspberry Pi)도 표시합니다.
8.21그룹 정책과 도메인 트러스트
Windows 도메인용 그룹 정책과 트러스트 패널(ID 및 계정 아래, Full Fleet)은 연결된 도메인 컨트롤러를 SSH로 읽습니다. Windows Server DC에는 그룹 정책 관리 기능과 AD PowerShell 모듈이 필요합니다(일반 DC에는 둘 다 있습니다). Samba AD DC는 samba-tool로 읽고, 서버의 sudo 암호가 저장되어 있으면 ldbsearch로 각 GPO가 연결된 위치도 보여 줍니다. 패널에는 탭이 네 개 있습니다.
| 탭 | 표시 내용 |
|---|---|
| 개요 | 도메인, 포리스트, NetBIOS 이름, 기능 수준, PDC 에뮬레이터, 도메인 컨트롤러, SYSVOL 복제 방식(DFSR 또는 폐기된 FRS), 모든 발견 사항. |
| 그룹 정책 | 모든 GPO와 그 연결(적용은 자물쇠, 비활성 연결은 취소선), 사용자 또는 컴퓨터 설정이 꺼져 있는지, 버전 번호, WMI 필터. |
| 트러스트 | 모든 트러스트: 종류(포리스트, 외부, 부모-자식, 영역), 방향, 전이성, 보안 채널 테스트 결과, 보안 설정. |
| 서비스 계정 | 모든 그룹 관리 서비스 계정(gMSA), 독립 실행형 MSA, Windows Server 2025의 위임 관리 서비스 계정(dMSA): 각 암호를 가져올 수 있는 주체(그룹은 해당 서버까지 펼침), SPN, 연결된 컴퓨터, 마지막 암호 변경일. 도메인의 KDS 루트 키도 보여 줍니다. |
찾아내는 것. 그룹 정책: Active Directory와 SYSVOL 버전이 다른 GPO(계속되면 복제가 깨진 것입니다), 아직 FRS를 쓰거나 DFSR로 이전하는 중인 SYSVOL, 없거나 연결되지 않은 기본 정책, 그리고 정보로서 연결되지 않은 GPO, 빈 GPO, 모두 꺼진 GPO. 트러스트: 보안 채널이 실패하는 트러스트(Windows는 nltest /sc_query, Samba는 samba-tool domain trust validate), 외부 트러스트의 SID 필터링 꺼짐, 포리스트 트러스트의 SID 기록 허용, 트러스트를 넘는 TGT 위임, RC4 전용 트러스트, 하위 수준(NTLM) 트러스트, 선택적 인증 대신 포리스트 전체 인증을 쓰는 양방향 트러스트. 들어오는 방향만 있는 트러스트는 상대 도메인에서만 테스트할 수 있습니다.
서비스 계정. KDS 루트 키가 없거나(심각) 아직 유효하지 않은 gMSA, 암호 교체가 늦은 계정, Everyone, Authenticated Users, Domain Users, Domain Computers에 가져오기를 허용한 계정, 아무도 가져올 수 없는 gMSA, 비활성인데 아직 참조되는 계정, 다른 계정을 이어받는 dMSA — 2025년 “BadSuccessor” 기법이며, Administrator나 krbtgt를 이어받는 dMSA는 심각 — 를 발견 사항으로 알려 줍니다. Windows Server 2025 DC가 있으면 dMSA를 만들 수 있는 사용자를 검토하도록 안내합니다(FrontierStack은 OU 권한을 읽지 않습니다). Windows 서버 검사는 연결된 모든 Windows 서버에서 관리 서비스 계정으로 실행되는 서비스(Win32_Service)와 예약된 작업을 읽고, 그 gMSA의 암호를 가져올 수 없는 서버의 항목을 알려 줍니다. 이런 항목은 다음 시작이나 암호 변경 때 실패합니다. 한 번 시작하면 새로 고칠 때마다 검사를 반복합니다. Samba AD(gMSA는 4.20 이상)는 root 권한으로 ldbsearch를 사용해 읽습니다. 계정을 만들거나 변경하지 않으며 암호도 읽지 않습니다.
작업(Windows DC만): 보고서는 GPO의 전체 설정 보고서(Get-GPOReport)를 브라우저에서 엽니다. 모든 GPO 백업…은 DC의 ProgramData\FrontierStack\GPOBackups 아래 날짜별 새 폴더에 Backup-GPO를 실행합니다. 컴퓨터에서 강제 새로 고침…은 도메인 컴퓨터 한 대에 Invoke-GPUpdate를 실행합니다. FrontierStack은 GPO나 트러스트를 만들거나 편집, 연결, 삭제하지 않습니다.
알림으로 감시를 켜면 DC를 30분마다 확인하고, 트러스트가 실패하거나 DC가 응답하지 않으면 디렉터리 서비스 알림을 보냅니다. AI 관리자는 get_server_health의 area=domain으로 같은 상태를 읽습니다.
8.22OpenCore Legacy Patcher Mac: 업데이트해도 안전할까?
오래된 Intel Mac 중 일부는 OpenCore Legacy Patcher(OCLP) 덕분에 Apple이 해당 기종용으로 출시한 적이 없는 최신 macOS를 실행하고 있을 것입니다. 이 경우 재부팅의 의미가 달라집니다. 일반 서버 Mac은 전원 → macOS → FrontierStack 에이전트 순으로 부팅하지만, OCLP Mac은 전원 → 펌웨어 → EFI/OpenCore → macOS → OCLP 루트 패치 → FrontierStack 순으로 부팅합니다. 연결 고리가 하나 늘어날 때마다 무인 부팅이 멈출 수 있는 지점이 생깁니다. macOS 업데이트는 봉인된 시스템 볼륨을 교체하면서 루트 패치도 함께 없애 버리고(Wi-Fi, 그래픽 가속, Bluetooth가 다시 적용될 때까지 사라짐), 메이저 업그레이드에는 먼저 그에 맞는 OCLP 릴리스가 필요하며, 펌웨어의 시동 항목이 OpenCore를 가리키지 않게 되면 누군가 Option 키를 누른 채 “EFI Boot”를 선택할 때까지 머신이 부팅 선택 화면에 멈춰 있습니다 — 그 Mac이 다른 건물에 있다면 훨씬 더 번거로운 일입니다.
OpenCore Patcher 패널(Fleet & Remote)은 Update를 누르기 전에 이를 알 수 있도록 존재합니다. This Mac 또는 연결된 Mac을 선택하면 읽기 전용 검사를 실행합니다 — OCLP 앱 버전, OpenCore의 NVRAM 스탬프(Mac이 실제로 OpenCore를 거쳐 부팅했을 때만 존재), 루트 패치 영수증, bless --getBoot, SIP, 소프트웨어 업데이트 설정, OpenCore가 위장한 모델 뒤의 실제 모델 — 그리고 이를 Remote boot safety 목록으로 정리합니다: 펌웨어 부트 항목 → OpenCore, 기본 부팅 볼륨 설정, 무인 재부팅에 대한 FileVault의 영향, 루트 패치의 존재 및 최신 여부, OCLP 릴리스의 설치된 macOS 지원 여부(최신 GitHub 릴리스와 대조), 대기 중인 macOS 업데이트, macOS 자동 설치 꺼짐, EFI/OpenCore 백업. 그 위에 하나의 판정이 이유와 함께 표시됩니다: Safe to update macOS, Update with caution 또는 Not safe.
이 패널은 의도적으로 OCLP를 관리하지 않습니다 — OpenCore 빌드와 루트 패치 적용은 OCLP 자체 앱에서 수행합니다. 대신 고정된, 되돌릴 수 있는 세 가지 관리 동작을 제공합니다: macOS 자동 설치 끄기(시스템 설정이 OCLP Mac을 무인으로 업데이트하지 않도록), EFI 백업(해당 Mac에 보관되는 EFI/OC 폴더의 아카이브), OpenCore 다시 bless(OCLP의 “Install to disk”가 실행하는 것과 같은 bless --setBoot, OpenCore.efi가 실제로 있지 않으면 거부). 플릿 상태 검사도 모든 고정된 Mac에서 OCLP를 감지합니다. 호스트 행과 서버 활동 윈도우에 표시되며, 루트 패치가 없거나 부트 항목이 OpenCore를 우회하면 알림이 보안 항목을 발생시킵니다.
diagnose ["oclp"]는 전체 보고서를 반환하며, 패널의 판정이 안전으로 나올 때까지 AI의 스크립트는 macOS 업데이트 설치 — 또는 부트 항목이 OpenCore를 우회하는 Mac의 재부팅 — 를 거부합니다. 따라서 “이 Mac을 업데이트한 뒤 왜 Wi-Fi가 사라졌지?”라고 물으면, 공식 지원 Mac에 내릴 진단이 아니라 OCLP = true, 실제 모델, 최근 업데이트, 루트 패치 = 없음이라는 사실에서 출발해 추론합니다.8.23빌드 Mac: 서버에서 Xcode 빌드
Xcode의 빌드 버튼은 항상 눈앞의 Mac에서 빌드합니다. 코어가 많고 서명 환경이 안정적이며 누구의 편집기도 열려 있지 않은 랙의 Mac mini처럼 다른 곳에서 빌드하려면, 연결된 Mac에 빌드 Mac 역할을 주세요(Full Fleet 기능). 서버 패널이나 서버 편집 화면의 스위치를 켜면 패널에 빌드 Mac 섹션이 생깁니다.
이 섹션은 그 Mac이 빌드에 쓸 수 있는 환경을 보여 줍니다. 30분마다 SSH로 읽기 전용 확인합니다: 설치된 Xcode와 선택된 버전, 라이선스 동의와 첫 실행 구성 요소 여부, 남은 디스크, DerivedData·아카이브·시뮬레이터 용량, 시뮬레이터 런타임, 만료일이 있는 모든 코드 서명 인증서. 문제는 알림의 빌드 Mac에 표시됩니다: Xcode 없음, 라이선스 미동의, 여유 공간 30GB 미만(변경 가능), 14일 안에 만료되는 인증서.
프로젝트는 서버별로 저장합니다: git URL, 브랜치, 프로젝트 또는 워크스페이스(선택), 스킴, 대상. 빌드, 테스트, 아카이브는 빌드 Mac의 ~/fs-builds에 저장소를 클론하거나 업데이트한 뒤 콘솔에서 xcodebuild를 실행하므로, 전체 로그를 보고 중간에 취소할 수 있습니다. 빌드 Mac이 직접 저장소에 접근할 수 있어야 합니다. SSH로 서명할 때는 잠긴 키체인을 쓸 수 없으므로, 아카이브는 먼저 로그인 키체인 잠금을 풉니다.
두 가지 설정으로 제대로 된 빌드 서버가 됩니다. Gitea 러너 설정은 act_runner를 설치하고 Gitea에 등록한 뒤 레이블 macos-xcode로 계속 실행합니다. 등록 토큰은 콘솔에 붙여 넣으며 FrontierStack은 저장하지 않습니다. 그러면 runs-on: macos-xcode를 쓴 워크플로가 푸시할 때마다 빌드와 테스트를 실행합니다. 예전에 Xcode Server가 하던 일입니다. 헤드리스 Xcode MCP 켜기는 Xcode 27의 xcrun mcp-server를 빌드 폴더용으로 켜서, 코딩 에이전트가 Xcode 창 없이 그 Mac의 Xcode 도구를 쓸 수 있게 합니다.
xcode 도구는 빌드 Mac과 상태를 나열합니다(action=build_macs). 변경을 허용하면 저장된 프로젝트를 이름으로 지정해 빌드, 테스트, 아카이브할 수 있습니다.8.24마이그레이션 마법사: 스택을 새 기기로 옮기기
오래된 서버를 퇴역시킨다고 해서 “모든 것을 손으로 다시 설치”해야 하는 경우는 드뭅니다. FrontierStack에는 레거시 머신에서 스택을 들어내 선택한 대상 — 이 Mac, 다른 Mac 또는 Linux 머신 — 에 다시 구축하는 안내형 마이그레이션 마법사가 포함되어 있습니다. 원본은 읽기만 하며, 모든 쓰기는 대상에 이루어집니다.
셋업 마이그레이션은 마이그레이션 원본에서 시작합니다: 이 Mac에서 찾은 스택(MAMP, XAMPP, Pancake Stack), Apple Server(Server.app 기기 전체, 아래 참조), Windows, 웹 서버(다른 웹 서버, 개발 도구, 개발 서버), 기타 도구(웹사이트가 아닌 것: 다른 앱의 데이터베이스, Git 서버, hosts 파일과 저장소). 모두 작업 순서대로 진행되며 — 옮길 항목, 옮길 위치, 옮기기 — 마지막은 모두 확인한 뒤 폐기입니다. 구형 Mac 서버 현대화의 Apple PHP 사용 중지와 마찬가지로, 이름을 나열해 확인하기 전에는 아무것도 폐기할 준비가 되지 않습니다. 가져온 각 사이트의 모든 페이지와 파일을 새 Apache에서 가져오고(페이지는 상태와 PHP 소스로, 일반 파일은 원본 사본과 바이트 단위로 비교), 모든 데이터베이스 테이블의 행 수를 원본과 비교합니다. 폴더의 index 페이지가 아닌 스크립트는 열지 않습니다(열면 실행될 수 있기 때문입니다). 다르거나 확인하지 못한 항목은 이름으로 나열되며, 확인을 통과할 때까지 이전 셋업을 유지하라고 안내합니다. 다른 기기로 옮기면 파일(rsync 체크섬)과 테이블을 콘솔에서 같은 방식으로 비교하고, 다른 데이터베이스 앱에서 복사한 것도 테이블별로 확인합니다.
Migrate Setups 패널은 MAMP, XAMPP 또는 Apple Server.app 웹 스택을 처리합니다. 원본을 자동으로 감지한 다음, 옮길 항목을 정확히 선택할 수 있습니다: Homebrew 도구, 웹 파일, MySQL 데이터베이스, 사이트(가상 호스트), MIME 재정의, Apache 모듈, PHP 설정, WordPress wp-config.php 수정, Git 저장소. Set up on 선택기로 대상을 고릅니다. 전체 앱 내 마이그레이션을 하려면 This Mac으로 두고, 연결된 호스트를 선택하면 SSH를 통해 새 기기에 스택을 설치하면서 웹 파일(rsync)과 데이터베이스(SSH를 통한 덤프)를 복사합니다 — Homebrew 대신 apt/dnf를 사용하는 Linux 토글도 있습니다.
기타 도구 ▸ 서버와 설정에는 Import from a Repo…도 있습니다. SSH 설정, Ansible 인벤토리 또는 .env 파일이 들어 있는 폴더나 git 저장소를 지정하면, 검토를 거친 후 서버를 플릿에 추가하고 자격 증명을 Script Secrets 또는 해당 서비스에 추가합니다. FrontierStack AI는 값을 한 번도 보지 않고 다른 구성도 읽을 수 있습니다(13장).
다른 도구에서 옮겨 오시나요? 웹 서버나 개발 도구에서 가져오기…(셋업 마이그레이션 ▸ 웹 서버와 Apache 패널의 Import Sites… 옆)는 Laravel Herd, Laravel Valet, ServBay, AMPPS, DesktopServer, Devilbox, DDEV, Docksal, Lando, Local, DevKinsta, 웹 서버 자체 설정 파일(Caddy, nginx, Lighttpd, OpenLiteSpeed, H2O, Cherokee, Abyss, Tomcat, Jetty, WildFly/Undertow, CivetWeb, Mongoose), 그리고 지금 실행 중인 개발 서버(Python http.server, Uvicorn, Gunicorn, Waitress, Vite, webpack-dev-server, BrowserSync, http-server, live-server, miniserve, Node.js, Bun, Deno)에서 사이트, 설정, 데이터베이스를 가져옵니다. 각 사이트는 포트 80/443의 Apache 사이트(파일을 제공하거나 계속 실행되는 앱 서버로 전달) 또는 Localhost 프로젝트가 됩니다. 도메인, 별칭, HTTPS 인증서, 리디렉션, 프록시 경로가 그대로 옮겨지며, 가져오기 전에 도메인 이름을 바꿀 수 있습니다. Databases 탭은 이 Mac에서 실행 중인 모든 MySQL, MariaDB, PostgreSQL 서버(DBngin, Herd, ServBay, MAMP, Local 등)를 찾아, 선택한 데이터베이스를 해당 서버의 자체 도구로 덤프한 뒤 FrontierStack의 Homebrew MySQL 또는 PostgreSQL에 불러온 뒤, 모든 테이블의 행 수를 원본과 비교합니다(기타 도구 ▸ 데이터베이스 복사…로 따로 쓸 수도 있습니다). Docker 기반 프로젝트(DDEV, Lando, Docksal, Devilbox, DevKinsta)는 각 도구의 명령으로 내보냅니다. 선택 사항으로, 복사한 각 사이트의 wp-config.php 또는 .env가 FrontierStack의 MySQL을 사용하도록 바꿀 수 있습니다(.pre-migrate.bak 사본을 남깁니다).
Windows에서 옮겨 오시나요? C:\laragon 폴더 전체를 Mac으로 복사하고(USB 드라이브, 공유 폴더, Parallels/VMware Windows 디스크, ZIP) 셋업 마이그레이션 ▸ Windows ▸ Windows 스택에서 가져오기…를 사용하세요. 같은 가져오기로 Windows용 XAMPP, WampServer, AMPPS, Uniform Server, IIS도 폴더 사본에서 읽습니다(IIS는 applicationHost.config와 각 사이트 폴더도 복사). 가상 호스트가 없는 폴더는 <폴더>.test가 되며, ASP.NET 사이트는 참고용으로만 복사됩니다. www의 각 프로젝트와 etc/apache2/sites-enabled의 각 가상 호스트가 Laragon 호스트 이름({name}.test 또는 직접 정한 템플릿)의 Apache 사이트가 되고, Windows 경로는 사본 위치로 바뀝니다. Laragon의 data 폴더는 Mac에서 다시 쓸 수 없으므로 먼저 PC에서 데이터베이스마다 내보내고(HeidiSQL ▸ SQL로 데이터베이스 내보내기) Laragon 폴더나 사이트 폴더에 저장하세요. 사이트에 연결되어 데이터베이스 탭에서 불러옵니다.
셋업 마이그레이션 ▸ Apple Server(예전의 Apple Server Migration 패널)는 Server.app 머신 전체를 다룹니다. 원본(이 Mac 또는 원격 Mac)을 지정하면 serveradmin으로 모든 서비스 — 웹 사이트, 메일, 캘린더 및 연락처, 메시지(XMPP), VPN, DNS, DHCP, NetInstall, Open Directory, 파일 공유, Time Machine, 프로파일 관리자 등 — 의 목록을 작성하며, 또한 git 서버, 데이터베이스, Docker, 독립 실행형 Nginx 등 실행 중인 그 밖의 항목도 찾아냅니다. 각 서비스에는 상태 배지와 최신 대체 서비스가 표시되며, 합리적인 대체 서비스가 둘 이상인 경우(캘린더 → Radicale / SOGo / Baïkal, VPN → WireGuard / strongSwan, DHCP → dnsmasq / Kea) 어느 것을 쓸지 선택합니다. 대상 머신과 OS를 선택하면 마법사가 대체 서비스를 설치하고 정확한 이전 체크리스트를 출력합니다. 이 Mac의 웹사이트도 같은 곳에서 옮기며(가상 호스트 전체 + 파일 복사) 폐기하기 전에 같은 확인을 거칩니다. 서비스 실행이 복사한 DNS 영역 파일도 이름을 나열해 원본과 비교합니다. Open Directory(사용자, 그룹, 멤버십)는 아래에 설명하는 계정 패널에서 옮기며, 감지된 git 서버는 Git Server 마이그레이션으로 넘겨집니다. Mac을 떠나지 않고 유지하려면 구형 Mac 서버 현대화(4장)를 사용하십시오.
serviceproxy로 포트 80/443을 받는데, 이전 릴리스 — 특히 High Sierra — 에서는 이 프로세스가 멈춥니다: 연결은 계속 받아들이지만 응답은 하지 않습니다. Ping은 성공하고, 포트 스캔에서는 열려 있으며, SSH도 여전히 작동하므로, 모든 사이트가 응답 없이 멈춰 있는데도 접근 가능한 것처럼 보입니다. 바로 그 때문에 DNS나 네트워크 장애로 오진되기 일쑤이며, 프로세스가 죽지 않으므로 단순한 “서비스가 실행 중인가?” 검사로도 잡아낼 수 없습니다. 원본 머신에 http://127.0.0.1/을 대상으로 서비스 serviceproxy를 지정한 Service Guardian 감시를 설정하십시오(그 뒤의 백엔드를 감시하려면 server-httpd를 사용). 그러면 이전을 계획하는 동안 멈춤이 감지되어 launchctl kickstart로 복구됩니다. 사이트를 일반 Apache로 마이그레이션하면 멈추기 쉬운 프록시가 서비스 경로에서 영구히 제거됩니다.serveradmin을 root로 실행하므로, 먼저 해당 호스트의 설정에 sudo 암호를 저장하십시오(8장, “관리 키와 저장된 sudo 암호”). 일부 Apple 서비스는 설정이 자동으로 이전되며(DNS 영역, Apache 가상 호스트, Postfix main.cf), 다른 서비스는 대체 서비스를 설치하고 절차를 안내합니다 — 마법사가 각각에 Automatic, Assisted 또는 Manual 레이블을 붙이므로 예상치 못한 일이 없습니다.Open Directory 옮기기. 계정 패널의 Open Directory 가져오기…는 마스터(이 Mac은 dscl, 네트워크상의 서버는 LDAP)를 각 사용자의 UID, 기본 GID, 홈 폴더, 셸, 각 그룹의 GID와 멤버까지 읽습니다. 새 디렉터리를 소스로 추가한 다음(OpenLDAP, 389 DS, FreeIPA, Samba AD라면 Active Directory), Open Directory 소스의 마이그레이션/내보내기를 열고 대상 디렉토리에서 선택합니다. 형식은 대상에 맞춰 정해집니다. OpenLDAP과 389 DS는 LDIF(ldapadd로 적용…으로 여기서 기록), FreeIPA는 ipa 명령, Samba AD는 samba-tool 명령 스크립트(콘솔에서 실행…으로 해당 서버에서 SSH로 실행), 클라우드 디렉터리는 CSV입니다. 원본의 번호는 그대로 유지하므로 복사한 파일의 소유자도 바뀌지 않으며, 번호가 없는 항목은 10000부터 부여합니다. 새 디렉터리를 Linux 컴퓨터에서 사용을 켜면 /Users 홈은 /home으로, Linux에 없을 수 있는 셸은 /bin/bash로 바뀌고, macOS staff 그룹(GID 20, Linux에서는 시스템 그룹)의 멤버에게는 10020의 전용 그룹이 생깁니다. 이런 변경은 기록하기 전에 모두 옮기면서 바뀌는 점에 표시됩니다.
ipa passwd, samba-tool user setpassword, ldappasswd). Samba AD 도메인은 UID와 GID를 담을 수 있도록 --use-rfc2307로 프로비저닝되어 있어야 합니다.긴 마이그레이션 동안 계속 동기화하기. 컴퓨터를 옮기는 며칠 또는 몇 주 동안 Open Directory를 계속 사용한다면 [대상 확인] 아래의 폐기할 때까지 계속 동기화…를 사용하십시오. 정한 간격(15분, 1시간, 6시간, 1일)마다 Open Directory를 다시 읽어 새 디렉터리의 사용자, 그룹, 멤버십을 추가하거나 갱신합니다. OpenLDAP과 389 DS는 ldapmodify, FreeIPA는 바인드 계정의 Kerberos 티켓을 쓰는 ipa 명령, Samba AD는 도메인 컨트롤러에서 root로 실행하는 samba-tool과 ldbmodify를 사용합니다. 새 디렉터리가 이미 계정에 부여한 번호는 유지하므로 누군가를 추가해도 다른 사람의 번호는 바뀌지 않습니다. 아무것도 삭제하지 않습니다. Open Directory에서 제거된 사람은 목록에 표시되고 알림이 한 번 가므로 직접 제거하십시오. 관련 서버에는 데이터베이스 복제본처럼 사이드바에 동기화 배지가 붙으며, 남은 항목이 있거나 실행이 늦으면 주황색, 마지막 실행이 실패하면 빨간색입니다. 실패는 알림에도 표시됩니다. Open Directory를 폐기하면 중지를 누르십시오.

사이트 빌더에서 옮기려면. 셋업 마이그레이션 ▸ 사이트 빌더 ▸ STUDIO에서 가져오기…는 내보내기 기능이 없는 STUDIO(studio.design)의 사이트를 옮깁니다. 사이트 주소를 입력하면 FrontierStack은 사이트가 모든 방문자에게 보여 주는 내용을 읽고(STUDIO 로그인 불필요), 페이지, CMS 항목(날짜, 커버 이미지, 카테고리, 태그가 있는 글로), 이미지를 이 Mac의 새 WordPress 사이트에 추가합니다. FrontierStack이 WordPress를 내려받고, 사이트 전용 데이터베이스와 MySQL 사용자를 만들고, 그 이름의 Apache 사이트를 추가해 설치합니다(WordPress 패널에 이미 있는 사이트도 선택할 수 있습니다). 예전 주소에서의 리디렉션도 준비합니다. 최신 STUDIO 사이트는 완성된 페이지에서 읽고, 빈 페이지로 도착하는 예전 사이트는 방문자의 브라우저와 같은 요청으로 STUDIO의 게시 저장소와 CMS 서비스에서 읽습니다. 디자인, 애니메이션, 공유 머리글과 바닥글, 양식, 글꼴은 가져오지 않으며, 가져오기가 끝나면 그 체크리스트가 표시됩니다. 새 사이트가 준비되면 호스트에 게시…가 웹사이트 복제를 열어, 사이트와 데이터베이스를 STUDIO 사이트와 같은 주소로 서버나 호스팅 계정에 복사하도록 설정합니다. WordPress 사본에는 그 위치 전용 데이터베이스 로그인이 적힌 새 위치용 wp-config.php가 만들어집니다. 가져오기 실행에는 라이선스가 필요하지만 사이트 확인에는 필요 없습니다.
Figma에서 옮기려면. 셋업 마이그레이션 ▸ 사이트 빌더 ▸ Figma Sites에서 가져오기…는 Figma Sites로 게시한 사이트(name.figma.site 또는 자체 도메인)에 대해 같은 일을 하며, 역시 Figma 로그인은 필요 없습니다. WordPress 사이트를 고르면 페이지, 컬렉션 항목, 이미지를 위와 같이 WordPress로 옮기고, 정적 사이트를 고르면 Figma의 레이아웃을 그대로 유지합니다. 각 페이지를 스타일, 이미지, 글꼴과 함께 같은 주소의 일반 HTML로 저장하고 Figma 스크립트를 제거한 뒤, 지정한 이름으로 Apache가 폴더를 제공합니다. 애니메이션, 동영상, 임베드, 코드 컴포넌트는 Figma 스크립트가 추가하는 것이라 어느 쪽이든 옮겨지지 않고 체크리스트에 실립니다. 디자인 파일은 오픈소스 디자인 도구 Penpot으로 옮깁니다. Penpot 패널이 Docker로 이 Mac에 설치하고, Figma 패널의 Penpot으로 옮기기…가 Figma 파일을 나열하고, Penpot의 공식 Figma 플러그인으로 내보낸 파일을 Penpot 프로젝트에 업로드하며, 옮긴 파일에 체크 표시를 합니다.
Canva에서 옮기려면. 셋업 마이그레이션 ▸ 사이트 빌더 ▸ Canva Websites에서 가져오기…는 Canva로 게시한 웹사이트(name.my.canva.site 또는 자체 도메인)에 대해 같은 일을 하며, Canva 로그인은 필요 없습니다. 그 주소에 게시된 모든 디자인이 각각 한 페이지로 옮겨지며, name.my.canva.site/my-site처럼 경로를 붙이면 그 디자인만 옮깁니다. WordPress 사이트를 고르면 텍스트와 이미지를 테마로, 정적 사이트를 고르면 Canva의 레이아웃, 이미지, 동영상, 글꼴을 일반 HTML로 유지하고 Canva 스크립트는 제거합니다. 양식, 임베드, 애니메이션은 옮겨지지 않고 체크리스트에 실립니다. 디자인 자체를 남기려면 Canva 패널(디자인 도구)을 자신의 통합으로 Canva Connect API에 연결하고 디자인 백업…을 사용하십시오. 소유한 모든 디자인을 Canva의 하루 500회 내보내기 한도 안에서 PDF, PNG, PowerPoint, MP4 또는 HTML로 이 Mac의 폴더에 내보냅니다.
8.25Git Server: Gitea & 저장소 마이그레이션
Git Server 패널은 자체 호스팅 Gitea(자동 HTTPS를 위해 Caddy 뒤에 배치)를 어떤 대상 — 이 Mac, 연결된 서버, NAS, Docker 호스트 또는 Linux 머신 — 에든 구축하며, 플랫폼을 감지하여 알맞은 방법으로 설치합니다. 실행되면 액세스 토큰으로 연결하여 실시간 모니터를 사용할 수 있습니다: 버전, 저장소 수, 그리고 미러가 원본보다 뒤처지면 알리는 백업 지연 알림.
같은 패널은 다른 Git 서버를 Gitea로 마이그레이션하거나 미러링합니다. 디스크의 bare 저장소 — 레거시 macOS 앱 Simple Git Server, Xcode Server, Gitolite, 일반 git-daemon 또는 아무 폴더 — 를 지정하거나, git://, https:// 또는 ssh:// 클론 기본 주소로 실행 중인 원격 서버를 지정하십시오(저장소 이름은 SSH로 열거하거나 붙여넣기). Scan은 저장소를 나열하고, Migrate는 각 저장소를 전체 기록, 모든 브랜치와 태그와 함께 미러 클론한 뒤 Gitea로 푸시하며, 대상 저장소는 API로 생성합니다. 복사는 이 Mac에서 실행됩니다.

FrontierStack 사용자 설명서 · 버전 1.0.0 · 제8장