원격 Mac

macOS Tahoe 26 SSH 단절 후 작업은 어떻게 계속할까? 2026년 가이드

tmux는 SSH 단절 뒤 다시 붙어야 하는 상호작용 작업에 사용하고, 재시작 뒤에도 실행되어야 하는 무인 작업은 launchd 또는 정식 CI Agent로 넘겨야 합니다. SSH KeepAlive는 연결 상태를 감지하는 기능일 뿐 작업을 맡아 실행하는 기능이 아니므로, macOS Tahoe 26 SSH 단절 후 작업은 계속할까라는 문제에는 역할을 나눈 구성이 필요합니다.

이 글은 다음 독자를 위한 안내입니다.

  • SSH로 원격 맥에서 Xcode 컴파일, 테스트, 의존성 설치를 실행하는 개발자
  • AI Agent, 스크립트, 데이터 작업을 오래 실행해야 하는 엔지니어
  • 장시간 온라인인 맥 빌드 노드와 재시작 복구를 점검하는 데브옵스 및 플랫폼 담당자

작업을 시작하기 전에 중단 유형을 나눕니다

SSH 작업이 멈췄는지는 터미널 화면만 보고 판단할 수 없습니다. 단말 창이 닫힌 경우, 네트워크만 끊긴 경우, 사용자가 로그아웃한 경우, 맥 자체가 재시작된 경우는 프로세스와 세션에 미치는 영향이 다릅니다.

단말 창이 닫히거나 연결이 끊기면 일반 전면 작업은 세션 종료의 영향을 받을 수 있습니다. tmux 안에서 실행한 작업은 외부 터미널과 분리할 수 있으므로 다시 접속한 뒤 세션을 확인할 수 있습니다. tmux 공식 문서도 세션을 분리한 뒤 나중에 다시 연결하는 방식을 설명합니다. tmux 시작 문서

사용자 로그아웃은 그래픽 로그인 세션과 사용자 프로세스에 영향을 줄 수 있습니다. 반면 launchd로 정의한 작업은 실행 주체와 권한 범위에 따라 별도로 관리됩니다. 맥 재시작은 더 큰 경계입니다. tmux 세션을 다시 연결하는 문제가 아니라, 부팅 뒤 어떤 서비스가 어떤 조건에서 다시 시작되는지 확인해야 합니다. 애플은 macOS의 백그라운드 작업과 서비스를 launchd 체계로 설명합니다. 애플의 백그라운드 서비스 문서

따라서 선택 기준은 다음처럼 정리됩니다.

  • 사람이 화면을 보며 명령을 이어갈 작업: tmux
  • 재시작 뒤에도 자동으로 실행될 스크립트와 작업: launchd
  • 빌드 큐, 테스트 결과, 재시도와 비밀 값 관리가 필요한 작업: 정식 CI Agent
  • 그래픽 세션이 필요한 도구: 별도의 로그인 세션과 재시작 조건까지 검증

최초 접속 때 진단 가능한 SSH 경로를 만듭니다

macOS Tahoe 26에서 Remote Login을 켜는 것과 작업을 안전하게 맡기는 것은 서로 다른 단계입니다. 먼저 원격 맥의 시스템 설정에서 Remote Login을 활성화하고, 접근 가능한 계정을 지정해야 합니다. 모든 사용자에게 열어 두는 방식은 관리 대상이 넓어지므로 필요한 계정만 허용하는 편이 낫습니다. 설정 위치와 접근 범위는 애플의 Remote Login 설정 안내에서 확인할 수 있습니다.

접속 기록에는 다음 항목을 남깁니다.

  • 가상 호스트 이름과 원격 주소
  • 접속 계정과 허용된 접근 범위
  • 최초 접속 때 확인한 호스트 지문
  • 프로젝트 작업 경로
  • 실제 실행할 명령과 로그 저장 경로

예시에는 실제 주소나 비밀 값을 넣지 않습니다.

