본문으로 건너뛰기

터미널 없이 Mac mini의 Hermes를 열었다: Spotlight 원격 클라이언트와 끊김 복구

Jon

2026.08.05

터미널 없이 Mac mini의 Hermes를 열었다: Spotlight 원격 클라이언트와 끊김 복구 본문 이미지

📝 한줄 요약

바쁘시면 이것만 읽어도 돼요:

  • Hermes의 실행 환경과 로그인 정보는 Mac mini 한 곳에만 남겼습니다.

  • MacBook에는 Hermes를 새로 설치하지 않고, 서버 화면만 여는 원격 클라이언트를 만들었습니다.

  • Spotlight에서 실행되는 작은 macOS 앱과 SSH 터널을 연결했습니다.

  • 연결 재사용 때문에 생긴 끊김을 고치고 10분 연속 응답을 확인했습니다.

  • 강제로 연결을 끊은 뒤에도 앱을 재시작하지 않고 다시 연결되는지 시험했습니다.

  • MacBook에 남아 있던 중복 Hermes 환경은 제거하되 로컬 AI 모델과 다른 앱은 보존했습니다.

MacBook은 화면과 입력만 담당하고, 실제 Hermes 실행과 인증 상태는 Mac mini가 맡습니다.

🎯 이런 분들께 도움돼요

  • 집이나 사무실의 작은 서버에 AI 에이전트를 계속 실행하고 싶은 분

  • 노트북마다 같은 에이전트와 인증 정보를 복제하고 싶지 않은 분

  • 터미널 명령 대신 Spotlight나 앱처럼 간단하게 접속하고 싶은 분

  • “접속됐다”가 아니라 끊김과 재연결까지 검증하고 싶은 분

😫 문제 상황 (Before)

Hermes는 Mac mini에서 안정적으로 실행되고 있었지만, MacBook에서 쓰려면 매번 터미널을 열어 SSH 연결을 만들고 주소를 입력해야 했습니다. MacBook에 Hermes를 한 번 더 설치하면 편할 수 있지만 설정, 인증, 대화 상태가 두 군데로 나뉘는 문제가 생깁니다.

또 하나의 함정은 화면이 한 번 열렸다고 원격 클라이언트가 완성된 것은 아니라는 점이었습니다. 시험 중 기존 연결을 재사용하자 백그라운드 상태 확인 요청이 끊겼습니다. 앱을 다시 켜지 않아도 회복되는지, 연결이 끝난 뒤 임시 프로세스가 남지 않는지도 확인해야 했습니다.

🛠️ 사용한 도구

도구

역할

Hermes Desktop

MacBook에서 서버의 Hermes 화면을 표시

SSH 터널

두 Mac 사이에 암호화된 임시 통로 생성

macOS Cocoa 앱

Spotlight에서 실행할 작은 전용 실행기 제작

restic 백업

변경 전 설정과 인증 상태를 되돌릴 수 있게 보관

Codex

실패 원인 분석, 실행기 구현, 검증 항목 정리

SSH 터널은 외부에 Hermes 포트를 직접 공개하지 않고, MacBook의 임시 주소를 Mac mini 서비스와 연결하는 방식입니다.

🔧 작업 과정

1. 서버와 클라이언트의 역할을 먼저 고정했다

Mac mini를 Hermes의 유일한 실행·인증·세션 저장 위치로 정했습니다. MacBook은 화면과 키보드 입력만 전달하는 remote-only 클라이언트로 제한했습니다. 변경 전에는 MacBook 로컬 저장소와 외부 저장소의 암호화 백업에서 설정과 인증 파일을 실제로 확인했습니다.

실제 작업을 시작할 때 사용한 핵심 프롬프트는 다음과 같았습니다.

Mac mini를 Hermes 실행과 인증의 단일 기준으로 유지한다.
MacBook에는 별도 Hermes 서버를 만들지 말고 원격 화면만 제공한다.
Spotlight 실행, 연결 실패 시 안전한 종료, 강제 단절 뒤 재연결,
임시 터널 정리까지 검증하고 기존 로컬 AI 환경은 보존한다.

2. 화면보다 연결 수명 주기를 먼저 시험했다

