서버에는 아무것도 설치하지 않고, SSH 하나로 원격 서버를 로컬 네이티브 GUI에서 다룹니다.
한국어 · English
다운로드 · 기능 · 보안 · MCP 연동 · 지원 범위 · 기여하기
접속 한 번으로 파일 · 편집기 · 서비스 · 프로세스 · 컨테이너 · 네트워크 · 세션 · 터미널까지.
서버에는 아무것도 설치하지 않았습니다.
Note
macOS · Windows · Ubuntu에서 실행을 확인했습니다. 어느 환경에서 무엇까지 확인했는지는 지원 범위에 적어두었습니다. 삭제·프로세스 종료처럼 되돌릴 수 없는 작업은 시험용 서버에서 먼저 확인해보세요.
RDP·VNC·TeamViewer는 서버의 화면 픽셀을 영상으로 스트리밍합니다. LiteDeck은 그러지 않습니다.
[GUI 조작] [LiteDeck] [서버 · 설치물 없음]
폴더 더블클릭 ───→ SFTP ReadDir ───→ sftp-server 서브시스템
서비스 재시작 ───→ systemctl restart ───→ systemd가 실행
컨테이너 삭제 ───→ docker rm -f <id> ───→ dockerd가 실행
←─── 구조화된 텍스트/JSON ←───
화면 그리기: 100% 로컬 PC
서버가 하는 일은 원래 갖고 있던 명령을 실행하고 텍스트를 돌려주는 것뿐입니다. 그래서:
- 서버 부하는 명령이 실행되는 순간 외에는 없습니다
- 설치물도, 추가 포트도, 중계 서버도 없습니다. 이미 열려 있는 SSH 포트 하나면 됩니다
- 서버 무설치. 에이전트·데몬·패키지를 설치하지 않습니다. 서버에 남는 것은 사용자가 시킨 일의 결과뿐입니다
- SSH만 사용. 이미 열려 있는 SSH 포트 하나만 씁니다. 웹서버도, 중계 서버도 없습니다
- 숨기지 않습니다. GUI가 실행한 명령이 전부 Command Log에 그대로 뜹니다. sudo도 몰래 붙이지 않고 물어봅니다
- 로그인 없음, 수집 없음, 오픈소스. 계정을 요구하지 않고, 아무것도 수집하지 않으며, 전체 소스가 공개됩니다
- 가볍게. Electron을 쓰지 않습니다. 받는 파일 5
10MB, 설치 후 1316MB, 실행까지 1초 이내
1번의 예외 하나: 편집기로 파일을 저장할 때 같은 디렉터리에 임시 파일을 만들고
rename으로 갈아끼웁니다. 저장이 중간에 끊겨도 원본이 반토막 나지 않게 하려는 것이고, 성공하면 임시 파일은 남지 않습니다.rename이 실패하면 임시 파일 경로를 화면에 알려주고 지우지 않습니다. 잃어버리는 것보다 낫기 때문입니다.
| 파일 | 트리 탐색·이름으로 거르기·업로드·다운로드(진행률·취소·끊기면 이어받기)·폴더째 전송·이름 변경·삭제·권한(체크박스 + chmod 755 직접 입력) |
| 코드 편집 | 트리 옆 분할 뷰 · 파일 탭 · 문법 강조 24종 · 찾기/바꾸기 · 저장 전 diff · 원자적 저장(임시 파일 + rename). 서버에도 클라이언트에도 편집기를 깔지 않습니다 |
| 서비스 | systemd 유닛 / Windows 서비스. 목록·필터·시작/중지/재시작·자동 시작 설정·실시간 로그 보기(Linux) |
| 프로세스 | 작업 관리자식 테이블. 정렬·검색·트리 보기·종료(TERM→KILL 2단계)·우선순위 변경 |
| 컨테이너 | Docker·Podman 카드. 시작/중지/재시작/삭제·실시간 로그 보기·이미지/볼륨 정리. Compose로 띄운 것은 프로젝트별로 묶여 전체 시작·중지·재시작 |
| 네트워크 | 인터페이스와 열린 포트. 외부에 노출된 포트를 구분해서 표시. sshd 설정 점검 |
| 세션 | 이 서버에 누가 붙어 있는지. 접속별로 끊기 |
| 스케줄 | systemd 타이머. 다음·마지막 실행 시각 |
| 터미널 | xterm.js PTY, 탭 여러 개. code . · vi foo.conf 를 앱이 가로채 파일 탭에서 엽니다. 서버로 보내지 않으므로 VS Code나 vi가 없어도 됩니다 |
| 모니터링 | CPU·메모리·디스크 요약 바 + 그래프 |
| Command Log | GUI가 실행한 모든 명령을 실시간으로 표시. 클릭하면 복사됩니다 |
| MCP | Claude Code·Claude Desktop이 이 앱을 통해 서버를 조회하고 바꿉니다. 서버별 opt-in, 변경은 승인, 되돌리기 가능 |
| 접속 | 비밀번호·키·에이전트·2FA. ~/.ssh/config 가져오기. ProxyJump 로 경유 서버 한 단계 |
| 언어 | 한국어·영어. 처음 열 때 OS 언어를 따르고, 사이드바 아래 KO/EN 로 바꿉니다 |
재시작이 권한 부족으로 거부되자 물어봅니다. 실행된 명령은 그대로 보이고, 비밀번호는 stdin으로 가서 보이지 않습니다.
운영 서버를 만지는 GUI는 결국 "믿어달라"고 요구하는 셈입니다. LiteDeck은 방금 무엇을 실행했는지 정확히 보여주는 것으로 그 신뢰를 얻습니다. 비밀번호는 표준 입력으로만 가므로 명령줄을 그대로 보여줘도 안전하고, 이 기록은 로컬에만 남습니다.
서버에 vscode-server(수백 MB)를 올리지도, 서버의 vi를 터미널로 쓰지도 않습니다. 파일은 SSH가
이미 주는 SFTP로 읽고 쓰고, 편집기는 앱 안에 들어 있습니다. 터미널에 code . 이나 vi foo.conf
를 치면 앱이 그 줄을 서버로 보내기 전에 가로채 파일 탭으로 옵니다. 저장하면 서버의 현재
내용과의 diff가 먼저 뜹니다.
→ 기능 자세히
Claude Code·Claude Desktop 같은 MCP 클라이언트가 GUI가 앉던 자리에 앉습니다. 같은 어댑터, 이미 인증된 같은 SSH 연결, 같은 Command Log를 씁니다. 조회 12개와 변경 5개를 주고, 변경은 기본적으로 매번 물어봅니다. 그 결재 정책은 앱이 소유하며 클라이언트 쪽에서는 끌 수 없습니다. MCP가 바꾼 파일은 되돌릴 수 있고, 서버에는 여전히 아무것도 설치하지 않습니다.
claude mcp add --transport http litedeck http://127.0.0.1:<포트>/mcp \
--header "Authorization: Bearer <토큰>"→ MCP 연동
릴리스 페이지에서 받으세요.
| 파일 | 대상 |
|---|---|
litedeck-macos.zip | macOS (Intel·Apple Silicon 공용) |
litedeck-windows-amd64.zip | Windows 10/11 (amd64). 압축을 풀면 litedeck.exe 하나, 설치 없이 바로 실행 |
litedeck-linux-amd64.tar.gz | Linux (amd64). Ubuntu 24.04 이상 — libwebkit2gtk-4.1 이 필요합니다. 22.04 라면 직접 빌드 |
Warning
현재 릴리스는 코드 서명이 되어 있지 않습니다. 서명·공증에는 비용이 들어 초기에는 미서명으로 배포하며, 함께 올리는 SHA256 체크섬은 서명을 대신하지 못합니다. 신뢰가 필요하면 직접 빌드하세요.
그래서 첫 실행에 macOS Gatekeeper와 Windows SmartScreen 경고가 뜹니다. 넘어가는 방법은 설치와 서버 준비에 적어두었습니다.
서버 쪽 준비. Linux는 이미 SSH로 접속하고 계시면 끝입니다. Windows는 OpenSSH 서버만 켜면 됩니다. 집에 있는 PC를 외부에서 다루려면 포트포워딩 대신 메시 VPN을 권합니다 — 서버 준비 · Tailscale로 외부에서 쓰기
- 서버 두세 대에서 대여섯 대를 직접 돌본다. 로그를 보고, 서비스를 재시작하고, 설정 파일을 고친다
- 그 서버에 뭔가를 더 깔고 싶지 않다. SSH는 이미 열려 있고, 그것으로 끝내고 싶다
- GUI는 원하지만 무엇이 실행됐는지는 보고 싶다
- 터미널을 버릴 생각은 없다. 자주 하는 일만 클릭으로 하고 싶을 뿐이다
서버 수십 대를 한꺼번에, 선언적으로, 또는 본격적인 원격 개발이 필요하시다면 다른 도구가 낫습니다. 어떤 경우에 그런지 안 맞는 경우에 적어두었습니다.
| 보안 | 호스트 키 검증·인증·자격증명 저장·sudo·MCP 엔드포인트. 못 하는 것을 먼저 적었습니다 |
| 지원 범위 | 무엇을 어디서 검증했고 무엇이 미검증인지. 안 맞는 경우와 하지 않는 것 |
| MCP 연동 | 도구 17개, 결재 정책, 되돌리기, 안전장치 |
| 기능 자세히 | Command Log와 편집기 |
| 설치와 서버 준비 | 첫 실행 경고 넘기기, Windows OpenSSH 켜기 |
| Tailscale로 외부에서 쓰기 | 포트포워딩 없이 집 PC에 붙기. Tailscale SSH·MCP·서브넷 라우터, 그리고 계정 없이 가는 길 |
| 소스에서 빌드 | 빌드와 테스트 |
CONTRIBUTING.md를 참고하세요. 새 서버 OS 지원 = 어댑터 하나 구현이 되도록 설계돼 있습니다. Windows 지원도 그렇게 붙었습니다. OpenRC(Alpine)·launchd(macOS)·FreeBSD가 비어 있습니다.
취약점을 발견하셨다면 공개 이슈 대신 cpprhtn@naver.com 으로 보내주세요.