ssh build-user@remote-mac.example

접속이 된 뒤에는 작업 경로와 도구 경로부터 확인합니다.

cd /Users/build-user/work/sample-project
pwd
command -v git
command -v xcodebuild

여기서 SSH KeepAlive를 추가할 수는 있지만, 이것을 작업 보존 기능으로 해석하면 안 됩니다. KeepAlive는 연결이 응답하는지 확인하는 데 도움을 줄 뿐이며, 연결이 끊겨도 프로세스를 별도 감독자로 옮기지는 않습니다. 연결이 안정적이어도 전면 프로세스가 보호되는 것은 아닙니다.

macOS Tahoe 26의 버전과 Remote Login 상태도 기록합니다. 운영 노드에서 버전 변경을 추적해야 할 때는 macOS Tahoe 26 공식 안내를 기준으로 확인합니다.

장시간 작업은 tmux 세션 안에서 시작합니다

tmux는 컴파일, 테스트, 의존성 설치처럼 사람이 중간 결과를 확인해야 하는 작업에 적합합니다. 특히 AI Agent처럼 입력을 추가하거나 오류를 보고 다음 명령을 결정해야 하는 작업은 무인 서비스보다 다시 붙을 수 있는 터미널 세션이 관리하기 쉽습니다.

먼저 설치 상태를 확인합니다. Homebrew를 사용하는 환경이라면 tmux 공식 공식 페이지의 설치 정보를 기준으로 현재 명령을 확인합니다.

brew install tmux
tmux -V

세션을 만들고 작업을 시작합니다.

tmux new -s ios-build
cd /Users/build-user/work/sample-project
mkdir -p /Users/build-user/logs
xcodebuild -workspace Sample.xcworkspace \
  -scheme Sample \
  > /Users/build-user/logs/ios-build.log 2>&1

작업을 실행한 상태에서 Ctrl-b 다음 d를 누르면 세션에서 분리됩니다. 이 동작은 작업을 종료하는 것이 아니라 현재 SSH 터미널과 tmux 세션을 분리하는 것입니다. 이후 SSH가 끊겨도 세션이 남아 있는지 다시 확인할 수 있습니다.

현재 세션 목록은 다음처럼 확인합니다.

tmux ls
tmux attach -t ios-build

작업별 세션 이름과 로그 경로를 분리하면 같은 프로젝트에서 중복 실행하는 사고를 줄일 수 있습니다. 로그는 터미널 출력에만 남기지 말고 지속되는 디렉터리에 저장해야 합니다.

SSH가 끊긴 뒤 증거를 먼저 확인합니다

재접속 직후 같은 명령을 다시 실행하는 것은 위험합니다. 기존 컴파일이 계속 실행 중이면 중복 빌드가 생기고, 같은 산출물이나 캐시를 동시에 쓰면서 결과가 오염될 수 있습니다.

다음 순서로 확인합니다.

  • tmux ls로 기존 세션이 있는지 확인합니다.
  • 세션이 있으면 tmux attach로 화면을 다시 연결합니다.
  • 프로세스 목록에서 목표 작업이 실행 중인지 확인합니다.
  • 로그 파일의 마지막 부분과 수정 시각을 확인합니다.
  • 산출물의 생성 시각과 파일 크기를 확인합니다.
  • 종료 상태와 테스트 결과를 별도 기록합니다.

세션이 없다면 즉시 다시 시작하지 말고 로그와 산출물을 먼저 찾습니다. 세션은 없지만 작업 프로세스가 남아 있을 수 있기 때문입니다. 프로세스가 종료되었다면 종료 코드와 마지막 오류를 확인한 뒤 재실행 여부를 결정합니다. 작업은 실행 중이지만 로그가 더 이상 갱신되지 않는다면 멈춤, 입력 대기, 외부 의존성 오류를 구분해야 합니다.

예시는 다음과 같이 사용할 수 있습니다.

