커뮤니티 솔루션

ZimaOS에서 SSH 및 웹 터미널 활성화 방법

An IceWhale tutorial updated for ZimaOS 1.2.5 moved SSH activation into Settings > Developer Mode and marked the older monitor, Alt+F2, root-password workflow as obsolete.

현재 ZimaOS에서는 웹 인터페이스에서 직접 SSH를 활성화할 수 있습니다. 커뮤니티 튜토리얼은 원래 연결된 디스플레이와 키보드가 필요한 이전 절차를 기반으로 작성되었지만, 이후 ZimaOS 1.2.5에 맞게 업데이트되었으며 기존 작업 흐름이 더 이상 사용되지 않는다고 명시되었습니다.

현재 시스템에서는 일반적인 경로가 설정 > 개발자 모드 > SSH 액세스입니다. ZimaOS는 동일한 개발자 중심 영역에서 웹 기반 터미널도 제공하므로, 이제 많은 명령줄 작업에 외부 모니터나 별도의 SSH 클라이언트가 필요하지 않습니다.

현재 ZimaOS에서 SSH를 활성화하는 방법

업데이트된 IceWhale 튜토리얼에는 다음 세 단계가 안내되어 있습니다.

  1. 설정을 여세요.
  2. 개발자 모드로 이동하세요.
  3. SSH 액세스를 켜기로 전환하세요.
SSH 액세스 활성화를 시작하는 데 사용되는 ZimaOS 설정 화면
먼저 ZimaOS 설정을 여세요. 이제 SSH 제어 기능이 웹 인터페이스의 일부로 제공됩니다.
SSH 및 터미널 설정이 포함된 ZimaOS 개발자 모드 페이지
업데이트된 튜토리얼에서는 별도의 콘솔 설정 없이 SSH 제어 기능을 개발자 모드로 이동했습니다.
SSH 액세스 스위치가 활성화된 ZimaOS 개발자 모드
실제로 원격 셸 액세스가 필요할 때만 SSH 액세스를 켜세요.

현재 ZimaOS SSH 가이드에는 동일한 개발자 모드 절차가 설명되어 있으며, 2026년 8월에 업데이트되었습니다.

SSH 활성화 후 연결하는 방법

동일한 신뢰할 수 있는 네트워크에 있는 다른 컴퓨터에서 SSH 클라이언트를 사용하고 ZimaOS 서버의 LAN IP를 입력하세요.

ssh USERNAME@ZIMAOS_LAN_IP

정확한 사용자 이름과 인증 방식은 사용하려는 계정에 따라 다릅니다. 현재 ZimaOS SSH 문서에는 ZimaOS 사용자 계정을 로그인에 사용할 수 있지만, 루트 액세스는 별도의 비밀번호 설정 경계를 가진다고 명시되어 있습니다. 보편적인 기본 루트 비밀번호가 하나 있다고 가정하지 마세요.

보안 원격 액세스 계층을 의도적으로 구성한 경우가 아니라면 SSH 액세스를 신뢰할 수 있는 네트워크로 제한하세요. UI에서 SSH를 활성화했다고 해서 라우터의 포트 22를 공용 인터넷에 직접 포워딩해야 한다는 뜻은 아닙니다.

별도의 SSH 클라이언트 없이 내장 웹 터미널 사용

업데이트된 커뮤니티 튜토리얼에도 웹 기반 터미널 토글이 표시됩니다. 이를 통해 관리자는 다른 컴퓨터에서 별도의 터미널 애플리케이션을 열지 않고도 ZimaOS 브라우저 인터페이스에서 셸에 액세스할 수 있습니다.

웹 기반 터미널 옵션이 표시된 ZimaOS 개발자 모드
ZimaOS는 별도의 데스크톱 SSH 클라이언트를 사용하는 것과 별개로 브라우저 기반 터미널을 제공할 수 있습니다.
ZimaOS 웹 UI에서 열린 브라우저 터미널 인터페이스
내장 터미널은 ZimaOS 웹 인터페이스를 통해 직접 명령줄 액세스를 제공합니다.

