termux-ssh-가이드-diagram.svg
🎣 “서버가 죽었는데 노트북이 없다? 폰으로 5분 안에 복구한다.”
🤔 왜 필요해?
OpenClaw 서버는 24시간 돌아간다. 근데 문제는 언제 터질지 모른다는 것.
- 여행 중인데 서버 다운
- 카페에서 일하는데 에러 발생
- 자기 전에 확인하고 싶은데 컴퓨터 끄기 귀찮음
해결책: 안드로이드폰에 Termux + SSH 설치하면 어디서든 서버 접속 가능.
📱 Part 1: Termux 설치
Google Play Store에서 설치
1. Play Store에서 "Termux" 검색
2. 설치
3. 끝!
공식 스토어 버전이 가장 안전하고 자동 업데이트도 된다.
첫 실행 후 기본 설정
## 패키지 업데이트
pkg update && pkg upgrade
## 기본 도구 설치
pkg install openssh git nodejs-lts vim🔑 Part 2: SSH 설정
Step 1: SSH 키 생성
ssh-keygen -t ed25519 -C "termux@phone"엔터 3번 치면 끝!
- 첫 번째 엔터: 저장 위치 (기본값 OK)
- 두 번째 엔터: 비밀번호 (없어도 됨)
- 세 번째 엔터: 비밀번호 확인
결과 확인:
ls ~/.ssh/id_ed25519 (비밀키)와 id_ed25519.pub (공개키) 두 파일이 보이면 성공!
Step 2: 공개키 서버에 등록
방법 1: ssh-copy-id 사용 (가장 쉬움)
ssh-copy-id 사용자명@서버주소비밀번호 입력하면 자동으로 공개키가 서버에 등록됨!
방법 2: scp로 직접 전송
## 공개키를 서버로 복사
scp ~/.ssh/id_ed25519.pub 사용자명@서버주소:~/
## 서버에 접속해서 등록
ssh 사용자명@서버주소
cat ~/id_ed25519.pub >> ~/.ssh/authorized_keys
rm ~/id_ed25519.pub방법 3: 수동 복사 (다른 기기 경유)
- Termux에서 공개키 내용 복사:
cat ~/.ssh/id_ed25519.pub- 출력된 내용을 메모앱이나 메신저로 자신에게 전송
- PC에서 서버 접속 후
~/.ssh/authorized_keys에 붙여넣기
📝 용어 설명
| 항목 | 예시 | 설명 |
|---|---|---|
| 사용자명 | john, admin | 서버 로그인할 때 쓰는 계정 이름 |
| 서버주소 | 192.168.1.100 또는 myserver.com | 서버의 IP 또는 도메인 |
| 전체 형식 | john@192.168.1.100 | 사용자명@서버주소 |
예를 들어:
ssh john@192.168.1.100→ IP로 접속ssh admin@myserver.com→ 도메인으로 접속
Step 3: SSH 접속 테스트
ssh 사용자@서버IP
## 또는
ssh 사용자@서버도메인⚙️ Part 3: 편의 설정
SSH Config로 간편 접속
~/.ssh/config 파일 생성:
vim ~/.ssh/config내용:
Host myserver
HostName 192.168.1.100
User john
Port 22
IdentityFile ~/.ssh/id_ed25519
각 항목 설명:
Host myserver→ 별명 (원하는 이름)HostName→ 서버 IP 또는 도메인User→ 서버 로그인 계정명Port→ SSH 포트 (기본 22)IdentityFile→ 사용할 SSH 키
이제 이렇게만 치면 됨:
ssh myserver자주 쓰는 Alias 설정
~/.bashrc에 추가:
## OpenClaw 빠른 명령어
alias oc='openclaw'
alias ocs='openclaw status'
alias ocr='openclaw gateway restart'
alias ocl='openclaw gateway logs'
## 서버 접속
alias srv='ssh myserver'적용:
source ~/.bashrc🚨 Part 4: OpenClaw 트러블슈팅
상황 1: OpenClaw가 응답 안 함
증상: 텔레그램 메시지에 응답 없음
진단:
## 서버 접속
ssh myserver
## OpenClaw 상태 확인
openclaw status해결:
## 재시작
openclaw gateway restart
## 로그 확인
openclaw gateway logs상황 2: 에러 로그 확인
## 최근 로그 100줄
openclaw gateway logs | tail -100
## 실시간 로그 모니터링
openclaw gateway logs -f상황 3: 프로세스가 완전히 죽음
증상: openclaw status도 안 됨
해결:
## 프로세스 확인
ps aux | grep openclaw
## 남은 프로세스 강제 종료
pkill -f openclaw
## 새로 시작
openclaw gateway start상황 4: 포트 충돌
증상: “Port already in use” 에러
해결:
## 포트 사용 중인 프로세스 찾기
lsof -i :3000
## 해당 프로세스 종료
kill -9 <PID>
## OpenClaw 재시작
openclaw gateway restart상황 5: 디스크 용량 부족
증상: 이상한 에러들, 로그 안 쌓임
확인:
df -h해결:
## 로그 정리
openclaw gateway logs --clear
## 불필요한 파일 삭제
rm -rf ~/.openclaw/media/inbound/old/*📋 빠른 참조 카드
필수 명령어
| 명령어 | 설명 |
|---|---|
openclaw status | 상태 확인 |
openclaw gateway start | 시작 |
openclaw gateway stop | 중지 |
openclaw gateway restart | 재시작 |
openclaw gateway logs | 로그 확인 |
openclaw gateway logs -f | 실시간 로그 |
긴급 복구 순서
1. ssh myserver
2. openclaw status
3. (문제 있으면) openclaw gateway restart
4. openclaw gateway logs | tail -50
5. (여전히 문제면) pkill -f openclaw && openclaw gateway start
💡 Pro Tips
1. Termux:Widget으로 원탭 접속
Termux:Widget 앱 설치하면 홈 화면에 바로가기 위젯 추가 가능.
~/.shortcuts/ 폴더에 스크립트 만들기:
mkdir -p ~/.shortcuts
echo '#!/bin/bash
ssh myserver -t "openclaw status"' > ~/.shortcuts/oc-status.sh
chmod +x ~/.shortcuts/oc-status.sh2. Mosh로 불안정한 연결 대응
모바일 네트워크는 끊김이 잦다. Mosh가 해결책:
## Termux에 설치
pkg install mosh
## 서버에도 설치
sudo apt install mosh
## 접속
mosh myserverMosh는 연결이 끊겨도 자동 재연결됨.
3. tmux로 세션 유지
## 서버에서
tmux new -s openclaw
## 작업 후 detach
Ctrl+B, D
## 나중에 다시 attach
tmux attach -t openclaw모바일 연결이 끊겨도 서버 작업은 계속 진행됨.
⚠️ 보안 주의사항
1. SSH 키 비밀번호 설정
키 생성 시 비밀번호 설정 권장:
ssh-keygen -t ed25519 -C "termux@phone"
## 비밀번호 입력 (선택이지만 권장)2. 폰 분실 대비
폰 잃어버리면 서버 접근권도 탈취될 수 있음.
대비책:
- SSH 키에 비밀번호 설정
- 서버에서 해당 공개키 즉시 삭제 가능하도록 메모
- 2FA 설정 고려
3. 루트 로그인 비활성화
서버 /etc/ssh/sshd_config:
PermitRootLogin no
PasswordAuthentication no
✨ 한줄 정리
“Termux + SSH = 주머니 속 서버 관리자. 5분 안에 어디서든 OpenClaw 복구.”