TL;DR

TimeCapsuleSMB는 Apple AirPort Time Capsule의 구형 AFP·SMB1 환경에 Samba 4.24.3을 직접 설치해 현대 macOS에서 SMB3 공유와 Time Machine 백업을 가능하게 하는 독립형 도구입니다. macOS GUI 앱 또는 Python 3.9+ CLI가 Bonjour 탐색, SSH 설정, 바이너리 배포, 상태 점검, 제거를 처리하며, 장치의 제한된 플래시와 HDD 마운트 문제를 고려해 실행 파일을 RAM 디스크로 옮겨 구동합니다. Gen 1~4 장치는 선택적 펌웨어 boot hook 패치가 필요할 수 있고, 인증은 Time Capsule 장치 비밀번호를 사용하며 내부 접근이 `root`로 매핑되므로 LAN 안에서만 운용해야 합니다.

핵심 포인트

• TimeCapsuleSMB는 Apple AirPort Time Capsule에 Samba 4.24.3을 설치하는 독립형 도구이며 macOS GUI 앱과 Python CLI를 함께 제공합니다. 호스트에서 장치를 Bonjour로 찾고 SSH를 활성화한 뒤 정적으로 빌드된 바이너리와 부트 스크립트를 Time Capsule에 배포합니다. macOS 27에서 AFP가 제거된 뒤에도 SMB3 네트워크 공유와 Time Machine 백업을 계속 사용하려는 환경에 적합합니다.
• Time Capsule의 약 900KB 플래시 공간과 16MB RAM 디스크 제약을 피하도록 전체 Samba payload를 내부 HDD에 두고 실행 시 바이너리를 RAM 디스크로 복사합니다. 작은 `/mnt/Flash/rc.local`이 부팅 때 HDD 마운트를 기다린 뒤 런타임을 `/mnt/Memory`에서 시작하고 별도의 mDNS·NBNS helper가 네트워크 광고를 담당합니다. 이 구조는 Apple 펌웨어가 유휴 상태의 HDD를 마운트 해제하는 문제를 우회합니다.
• 설치는 `bootstrap`, `configure`, `deploy`, `doctor` 순서로 진행하며 `doctor`가 SSH, 프로세스, TCP 445, Bonjour, 인증된 파일 작업과 영구 xattr 저장소까지 검사합니다. NetBSD 6 기반 Gen 5 장치는 배포 후 자동으로 시작되지만 Gen 1~4 NetBSD 4 장치는 재부팅마다 `activate`가 필요할 수 있습니다. `flash --patch`는 주 펌웨어 뱅크에 부트 hook을 기록해 자동 시작을 가능하게 하지만 펌웨어를 직접 수정하므로 백업과 검증 절차가 필요합니다.
• 인증은 임의의 사용자 이름과 현재 Time Capsule 장치 비밀번호를 사용하며 부팅 시 AirPort의 `syPW` 값을 읽어 RAM에 Samba 인증 파일을 생성합니다. 게스트 접근은 꺼져 있고 내부적으로 SMB 접근을 `root`에 매핑하므로 인터넷에 포트를 노출하지 않는 LAN 전용 구성이 필요합니다. AirPort Extreme은 공식 지원 대상이 아니며 하드 드라이브가 없는 모델에는 설치할 공간이 없어 사용할 수 없습니다.

이미지 분석