루트 비밀번호와 SSH 액세스는 서로 관련이 있지만 동일하지는 않습니다

최신 ZimaSpace SSH 참고 문서에 따르면 root 인증이 필요한 경우 로컬 콘솔 설정 경로를 통해 root 비밀번호를 생성해야 하며, ZimaOS 사용자 계정을 SSH 로그인에 사용할 수도 있습니다. 즉, SSH Access 스위치를 켠다고 해서 모든 사용자에게 적용되는 기본 root 자격 증명이 자동으로 생성되는 것은 아닙니다.

일상적인 관리가 목적이라면 작업을 지원하는 최소 권한 계정을 사용하고, 필요한 경우에만 권한을 상승시키세요. 단순한 편의를 위해 root 원격 로그인을 활성화하지 마세요.

현재 자격 증명 동작과 터미널 옵션은 ZimaOS SSH 설정 문서를 참조하세요.

이전 모니터, Alt+F2 및 passwd-root 방식은 더 이상 사용되지 않습니다

커뮤니티 게시물에는 이전 절차가 남아 있지만, 명확한 “다음 내용은 더 이상 사용되지 않습니다”라는 안내 아래에 배치되어 있습니다. 이 과거 작업 흐름에는 다음이 필요했습니다.

  1. 디스플레이와 키보드를 연결하고;
  2. 다음 방법으로 콘솔로 전환한 뒤 Alt + F2;
  3. 다음 계정으로 로그인하고 root;
  4. 기존 방식을 실행하여 passwd-root helper;
  5. 그런 다음 SSH를 활성화합니다.

이 순서를 현재 ZimaOS 설치의 첫 번째 절차로 제시하지 마세요. ZimaOS 1.2.5에 추가된 UI 토글은 대부분의 사용자에게 이러한 불편을 없애기 위해 특별히 만들어졌습니다.

ZimaOS가 SSH를 Web UI로 옮긴 이유

답변에는 제품 결정이 명확히 기록되어 있습니다. 사용자들은 특히 헤드리스 NAS 하드웨어에서 로컬 모니터를 통해 root 액세스를 설정하는 것이 불편하다고 불만을 제기했습니다. IceWhale은 처음에는 이러한 추가 절차가 SSH 보안을 보호하기 위한 것이라고 설명했지만, 이후 팀에서 더 편리한 방법을 개발 중이라고 밝혔습니다.

다른 사용자가 Web UI에 SSH 활성화/비활성화 컨트롤을 직접 추가하자고 제안했을 때, IceWhale 작성자는 다음 버전에 이 기능이 추가될 것이라고 답변했습니다. 원래 게시물은 이후 ZimaOS 1.2.5 Developer Mode 작업 흐름에 맞게 업데이트되었습니다.

모니터가 없다면 어떻게 하나요?

기본 제공 Developer Mode 터미널이 없던 시절에는 Web UI에 이미 접근할 수 있는 경우 커뮤니티에서 ZimaOS App Store에서 ttydBridge를 설치할 것을 권장했습니다. 현재 ZimaOS 문서에도 ttydBridge가 또 다른 터미널 접근 옵션으로 소개되어 있지만, 이제는 많은 사용자에게 기본 제공 Web Terminal이 더 간편합니다.

현재 ZimaOS 빌드에서 기본 터미널 토글을 사용할 수 있다면, 셸에 접근하기 위해 다른 애플리케이션을 추가하기 전에 이를 사용하세요.

기본 ZimaOS Root 비밀번호가 있나요?

커뮤니티에는 나중에 Web 기반 터미널에서 인증할 수 없어 기본 root 비밀번호를 문의한 사용자의 질문이 올라왔습니다. 해당 스레드에는 모든 사용자에게 적용되는 기본 root 자격 증명이 제공되지 않습니다. 현재 ZimaOS 문서에서는 명시적인 계정 및 비밀번호 설정 방법을 안내합니다.

