휴대폰에서 Docker 관리하기
컨테이너 상태를 확인하는 데 노트북은 필요 없습니다. Docker를 실행하는 호스트에 SSH로 접속하면 컨테이너 목록 보기, 로그 읽기, 죽은 서비스 재시작, 업데이트 받기까지 모두 휴대폰에서 할 수 있습니다. 홈랩이나 소형 VPS에 이상적입니다. 무언가 고장 나면 소파나 기차 안에서 고칠 수 있죠. 여기서는 실용적인 명령 모음과 모바일에서 이를 수월하게 만드는 방법을 소개합니다.
1단계 — Docker 호스트에 SSH 접속
Docker는 호스트(Raspberry Pi, NUC 또는 VPS)에서 실행됩니다. 모바일 클라이언트에서 그 호스트에 SSH로 접속하세요(Android / iPhone). 셸에 들어가면 이미 Docker와 직접 대화하고 있는 것입니다 — 특별한 앱은 필요 없습니다.
2단계 — 실제로 쓰게 되는 명령
| 목표 | 명령 |
|---|---|
| 실행 중인 컨테이너 목록 | docker ps |
| 전체 목록(중지된 것 포함) | docker ps -a |
| 컨테이너 로그 추적 | docker logs -f <name> |
| 컨테이너 재시작 | docker restart <name> |
| 컨테이너 셸 진입 | docker exec -it <name> sh |
| 리소스 사용량 | docker stats |
| 공간 확보 | docker system prune |
3단계 — Docker Compose 스택
Compose로 스택을 운영한다면 스택 폴더로 cd 한 뒤 다음을 사용하세요:
docker compose ps— 무엇이 떠 있는지docker compose logs -f— 전체 추적docker compose pull && docker compose up -d— 최신 이미지로 업데이트docker compose restart <service>— 서비스 하나 재시작
작은 화면에서 더 쉽게
휴대폰에서 긴 Docker 명령을 입력하는 것이 성가신 부분입니다. 두 가지가 도움이 됩니다. 자주 쓰는 명령을 스니펫으로 저장해 한 번의 탭으로 재사용하는 것, 그리고 AI 어시스턴트에 기대는 것입니다. TermAI에서는 목표를 설명하기만 하면 — "nextcloud 컨테이너의 로그를 보여줘", "어느 컨테이너가 메모리를 가장 많이 쓰는지" — 검토 후 실행할 수 있는 정확한 명령을 얻습니다. 작은 키보드에서 플래그를 기억하는 것보다 낫습니다.
로그에 빠지지 않고 읽기
휴대폰에서 로그를 따라가는 것은 보통 괴롭습니다 — 읽는 속도보다 빠르게 흘러가는 텍스트의 벽. TermAI는 이를 전용 로그 스트림 모드로 처리합니다. docker logs -f나 docker compose logs -f 같은 추적 명령을 실행하면 툴바가 나타납니다 — 일시정지/재개(흐름을 멈추고 실제로 읽을 수 있게), Filter(최근 500줄을 검색하고 오류·경고·정보를 색으로 구분), 그리고 AI 버튼(최근 100줄을 어시스턴트에 넘겨 "여기서 무엇이 잘못됐는지" 빠르게 판단). 작은 화면에서 이것은 "끝없이 스크롤하기"와 "오류를 바로 찾기"의 차이입니다.
외출 중 호스트에 닿기
외출 중에 Docker를 관리하려면 SSH를 인터넷에 노출하지 마세요. Tailscale(TermAI에 내장)을 사용해 어디서든 Docker 호스트의 프라이빗 주소에 닿으세요. iPhone의 Tailscale을 참고하세요.
자주 묻는 질문
휴대폰용 Docker 앱이 있나요?
Docker API와 통신하는 GUI 앱이 있지만, 가장 간단하고 유연한 방법은 호스트에 SSH로 접속해 일반 docker CLI를 쓰는 것입니다. 어떤 설정에서도 작동하며 추가로 노출하는 것이 없습니다.
대신 휴대폰에서 Portainer를 관리할 수 있나요?
네, Portainer를 설치했다면 그 웹 UI가 모바일에서 작동합니다. SSH는 더 저수준이고 항상 사용 가능하며 사전 설치가 필요 없는 대안입니다.
죽은 컨테이너를 빠르게 재시작하려면?docker restart <name>, 또는 Compose 서비스라면 docker compose restart <service>.
핵심 요약
- 방법: Docker 호스트에 SSH로 접속해 일반
dockerCLI 사용 - 핵심 명령:
docker ps,docker logs -f,docker restart,docker stats - Compose:
docker compose pull && docker compose up -d로 업데이트 - 모바일에서: 스니펫 + AI 어시스턴트가 긴 플래그 입력보다 낫다
- 원격: 노출된 SSH가 아니라 Tailscale 사용
Free on iOS and Android. 5 AI requests/day on the free tier, plus unlimited SSH/SFTP and built-in Tailscale.