SSH Server 0.13.0: 이제 SSH 셸은 사용자 폴더 안에만 머뭅니다

SSH Server 0.13.0이 휴대폰, 태블릿, Android TV용으로 Google Play에 출시되었습니다. 이번 릴리스는 일부 사용자분들이 겪었던 문제를 해결합니다. 이제 SSH 셸이 SFTP와 같은 규칙을 따릅니다. 각 사용자의 셸은 설정한 폴더만 볼 수 있고, 그 밖의 것은 볼 수 없습니다.

왜 중요한가요

SSH Server에서는 사용자마다 폴더 목록을 지정합니다. SFTP는 항상 이 목록을 지켜 왔습니다. Download만 받은 사용자는 Download만 볼 수 있었습니다.

하지만 SSH 셸은 그렇지 않았습니다. 같은 사용자가 ssh로 터미널을 열면 셸은 앱 자체의 비공개 폴더에서 시작했고, 앱이 접근할 수 있는 모든 곳을 둘러볼 수 있었습니다. 이 때문에 혼란스러웠고("셸에서 Download 폴더를 찾을 수 없어요"), 셸을 쓰는 사람에게는 폴더 목록이 실제 제한이 되지 못했습니다.

0.13.0부터는 폴더 목록이 어디서나 제한이 됩니다.

이제 셸에서 보이는 것

셸은 해당 사용자에게 SFTP가 보여 주는 폴더와 정확히 같은 폴더를 봅니다.

• 폴더가 하나인 경우: 그 폴더가 /로 보입니다. 사용자에게 /storage/emulated/0을 주면, 셸의 /는 내부 저장소가 됩니다.
• 폴더가 여러 개인 경우: /에 별칭으로 나열됩니다. Download와 DCIM(Photos로 표시)을 가진 사용자는 /에서 정확히 두 폴더 Download와 Photos만 봅니다.
• 그 밖의 모든 것은 사라집니다. 저장소의 나머지 부분, 앱 자체의 데이터, 다른 앱의 데이터는 아예 보이지 않습니다. 바깥으로 이어지는 경로는 ..이나 /proc을 이용한 Linux 기법을 포함해 모두 사용자 폴더 안에 머뭅니다.

ls, cd, cp, mv, find, cat, 파이프, 스크립트, 백그라운드 작업 같은 익숙한 셸 도구는 그대로 동작합니다. 이 명령들이 실행될 수 있도록 Android 시스템 파일은 여느 Android 셸처럼 읽을 수 있습니다.

다음은 SSH Server 0.13.0의 실제 세션입니다.

읽기 전용 폴더와 숨은 파일도 적용됩니다

SFTP에서 이미 알고 계신 두 설정이 이제 셸에서도 동작합니다.

• 쓰기 가능: 폴더의 쓰기 가능 상자를 해제하면, 셸은 그 폴더를 열고 읽고 파일을 밖으로 복사할 수 있지만, 안에서 아무것도 만들거나 바꾸거나 이름을 바꾸거나 삭제할 수 없습니다. 읽기 전용 디스크처럼 Read-only file system이 표시됩니다.
• 숨은 파일 보기: 사용자에게 이 설정이 꺼져 있으면, 점으로 시작하는 파일과 폴더(.ssh, .cache 등)가 셸의 목록에서도 빠집니다. ls -a, find, 탭 자동 완성도 마찬가지입니다. SFTP와 같이 정확한 이름으로는 숨은 파일을 열 수 있습니다.

설정 방법

새로 켤 것은 없습니다. 셸은 이미 사용자마다 설정한 폴더를 사용합니다.

1. SSH Server를 열고 사용자 관리를 누릅니다.
2. 사용자 옆의 연필 아이콘을 누릅니다.
3. 접근 경로에서 추가하기를 누르고 폴더를 고릅니다. 사용자에게 줄 폴더마다 반복합니다.
4. 읽기 전용으로 둘 폴더는 쓰기 가능을 해제합니다.
5. ✓를 눌러 저장합니다. 그 사용자가 다음에 로그인하면 셸에 정확히 이 폴더들이 보입니다.

사용자에게 셸을 아예 주고 싶지 않다면, 같은 화면의 Shell 비활성화 스위치로 끌 수 있습니다.

어디서나 동작, 루팅 불필요

새 셸은 SSH Server가 지원하는 모든 기기에서 루팅 없이 동작합니다. 휴대폰, 태블릿, Android TV, 64비트와 32비트 ARM 및 x86 프로세서 모두 지원합니다. Android 6부터 Android 16까지 테스트했습니다.

아주 오래된 일부 기기, 주로 시스템 커널이 오래된 Android 6과 7 기기에는 셸에 필요한 기능이 없습니다. 이런 기기에서 SSH Server는 제한 없는 셸로 돌아가지 않습니다. 셸을 시작할 수 없다는 짧은 메시지를 보여 주고 세션을 닫습니다. 이런 기기에서도 SFTP는 정상적으로 동작합니다.

두 가지 수정 사항

잘못된 경로로 SFTP 세션이 끊기지 않습니다. 내 폴더 밖의 경로(예: ls /storage/emulated/0)를 열면 Connection closed와 함께 연결이 끊길 수 있었습니다. 이제는 일반적인 "not found" 메시지가 나오고 계속 작업할 수 있습니다.

Android 15 이상에서 사용자 관리와 SFTP 로그 화면이 제대로 표시됩니다. 최신 Android 버전에서 이 두 화면의 제목과 뒤로 가기 화살표가 상태 표시줄 아래로 밀려 들어갔습니다. 이제 상태 표시줄 바로 아래에 표시됩니다.

자주 묻는 질문

제 파일은 원래 /storage/emulated/0에 있었어요. 지금은 어디에 있나요? 사용자의 폴더 안에 있습니다. ls /를 실행해 보세요. 사용자에게 내부 저장소 전체를 줬다면 그것이 바로 /입니다.

셸을 사용할 수 없거나 시작할 수 없다고 나와요. 어떻게 하나요? 사용자에게 접근 경로 폴더가 하나 이상 있는지, SSH Server에 파일 접근 권한이 있는지 확인하세요. 둘 다 문제가 없다면, 셸에 필요한 커널 기능이 없는 소수의 기기입니다. SFTP는 계속 사용할 수 있습니다.

SFTP도 바뀌었나요? 아니요. SFTP는 원래 이렇게 동작했습니다. 바뀐 것은 셸과 위의 SFTP 수정 사항뿐입니다.

다운로드

SSH Server 0.13.0은 지금 Google Play에서 배포 중입니다.

• 휴대폰 및 태블릿: Google Play의 SSH Server
• Android TV: Android TV용 SSH Server

셸과 SFTP에 대해 의견을 보내 주신 모든 분께 감사드립니다. 앞으로도 많은 의견 부탁드립니다!