HaizhuOpsPanel

독립 개발자, 기술 팀 및 기업을 위한 시각적 서버 운영 및 AI 애플리케이션 배포 플랫폼입니다. 공개 랜딩 페이지는 Next.js, React 및 Tailwind CSS로 구축되었으며, 백엔드는 SSH를 통해 다중 호스트 자산, 사이트 인증서, 데이터베이스, 컨테이너, 작업, 백업, 보안 감사 및 앱 마켓 기능을 제공합니다.

v2.1.0에 MCP 처리 기능이 추가되었고, v2.2.0에서 GitHub 배포가 확장되었습니다: 패널 운영 기능이 16개의 표준 MCP 도구(서비스 조회, 컨테이너 관리, 디스크 진단, 앱 배포, GitHub 오픈소스 프로젝트 검색 및 원클릭 배포 등)로 캡슐화되었으며, 두 가지 사용 방식을 지원합니다. — 외부 MCP 클라이언트(Claude Desktop / Cursor / VS Code 등) 직접 연결 또는 패널 내장 AI 운영 어시스턴트를 통한 자연어 대화. 앱 배포는 더 이상 내장 스토어의 80개 앱에 국한되지 않으며, GitHub 최신 프로젝트를 검색하여 직접 가져와 배포할 수 있습니다. 자세한 내용은 docs/mcp.md를 참조하세요.

빠른 시작 (운영 패널 + MCP / AI 기능)

npm install
npm run start:legacy        # 启动运维面板 http://localhost:8899（默认 admin / admin123）
npm run start:mcp           # （可选）启动 MCP 服务器（stdio，供外部 AI 客户端接入）

패널 내장 AI 어시스턴트를 활성화하려면: 프로젝트 루트에 .env 파일을 만들고 AI_API_KEY=sk-xxx를 작성합니다. (선택 사항: AI_BASE_URL, AI_MODEL). 패널을 재시작한 후 왼쪽의 「AI 운영 어시스턴트」에서 자연어로 운영 요구 사항을 설명하면 됩니다. 외부 MCP 클라이언트 연결 구성은 docs/mcp.md 및 scripts/mcp-config.json을 참조하세요.

Related MCP server: Dokploy MCP Server

기술 스택

• Next.js 15 (App Router)

• React 19

• Tailwind CSS 4

• Lucide React

• 기존 Express / SSH / WebSocket 운영 백엔드는 server/에 유지됩니다.

로컬 개발

npm install
npm run dev

http://localhost:3000에 접속하세요.

프로덕션 빌드

npm run build
npm start

품질 검사

npm run lint
npm run build

프로젝트 구조

├─ app/                     # Next.js 页面、元信息与全局设计样式
├─ components/              # 落地页组件与交互式产品演示
├─ design-system/haizhuopspanel/ # ui-ux-pro-max 生成的企业设计系统
├─ legacy-public/           # 升级前的原生面板前端，完整保留（含 AI 运维助手）
├─ server/                  # Express API、SSH 与 WebSocket 后端
│  ├─ mcp-tools.js          # MCP 工具层（16 个运维工具，共用执行入口）
│  ├─ mcp-server.js         # stdio MCP 服务器（外部 AI 客户端接入）
│  └─ ai.js                 # 面板内置 AI 助手（OpenAI 兼容 function calling）
├─ scripts/mcp-config.json  # 各 MCP 客户端接入配置示例
├─ docs/mcp.md              # MCP 与 AI 助手使用指南
├─ postcss.config.mjs       # Tailwind CSS PostCSS 配置
└─ package.json

MCP 처리 기능 (v2.1.0 / v2.2.0)

사용자가 자연어로 요구 사항을 설명하면, AI가 MCP 도구를 통해 원격 호스트에서 CLI를 실행하여 서비스 조회와 운영 배포를 수행합니다:

• 16개의 표준 MCP 도구: 호스트 목록, 시스템 개요, systemd 서비스 조회/시작·중지, Docker 컨테이너 목록/작업/로그, 디스크 진단, 프로세스 순위, 앱 스토어 검색, 앱 배포/제거, GitHub 프로젝트 검색/배포, 감사 조회

• GitHub 임의 리포지토리 배포 (v2.2.0): 내장 스토어에 없는 앱은 자동으로 GitHub 검색(Star 정렬)으로 전환되며, 확인 후 원클릭 배포합니다. — Git/Docker 자동 설치, docker-compose / Dockerfile 지능적 인식, monorepo 하위 디렉터리 지원, 반복 실행 시 최신 버전으로 업데이트

• 두 가지 진입 방식:

  • 외부 MCP 클라이언트(Claude Desktop, Cursor, Cline, VS Code, WorkBuddy 등)는 npm run start:mcp로 연결

  • 패널 내장 「AI 운영 어시스턴트」 대화 인터페이스(OpenAI / DeepSeek / 智谱 등 모든 호환 API)

• 보안 설계: 호스트 자격 증명은 AES-256-GCM으로 암호화되어 외부로 유출되지 않으며, 모든 도구 호출은 감사 로그에 기록되고, run_command는 기본적으로 비활성화되며, AI는 변경 작업을 실행하기 전에 먼저 확인합니다.

구성 방법과 예시는 docs/mcp.md를 참조하세요.

디자인 및 사용성

• 전문적이고 간결한 딥 그린 운영 비주얼, 순수 장식 색상이 아닌 의미론적 상태 색상 사용

• 375px, 768px, 1024px 및 대형 데스크톱 화면에 반응형 대응

• 모바일 내비게이션 및 전환 가능한 제품 워크플로 데모

• 44px 이상의 터치 대상, 명확한 키보드 포커스, 합리적인 제목 계층

• prefers-reduced-motion 지원, 불필요한 동적 효과 방지

• 홈페이지 정적 사전 렌더링, 작은 클라이언트 부하 유지

엔터프라이즈 운영 기능

• 다중 호스트 자산 핑거프린트 및 비정상 서비스 점검

• Nginx, Apache, Caddy 사이트 및 SSL 인증서 만료 점검

• MySQL, PostgreSQL, Redis, MongoDB 인스턴스 탐지

• Docker 컨테이너, 이미지, 네트워크 및 Compose 앱 관리

• Cron, 시스템 Cron 및 systemd Timers 통합 작업 개요

• 백업 최신성 점검 및 변경 전 구성 스냅샷

• SSH, 계정, sudo, 방화벽, 포트 및 실패한 로그인 보안 기준

• SSH 공개 키 핑거프린트 및 파일 권한 감사

• 로그인, 호스트 변경, 앱 배포 및 운영 작업 JSONL 감사 기록

새로운 AI 앱 템플릿

앱 마켓에 DeerFlow 2.0, Wegent, InsForge, OpenAgent, RuFlo 및 CLASP가 새로 추가되었으며, 기존 Open WebUI, Ollama, RAGFlow, LobeChat, New API 템플릿도 유지됩니다. 신규 프로젝트는 모두 프로젝트 공식 공개 Docker, Compose 또는 설치 스크립트 경로를 사용합니다.

조사 근거는 제품 및 기능 조사를 참조하세요.

기존 운영 패널

업그레이드 이전의 프론트엔드는 legacy-public/로 이동되었으며, 백엔드 구현은 server/에 유지됩니다. 기존 패널을 계속 실행하려면 다음을 실행하세요:

npm run start:legacy

기존 서비스는 legacy-public/에서 정적 리소스를 로드하도록 변경되었으므로, 새로운 Next.js 랜딩 페이지와 병행하여 유지 관리할 수 있습니다.

License

MIT