LiteDeck

SSH로 접속한 서버를 한 화면에서 관리하는 데스크톱 앱
서버에는 아무것도 설치하지 않습니다

한국어 · English

다운로드 · 기능 · 보안 · MCP 연동 · 지원 범위 · 기여하기

_{접속 한 번으로 파일 · 편집기 · 서비스 · 프로세스 · 컨테이너 · 네트워크 · 세션 · 모니터링 · 터미널까지.
서버에는 아무것도 설치하지 않았습니다.}

---

무엇을 할 수 있나

SSH로 서버에 한 번 접속하면, 아래 작업을 같은 창에서 이어서 할 수 있습니다.

전체 목록과 자세한 설명은 기능 문서에 있습니다.

왜 LiteDeck인가

1. 서버에 설치할 것이 없습니다. 에이전트·데몬·패키지가 필요 없고, 이미 열려 있는 SSH 포트 하나로 동작합니다. 서버에는 사용자가 한 작업의 결과만 남습니다
2. 실행한 명령을 그대로 보여 줍니다. 화면에서 한 작업은 전부 Command Log에 실제 명령으로 남습니다. 관리자 권한(sudo)이 필요하면 임의로 붙이지 않고 먼저 묻습니다
3. 가입할 계정이 없습니다. 사용 정보를 수집하지 않고, 전체 소스가 공개돼 있습니다
4. 가볍습니다. Electron을 쓰지 않습니다. 내려받는 파일 약 6MB, 설치 후 약 15MB이고, 1초 안에 실행됩니다 (v2.3.0 기준. macOS 판은 Intel·Apple Silicon 공용이라 12MB · 29MB)

설치와 첫 연결

릴리스 페이지에서 받으세요.

[!WARNING] 현재 릴리스는 코드 서명이 되어 있지 않습니다. 서명·공증에는 비용이 들어 초기에는 미서명으로 배포하며, 함께 올리는 SHA256 체크섬은 서명을 대신하지 못합니다. 신뢰가 필요하면 직접 빌드하세요.

그래서 첫 실행 때 macOS Gatekeeper와 Windows SmartScreen 경고가 뜹니다. 넘어가는 방법은 설치와 서버 준비에 적어 두었습니다.

첫 연결

1. 앱을 열고 왼쪽 위의 + 추가를 누릅니다. ~/.ssh/config를 쓰고 있다면 가져오기로 한 번에 불러올 수 있습니다
2. 주소·사용자·인증 방식(SSH 에이전트 · 키 파일 · 비밀번호)을 입력합니다
3. 처음 접속하는 서버는 호스트 키 지문을 확인하라고 묻습니다. 확인하면 서버의 탭들이 열립니다

서버 쪽 준비. Linux 서버라면 이미 SSH로 접속하고 계실 테니 준비할 것이 없습니다. Windows는 OpenSSH 서버만 켜면 됩니다. 집에 있는 PC를 외부에서 다루려면 포트포워딩 대신 메시 VPN을 권합니다 — 서버 준비 · Tailscale로 외부에서 쓰기

웹 브라우저로 쓰기 — 서버 모드. 데스크톱 앱 대신, 서버 한 대에 LiteDeck을 올려 두고 웹 브라우저로 접속해 쓸 수도 있습니다 — litedeck-server-linux-amd64.tar.gz · litedeck-server-linux-arm64.tar.gz. 이 경우에는 LiteDeck이 웹 서버로 동작하고 로그인 화면이 있습니다. 실행·노출·로그인 설정은 서버 모드에 적어 두었습니다.

MCP 연동 — AI 도구로 서버 다루기

Claude Code·Claude Desktop 같은 MCP 클라이언트가 LiteDeck을 통해 서버를 조회하고 작업할 수 있습니다. 화면과 같은 SSH 연결을 쓰고, AI가 실행한 명령도 같은 Command Log에 남습니다. 서버에는 여전히 아무것도 설치하지 않습니다.

• 조회 도구 12개, 변경 도구 6개
• 파일을 바꾸기 전에는 기본적으로 확인을 받습니다. 확인 창에 서버의 현재 내용과의 차이가 표시됩니다. 서버별로 「모든 변경을 확인」까지 올릴 수 있습니다
• 승인 정책은 LiteDeck에서 서버별로 정하며, AI 클라이언트 쪽에서는 바꿀 수 없습니다
• AI가 바꾼 파일은 되돌릴 수 있습니다
• 명령 실행과 파일 삭제는 서버별로 따로 켜야 하며, 기본은 꺼져 있습니다 _v1.7.0. 켜면 다른 변경 도구와 같은 승인 정책이 적용됩니다

claude mcp add --transport http litedeck http://127.0.0.1:<포트>/mcp \
  --header "Authorization: Bearer <토큰>"

→ MCP 연동

지원 환경

[!NOTE] macOS · Windows · Ubuntu에서 실행을 확인했습니다. 어느 환경에서 무엇까지 확인했는지는 지원 범위에 적어 두었습니다. 삭제·프로세스 종료처럼 되돌릴 수 없는 작업은 시험용 서버에서 먼저 해 보세요.

• 관리할 서버: systemd를 쓰는 Linux(Ubuntu·Debian·라즈베리파이 등)와 Windows(OpenSSH 서버). Windows 서버는 세션·보안 탭까지 지원하며, 이벤트 탭은 아직 없습니다
• 앱을 실행할 PC: macOS · Windows 10/11 · Linux(Ubuntu 24.04 이상)

이런 환경에 맞습니다

• 서버 두세 대에서 대여섯 대 정도를 직접 운영합니다. 로그를 보고, 서비스를 재시작하고, 설정 파일을 고칩니다
• 그 서버에 다른 프로그램을 더 설치하고 싶지 않습니다. 이미 열려 있는 SSH로 충분하길 바랍니다
• GUI를 쓰더라도, 무엇이 실행됐는지는 확인하고 싶습니다
• 터미널을 버릴 생각은 없고, 자주 하는 일만 클릭으로 하고 싶습니다

서버 수십 대를 한꺼번에 다루거나, 선언적 상태 관리나 본격적인 원격 개발 환경이 필요하다면 다른 도구가 낫습니다. 어떤 경우인지는 LiteDeck이 적합하지 않은 환경에 적어 두었습니다.

더 읽어보기

기여

CONTRIBUTING.md를 참고하세요. 새 서버 OS를 지원하는 일이 어댑터 하나 구현으로 끝나도록 설계돼 있습니다. Windows 지원도 그렇게 붙었습니다. OpenRC(Alpine)·launchd(macOS)·FreeBSD가 비어 있습니다.

취약점을 발견하셨다면 공개 이슈 대신 cpprhtn@naver.com으로 보내주세요.

라이선스

Apache-2.0