기존 CasaOS 또는 어플라이언스 자격 증명을 ZimaOS에 그대로 복사해 작동할 것이라고 가정하지 마세요. SSH 로그인 실패는 잘못된 사용자 이름, 아직 생성되지 않은 root 비밀번호, 비활성화된 SSH 액세스 또는 원격 인증이 허용되지 않는 계정 때문에 발생할 수 있습니다.

SSH가 모든 공장 복구 절차를 대체하지는 않습니다

2025년 답변에서는 SSH 인증을 사용할 수 없는 상황에서 디스플레이 없이 기존 ZimaBoard를 공장 초기화하는 방법을 물었습니다. IceWhale 팀원은 복구 문서를 안내하며 해당 복구 절차에는 여전히 디스플레이가 필요하다고 말했습니다.

현재 Shop 콘텐츠에 기존 ZimaBoard가 등장하는 경우, 제품 교체 경로는 현재 ZimaBoard 2 싱글 보드 서버입니다. 제품 링크가 구형 하드웨어와 현재 제품의 복구 지침이 동일하다는 의미는 아닙니다.

ZimaOS SSH 보안 체크리스트

  • 원격 셸 액세스가 필요할 때만 SSH를 활성화하세요.
  • 해당 계정에는 강력하고 고유한 비밀번호 또는 지원되는 키 기반 인증을 사용하세요.
  • root에 기본 비밀번호가 있다고 가정하지 마세요.
  • 지원되는 경우 일반적인 작업에는 일반 ZimaOS 사용자 계정을 우선 사용하세요.
  • 신중한 보안 설계 없이 포트 22를 공용 인터넷에 직접 노출하지 마세요.
  • 서비스가 더 이상 필요하지 않다면 SSH를 다시 비활성화하세요.
  • Developer Mode 및 인증 동작이 최신 문서와 일치하도록 ZimaOS를 최신 상태로 유지하세요.

ZimaOS SSH FAQ

ZimaOS에서 SSH는 어디에서 활성화하나요?

현재 ZimaOS 빌드에서는 Settings > Developer Mode를 열고 SSH Access를 켜세요. 이는 ZimaOS 1.2.5에서 도입된 현재 절차입니다.

SSH를 활성화하려면 아직도 모니터가 필요한가요?

현재 ZimaOS Web UI를 사용할 수 있는 경우 일반적인 현재 SSH Access 토글에는 필요하지 않습니다. 원래 커뮤니티 게시물의 이전 모니터 및 키보드 활성화 절차는 명시적으로 더 이상 사용되지 않는 것으로 표시되어 있습니다. 일부 root 비밀번호 설정 또는 복구 시나리오에는 여전히 별도의 로컬 콘솔이 필요할 수 있습니다.

Web Terminal과 SSH의 차이점은 무엇인가요?

Web Terminal은 ZimaOS 브라우저 인터페이스 안에서 셸에 액세스할 수 있게 합니다. SSH를 사용하면 다른 SSH 클라이언트가 네트워크를 통해 연결할 수 있습니다. 둘 다 명령줄 액세스를 제공하지만, 액세스 경로가 다르고 인증 컨텍스트도 다를 수 있습니다.

기본 root 비밀번호는 무엇인가요?

소스에는 보편적인 기본 root 비밀번호가 제공되지 않으며, 현재 ZimaOS 문서에서는 명시적인 계정 설정을 안내합니다. 추측한 기본 자격 증명에 의존하지 마세요.

ttydBridge가 아직도 필요한가요?

현재 ZimaOS 빌드에 내장 Web Terminal이 제공되고 필요에 부합한다면 일반적으로 필요하지 않습니다. ttydBridge는 ZimaSpace에서 문서화한 또 다른 터미널 액세스 옵션으로 남아 있습니다.