pgrep -af xcodebuild
tail -n 80 /Users/build-user/logs/ios-build.log
stat -f "%Sm %z" /Users/build-user/logs/ios-build.log

복구의 종료 조건은 “터미널 화면이 다시 보인다”가 아닙니다. 종료 상태, 핵심 로그, 산출물 생성 여부와 테스트 결과가 서로 맞아야 작업을 성공으로 기록할 수 있습니다.

재시작이 필요한 작업은 launchd로 옮깁니다

tmux는 SSH 단절을 견디게 해 주지만, 운영 체제 재시작 뒤의 자동 복구를 보장하는 서비스 관리자는 아닙니다. 장시간 실행되는 스크립트, 작업 스케줄러와 CI Agent는 launchd 설정으로 시작 조건과 실행 환경을 명확히 해야 합니다.

설정할 항목은 다음과 같습니다.

  • 실행 파일의 절대 경로
  • 작업 디렉터리
  • 필요한 환경 변수
  • 표준 출력과 오류 로그 경로
  • 재실행 조건
  • 작업을 중지하고 다시 불러오는 방법
  • 실행 계정과 파일 권한

LaunchAgent는 사용자 로그인 세션과 연결되는 작업에 사용하고, LaunchDaemon은 사용자 화면과 분리된 시스템 수준 작업에 사용합니다. 그래픽 로그인 세션이 필요한 도구를 LaunchDaemon으로 옮기면 권한이나 화면 접근이 맞지 않을 수 있습니다. 반대로 시스템 작업을 사용자 세션에만 묶으면 로그아웃 뒤 실행되지 않을 수 있습니다.

설정 파일은 실제 계정과 경로에 맞춰 작성해야 합니다. 다음은 구조를 보여 주는 가상 예시입니다.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.example.worker</string>
  <key>ProgramArguments</key>
  <array>
    <string>/Users/build-user/bin/run-worker.sh</string>
  </array>
  <key>WorkingDirectory</key>
  <string>/Users/build-user/work/sample-project</string>
  <key>StandardOutPath</key>
  <string>/Users/build-user/logs/worker.out.log</string>
  <key>StandardErrorPath</key>
  <string>/Users/build-user/logs/worker.err.log</string>
  <key>RunAtLoad</key>
  <true/>
</dict>
</plist>

실제 운영에서는 대상이 사용자 작업인지 시스템 작업인지 먼저 결정한 뒤, 해당 범위에 맞는 launchctl 동작을 사용해야 합니다. 설정 키와 서비스 관리 방식은 launchd 설정 설명서와 launchctl 명령 설명서를 기준으로 확인합니다. 오래된 블로그의 명령을 그대로 기본값으로 사용하지 말고, 현재 권한 범위와 서비스 상태를 함께 확인해야 합니다.

FAQ: 단절과 재시작을 서로 다른 문제로 검증합니다

앞의 설정을 적용한 뒤에는 실제 중단을 의도적으로 만들어야 합니다. SSH를 끊고 다시 연결하는 시험, 클라이언트 네트워크를 바꾸는 시험, 관리 창에서 원격 맥을 재시작하는 시험은 각각 다른 복구 경로를 확인합니다.

FAQ 답변처럼 단순히 “백그라운드에서 실행된다”고 기록하지 말고, 다음 증거를 남깁니다.

  • 단절 전 세션 이름과 프로세스 상태
  • 재접속 후 세션 연결 결과
  • 로그의 연속성
  • 산출물과 종료 상태
  • 재시작 뒤 Remote Login 접근 여부
  • launchd 또는 CI Agent의 실행 상태
  • 그래픽 세션이 필요한 작업의 실제 동작 여부

운영 투입 전 복구 점검표를 실행합니다

