# jumpserver_extension

**Repository Path**: alrece/jumpserver_extension

## Basic Information

- **Project Name**: jumpserver_extension
- **Description**: JumpServer Extension 是一款专为 **VSCode 用户** 设计的企业级运维终端插件，核心价值在于 **VSCode 深度集成** 与 **企业合规能力**。它允许开发者和运维人员在不离开编辑器的情况下，安全地通过 JumpServer 堡垒机连接和管理服务器资产。
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-21
- **Last Updated**: 2026-02-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JumpServer Extension for VSCode

[![License](https://img.shields.io/github/license/alrece/jumpserver_extension)](LICENSE)

[English](README.en.md) | [简体中文](README.cn.md)

JumpServer Extension 是一款专为 **VSCode 用户** 设计的企业级运维终端插件，核心价值在于 **VSCode 深度集成** 与 **企业合规能力**。它允许开发者和运维人员在不离开编辑器的情况下，安全地通过 JumpServer 堡垒机连接和管理服务器资产。

## 核心特性

### 1. 🎯 VSCode 原生体验
- **无缝集成**：在 VSCode 侧边栏直接浏览 JumpServer 资产树。
- **集成终端**：直接在 VSCode 终端面板打开 SSH 会话，无需切换到外部工具（如 Xshell/PuTTY）。
- **多会话管理**：支持同时打开多个服务器连接，标签页式管理。

### 2. 🔐 安全连接
- **SSH 直连**：通过 JumpServer 代理直连目标服务器，保证传输安全。
- **MFA 支持**：完整支持 MFA（多因素认证），包括 OTP 和短信验证码。
- **凭证安全**：使用 VSCode SecretStorage 安全存储密码和 Token，不保存明文。

### 3. ⚡ 高效运维
- **快速搜索**：支持按 IP、主机名模糊搜索资产 (`Ctrl+Shift+J`)。
- **交互式连接**：通过命令面板快速发起连接 (`Ctrl+Alt+J`)。
- **资产树导航**：清晰的组织架构视图，支持节点展开和折叠。

### 4. 🏢 企业合规 (开发中 v2.0)
- **审计日志**：记录所有连接和命令操作。
- **会话录制**：自动录制终端会话，支持回放审计。
- **命令拦截**：识别高危命令（如 `rm -rf /`），提供二次确认或拦截。

## 安装指南

1. 打开 VSCode 扩展市场。
2. 搜索 `JumpServer Extension`。
3. 点击安装。

或者通过 VSIX 安装包安装：
```bash
code --install-extension jumpserver-extension-1.0.0.vsix
```

## 快速开始

### 1. 配置连接
安装完成后，点击活动栏上的 JumpServer 图标，或者使用命令 `JumpServer: Configure JumpServer Settings`。

在设置中配置：
- **Server URL**: JumpServer 服务器地址 (例如 `https://jumpserver.example.com`)
- **Username**: 您的登录用户名
- **Password**: (可选) 您的登录密码，建议首次登录时输入

### 2. 登录
点击视图中的 "Login" 按钮，或执行命令 `JumpServer: Login`。如果开启了 MFA，会提示输入验证码。

### 3. 连接资产
- **从列表连接**：在左侧资产树中找到目标服务器，点击右侧的 "Connect" 图标。
- **搜索连接**：按下 `Ctrl+Shift+J`，输入关键词搜索，回车连接。

## 快捷键

| 快捷键 | 命令 | 描述 |
|--------|------|------|
| `Ctrl+Shift+J` | `jumpserver.searchHosts` | 搜索并聚焦主机 |
| `Ctrl+Alt+J` | `jumpserver.interactiveConnect` | 交互式连接 (SSH) |
| `Ctrl+Shift+Alt+J` | `jumpserver.interactiveSearch` | 搜索并连接 |

## 文档

- [产品需求文档 (PRD)](docs/PRD.cn.md)
- [技术设计文档 (TDD)](docs/TechnicalDesign.cn.md)

## 开发计划

- **Phase 1 (v1.0)**: 基础连接、资产导航、终端集成 ✅
- **Phase 2 (v2.0)**: 审计日志、会话录制、安全控制 (开发中) 🚧
- **Phase 3 (v3.0)**: AI 智能补全、自然语言命令、MCP 集成 📅

## 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交改动 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

## 许可证

本项目基于 MIT 许可证开源 - 详见 [LICENSE](LICENSE) 文件。