파일을 ZimaOS에 업로드해야 하는 감시 카메라라면, 카메라가 지원하는 경우 SFTP를 사용하세요. ZimaOS에서는 개발자 모드에서 SSH를 활성화할 수 있으므로 별도의 FTP 서버를 설치하지 않고도 암호화된 SFTP 경로를 사용할 수 있습니다.
카메라가 기존 FTP만 지원한다면 vsftpd와 같은 컨테이너를 사용할 수 있지만, 포럼의 YAML에는 20번과 21번 포트만 노출되어 있었습니다. 이는 수동 FTP에 필요한 설정이 부족할 수 있으며, “디렉터리를 읽을 수 없음”이라는 증상으로 보아 호스트 폴더 권한도 확인해야 합니다.
카메라가 지원한다면 먼저 SFTP를 사용하세요
현재 ZimaOS SSH 설정 가이드에서는 ZimaOS 인터페이스에서 SSH를 활성화하는 방법을 설명합니다. 일반적으로 SFTP를 지원하는 클라이언트는 SSH를 통해 ZimaOS 주소에 연결하며, 보통 22번 포트를 사용하고 대상 경로에 대한 권한이 있는 계정으로 인증합니다.
SFTP와 FTP는 서로 다른 프로토콜입니다. 카메라가 FTP만 지원한다고 명시되어 있다면 포트만 변경해서 SFTP를 사용할 수는 없습니다.
FTP가 필요하다면 수동 포트도 구성하세요
해당 스레드에서 사용한 컨테이너는 fauria/vsftpd였습니다. vsftpd 컨테이너 문서에는 PASV_MIN_PORT와 PASV_MAX_PORT 같은 수동 모드 변수가 설명되어 있으며, 해당 포트 범위도 함께 공개해야 한다고 안내되어 있습니다.
LAN 카메라의 경우 FTP 서비스를 신뢰할 수 있는 로컬 네트워크로 제한하세요. 일반 FTP는 자격 증명이나 파일 전송을 암호화하지 않으므로 공용 인터넷에 직접 노출해서는 안 됩니다.
연결된 업로드 폴더를 확인하세요
포럼 예시에서는 ZimaOS 호스트 디렉터리를 /home/vsftpd에 연결했습니다. Docker 바인드 마운트는 호스트 파일 시스템을 직접 사용하므로 컨테이너 프로세스에도 해당 디렉터리에 대한 호환 가능한 소유권과 권한이 필요합니다.
로그인에는 성공했지만 목록 표시나 업로드에 실패한다면 호스트 경로가 존재하는지, 컨테이너에서 해당 경로가 보이는지, FTP 사용자가 그곳에 쓸 수 있는지 확인하세요. 카메라를 중요한 보관 저장소에 연결하기 전에 임시 폴더로 테스트하세요.
실용적인 테스트 순서
- 카메라가 SFTP를 지원하는지, 아니면 FTP만 지원하는지 확인하세요.
- LAN에 연결된 데스크톱 클라이언트에서 동일한 자격 증명으로 테스트하세요.
- 업로드를 테스트하기 전에 디렉터리 목록이 표시되는지 확인하세요.
- FTP 수동 모드의 경우 구성한 수동 포트 범위를 공개하세요.
- 데스크톱 테스트가 성공한 후에만 동일한 호스트, 포트, 사용자 및 경로를 카메라에 입력하세요.
장치 연결 가이드에서는 로컬 네트워크에 적합한 연결 방법을 선택하는 데 도움이 되는 추가 정보를 제공합니다.
