rahmanef63/os-vps

헤드리스 Linux VPS를 브라우저에서 제어하는 모바일 친화적 웹 대시보드

완성 앱맘대로 써도 됨 · MIT웹·Next.js·풀스택TypeScript난이도
34+1이번 주0 찜
5포크0이슈

중간맛 분석

Stack: Next.js 16 + React 19 + Tailwind 4 + shadcn/ui + TypeScript + node-pty (실제 PTY 셸) + Playwright (선택적 원격 브라우저)

난이도: 3~4 (보안 설정 필수, 자체 호스팅 필요)

바로 쓸 수 있는가: 예, 단 HTTPS 리버스 프록시와 VPN/Tailscale 뒤에 배포해야 함. systemd 유닛 제공.

데모: hero.png 및 demo.gif 있음; NEXT_PUBLIC_OS_DEMO=1로 모의 모드 강제 가능.

이런 레포예요

이럴 때 쓰면 좋아요

  • 휴대폰에서 VPS 서버를 빠르게 관리할 때
  • SSH 접속 없이 파일 업로드·다운로드와 커맨드 실행이 필요할 때
  • 서버 시스템 모니터링과 원격 브라우징을 한 앱에서 하고 싶을 때

핵심 기능

실제 대화형 PTY 터미널 (vim, top, ssh 작동)파일 관리자 및 미디어 미리보기시스템 모니터 및 원격 브라우저 (선택사항)

대안 대비 차별점

Cockpit, ttyd, FileBrowser를 하나의 모바일 우선 웹 UI로 통합하되, 단일 소유자용 보안 모델(디바이스 승인 2FA, 감사 로그, 파일시스템 jail)을 기본으로 제공.

준비물

  • Node.js 22+
  • pnpm 10+
  • HTTPS 리버스 프록시 (프로덕션)
  • VPN/Tailscale (권장)

바로 시작하기

  1. 저장소 클론 및 의존성 설치
pnpm install
  1. 환경변수 파일 생성
cp .env.example .env.local
  1. .env.local에서 OS_LOGIN_PASSWORD와 OS_SESSION_SECRET 설정 (SECRET은 최소 32바이트)
OS_SESSION_SECRET=$(openssl rand -hex 32)
  1. 빌드
pnpm build
  1. 앱 실행
pnpm start
  1. 로그인 화면에 표시된 기기 ID를 승인 (scripts/approve-device.js 사용)
node scripts/approve-device.js <deviceId> "my phone"

프로덕션 환경에서는 TLS 리버스 프록시 (Caddy/nginx/Traefik) 뒤에 배포하세요. 자세한 설정은 docs/INSTALL.md 참고.

별 추이 · 7일

34+1 / 7일

활용성 · 따라 만들기 좋은가

샘플 점수 34/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2026년 생성

이 레포에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/rahmanef63/os-vps.svg)](https://www.gitbap.com/r/rahmanef63/os-vps)

🔌 클로드에서 바로 써보기

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기