다음 항목을 모두 확인한 뒤 원격 맥을 장기 빌드 노드로 분류합니다.

  • [ ] Remote Login이 필요한 계정에만 허용되어 있습니다.
  • [ ] 호스트 지문과 작업 경로가 운영 기록에 있습니다.
  • [ ] 상호작용 작업은 이름이 있는 tmux 세션에서 실행됩니다.
  • [ ] 컴파일과 테스트 로그가 지속 경로에 저장됩니다.
  • [ ] 재접속 뒤 기존 세션과 프로세스를 먼저 확인합니다.
  • [ ] 중복 실행을 막는 재실행 판단 기준이 있습니다.
  • [ ] 재시작이 필요한 작업은 launchd 또는 CI Agent에 등록되어 있습니다.
  • [ ] 사용자 작업과 시스템 작업의 권한 범위가 구분되어 있습니다.
  • [ ] SSH 단절, 네트워크 변경, 노드 재시작을 각각 시험했습니다.
  • [ ] 성공 여부를 화면이 아니라 로그와 산출물로 판정합니다.

현재 사용하는 맥이 장시간 온라인 상태를 유지하지 못한다면, 이 점검 결과를 바탕으로 임시 작업 노드와 상시 노드를 분리할 수 있습니다. KuzCloud의 원격 맥 접속 안내를 먼저 확인한 뒤, 실제 컴파일이나 AI Agent 작업으로 접속 방식과 복구 절차를 검증하는 편이 안전합니다.

조건별 선택 기준을 표로 정리합니다

작업 조건 적합한 방식 SSH 단절 뒤 맥 재시작 뒤 운영 판단
사람이 화면을 보며 명령을 이어감 tmux 세션을 다시 연결 자동 복구 수단으로 보지 않음 임시 또는 상호작용 작업
정해진 스크립트를 계속 실행함 launchd 서비스 상태와 로그 확인 시작 조건에 따라 복구 상시 작업에 적합
빌드 큐와 테스트 결과를 관리함 정식 CI Agent 작업 상태를 CI에서 확인 Agent 등록과 서비스 상태 확인 팀 운영에 적합
그래픽 로그인에 의존함 별도 검증 환경 세션과 화면 상태 확인 로그인 및 화면 접근을 재검증 tmux만으로 결정하지 않음

원격 맥의 사용 기간이 짧고 사람이 직접 확인하는 작업이라면 tmux 기반 환경으로 충분할 수 있습니다. 반대로 재시작 뒤 자동 복구, 반복 실행, 결과 수집이 필수라면 launchd나 CI Agent가 중심이 되어야 합니다. KuzCloud 콘솔에서 제공 방식과 접속 절차를 확인할 때도 이 기준으로 실제 작업을 먼저 검증하는 것이 좋습니다.

기존 방식이 개인 맥 한 대에 의존하면 전원 상태, 로그인 세션, 수동 재실행과 로컬 네트워크에 운영이 묶이는 단점이 있습니다. 일반 클라우드 리눅스 환경은 macOS 전용 도구와 Xcode 빌드를 직접 처리하지 못하고, 로컬 맥을 별도 서버로 유지하는 방식은 장기 온라인 상태와 재부팅 복구를 직접 관리해야 합니다. 이런 조건에서 테스트 기간이나 프로젝트 일정에 맞춰 실제 맥 노드가 필요하다면, KuzCloud의 한국 지역 원격 맥 이용 조건을 확인하고 주간 또는 월간 사용으로 먼저 컴파일과 Agent 복구를 검증하는 방식이 현실적입니다. 상시 고부하 작업이나 물리 장치 연결이 필수인 경우에는 직접 구매가 더 적합할 수 있습니다.

끊김 걱정 없이 원격 맥 작업을 이어가세요

KuzCloud의 원격 맥에서 컴파일과 테스트, 인공지능 작업을 안정적으로 실행할 수 있습니다.

연결이 일시적으로 끊겨도 작업 환경에 다시 접속해 진행 상황을 빠르게 확인할 수 있습니다.