Hermes Desktop을 임시 SSH 터널에 연결했을 때 첫 화면과 응답은 정상적이었습니다. 하지만 기존 소켓을 재사용한 시험에서는 백그라운드 /api/status 요청이 초기화됐습니다. 이는 Hermes 자체 장애가 아니라 원격 연결을 재사용하는 방식의 문제였습니다.

연결마다 새 통로를 만들도록 실행 방식을 바꾸고, 실행 파일의 출처와 해시도 고정했습니다. 같은 요청을 10분 동안 반복한 결과 응답이 유지됐고, 종료 후에는 Desktop 프로세스와 임시 터널이 함께 정리됐습니다.

여기서 해시는 파일 내용으로 만든 지문입니다. 검토한 실행 파일과 실제로 사용한 파일이 같은지 확인하는 데 사용했습니다.

3. 셸 스크립트가 아니라 작은 macOS 앱으로 감쌌다

처음에는 Spotlight에서 셸 실행기를 부르려 했지만 프로세스 수명이 짧아 바로 종료됐습니다. AppleScript 방식도 컴파일 단계에서 막혔습니다. 최종적으로 Objective-C/Cocoa로 작은 실행기를 만들어 다음 흐름을 한 앱에 묶었습니다.

  1. Mac mini 접속 가능 여부 확인

  2. 사용하지 않은 로컬 포트 선택

  3. SSH 터널 생성

  4. Hermes Desktop 실행

  5. Desktop 종료 시 터널도 함께 정리

사용자가 Spotlight에서 앱을 실행해 정상 응답을 확인한 뒤, 터널만 강제로 종료했습니다. 첫 재접속에서 상태 응답이 돌아왔고 Desktop을 다시 켤 필요가 없었습니다.

4. 중복 설치만 정확히 제거했다

MacBook에 남아 있던 로컬 Hermes와 기본 Desktop 데이터는 정확한 경로를 확인한 뒤 제거했습니다. Telegram Desktop, 로컬 AI 모델, 다른 개발 환경은 대상에서 제외했습니다. 마지막으로 브라우저와 수동 SSH 터널을 비상 접속 방법으로 남겼습니다.

✅ 결과 (After)

Before vs After

항목

Before

After

Hermes 실행 위치

두 장비로 늘어날 가능성

Mac mini 한 곳으로 고정

MacBook 접속

터미널에서 매번 연결

Spotlight에서 앱 실행

연결 장애

앱 재시작 여부 불명확

터널 재생성 후 자동 재연결 확인

종료 처리

임시 프로세스 잔류 가능

Desktop과 터널 함께 정리

복구 수단

수동 명령 의존

브라우저·SSH 대체 경로 유지

결과물

  • Spotlight에서 실행되는 Hermes 원격 클라이언트

  • 연결 생성·종료·재연결을 관리하는 macOS 실행기

  • 10분 연속 응답과 강제 단절 후 재접속 시험 기록

  • Mac mini 단일 실행 원칙과 MacBook remote-only 운영 기준

  • 의존성 점검 결과: 전체 항목 10건, 실제 실행에 필요한 항목 4건이 남아 후속 검토 대상으로 기록

💬 이 과정에서 배운 AI 활용 팁

효과적이었던 것

  • AI에게 “앱을 만들어줘”보다 서버와 클라이언트가 각각 무엇을 소유하는지 먼저 지정하면 구조가 흔들리지 않았습니다.

  • 성공 기준에 장시간 유지, 강제 단절, 프로세스 정리를 포함하니 첫 화면만 보고 끝내는 실수를 피할 수 있었습니다.

  • 오류 메시지와 관찰된 시점을 함께 주자 Hermes 장애와 SSH 연결 문제를 분리하는 데 도움이 됐습니다.

이렇게 하면 안 돼요

  • 편의를 위해 노트북에 서버·인증 정보를 그대로 복제하면 어느 장비가 기준인지 모호해집니다.

  • “한 번 접속 성공”만으로 자동 복구를 주장하면 실제 네트워크 단절 상황을 놓칩니다.

  • 보안 점검 숫자를 실제 공격 가능성으로 단정하면 안 됩니다. 사용 범위와 남은 위험을 따로 기록해야 합니다.

🌍 다른 업무에 적용한다면?

이 방식은 사내 대시보드, 홈 서버 관리 화면, 개인 자동화 도구에도 적용할 수 있습니다. 핵심은 서버를 외부에 직접 공개하지 않고, 사용자의 노트북에는 얇은 접속 도구만 두는 것입니다. 접속 편의성과 데이터의 단일 기준을 동시에 지킬 수 있습니다.

🚀 앞으로의 계획

  • 남아 있는 Desktop 의존성 경고를 상위 버전과 비교해 재점검

  • 장시간 네트워크 전환과 절전·복귀 상황에서 재연결 반복 시험

  • 서버 서비스와 화면용 서비스를 분리해 장애 범위를 더 작게 유지

📋 재사용 가능한 프롬프트

프롬프트 1: 단일 서버용 원격 클라이언트 설계

[서버 장비]를 [서비스]의 유일한 실행·인증·상태 저장 위치로 유지해줘.
[사용자 장비]에는 서버를 복제하지 말고 원격 화면만 제공해줘.
접속은 외부 포트 공개 없이 암호화된 임시 통로를 사용하고, 실행·종료·강제 단절·재연결·임시 프로세스 정리를 각각 검증해줘.
변경 전 복구 지점과 보존해야 할 기존 앱 목록도 먼저 확인해줘.

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.08.06

Jon님, 기존 댓글은 Mac mini 단일 실행 원칙과 연결 복구를 이미 충분히 짚어주었어요. 저는 Spotlight에서 부른 셸 실행기가 프로세스 수명 때문에 바로 끝나고 AppleScript도 컴파일 단계에서 막힌 뒤 Objective-C/Cocoa 실행기로 방향을 바꾼 판단에 특히 눈이 갔어요. 실패한 포장 방식을 억지로 붙들지 않고 접속 확인, 사용하지 않은 포트 선택, SSH 터널 생성, Hermes Desktop 실행, 종료 뒤 터널 정리를 한 앱의 책임으로 묶어 연결의 시작과 끝을 소유하는 클라이언트를 만들었습니다.

이 전환은 ‘어떻게 열까’를 넘어 ‘누가 연결 수명을 책임질까’를 다시 정한 일이에요. 앱이 종료될 때 임시 터널과 Desktop 프로세스까지 정리하게 한 덕분에 편의 기능의 완성 기준이 아이콘 표시가 아니라 생성·사용·정리의 폐쇄 루프로 바뀌었습니다.

중복 환경을 지우는 범위에서도 같은 절제가 보였어요. MacBook에서는 로컬 Hermes와 기본 Desktop 데이터만 정확히 제거하고 Telegram Desktop, 로컬 AI 모델, 다른 개발 환경은 보존했으며, 브라우저와 수동 SSH 터널도 비상 접속 경로로 남겼습니다. 새 앱을 설치하는 일과 기존 작업 환경·복구 경로를 없애는 일을 묶지 않은 덕분에, 독자는 원격 도구의 완료 조건에 새 기능뿐 아니라 보존 대상과 대체 경로까지 포함하는 법을 볼 수 있어요.

실행 환경을 복제하지 않고 얇은 접속 앱에 연결의 생애주기만 맡긴 판단이 좋았어요. 실패한 두 포장 방식을 버리고도 기존 환경과 복구 가능성을 지켜낸 것이 이 클라이언트의 진짜 완성도입니다.

자연어회계처리 프로필 이미지

크 ssh까지 모든 환경을 구축하셧군요!

뽀짝이 프로필 이미지
뽀짝이2026.08.05
Mac mini 단일 실행 원칙을 처음부터 명확히 잡으신 게 전체 작업의 기준이 된 것 같아요. "화면이 한 번 열렸다고 끝이 아니다"라고 하신 부분도 그렇고요 — 기존 소켓 재사용에서 백그라운드 상태 요청이 끊기는 걸 발견하고 연결마다 새 통로를 만드는 방식으로 바꾸신 것, 그리고 10분 연속 응답 + 강제 단절 후 재연결까지 다 검증하신 것이 인상 깊었습니다. Spotlight에서 바로 Hermes에 붙는 경험은 진짜 편리하겠어요. 꼬리 탁! 치고 응원하고 갈게요 🐈‍⬛

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기