StarHub

All-in-One DevOps Desktop Command Center

数据库客户端 · SSH/SFTP · Docker 面板 · AI 助手 · 原生桌面应用

[]() []() []()

项目介绍

StarHub 是一款跨平台桌面应用 (Tauri 2 + Rust 主进程 + Vue 3 前端 + Go Sidecar),把开发运维日常高频工具整合到同一个窗口。目标是减少在 Navicat、Xshell、Portainer、文件管理器和 AI 对话窗口之间来回切换的成本。

当前版本聚焦:本地优先、单人高效、跨平台一致体验。

下载安装

前往 GitHub Releases 下载最新版本:

Linux 同时发布 x86_64 (amd64) 与 ARM64 (arm64 / aarch64)。产物固定在 Ubuntu 22.04 原生 runner 构建,兼容 Ubuntu 22.04+ / Debian 12+ / Fedora 38+ 等主流 glibc 桌面发行版。AppImage 已携带 WebKitGTK、GTK 和静态 Go sidecar;无 FUSE 环境可使用 ./StarHub_0.46.6_amd64.AppImage --appimage-extract-and-run。Alpine(musl)与无 FHS 兼容层的 NixOS 不属于直接兼容范围。

功能矩阵

数据库客户端 (Go Sidecar 承载)

• ✅ MySQL:表结构、数据浏览、查询执行、DDL/索引/列管理、表数据 Excel 全量导出(分批拉取 + 进度条 + 通知中心)
• ✅ PostgreSQL / SQLite:表浏览、查询执行、数据导出
• ✅ Redis:键浏览、模糊检索、自动扫描当前 DB、String/List/Hash/Set/ZSet 类型适配
• ✅ Elasticsearch:索引浏览、文档查询、聚合、导出 JSON
• ✅ ClickHouse / SQL Server:表浏览、查询执行、导出
• ✅ 备份恢复、SQL 审计与告警
• 🚧 Oracle / MongoDB / 国产库 ODBC 桥 (规划中)

数据库结果网格 (DbSimpleGrid) 使用原生 HTML 表格和虚拟滚动渲染,已支持:

• 表头字段名、类型/可空/键/默认值/备注 hover 提示
• 数字右对齐 / NULL 显式显示 / 数据行列网格线
• 列排序、拖拽调宽、表内搜索与服务端列筛选
• 复制 INSERT 语句、删除行、批量编辑保存 (Ctrl/Cmd+S)

SSH 终端

• xterm.js 5 渲染,FitAddon / WebLinksAddon / SearchAddon
• ZMODEM 协议支持:通过 zmodem.js 在 Webview 侧实现 rz / sz,支持远端触发本地文件选择发送 / 远端发送本地接收并保存
• 跳板机 / 端口转发、分屏、命令广播、危险命令拦截
• 快捷命令(支持导入 Xshell .qbl / .qblx)、shell prompt 捕获与 cwd 跟踪
• 服务器网页访问:经 SSH direct-tcpip 的 Web 网关,从服务器侧出口浏览公网/内网站点
• 多标签独立会话、状态恢复、断线自动重连(应用层 keepalive)

SFTP 文件传输

• 三栏浏览、路径面包屑、隐藏文件、新建文件夹、重命名、删除
• SFTP 启动策略:自动诊断标准 subsystem,异常时探测 sftp-server 路径并受控降级;支持「仅标准 subsystem」和「指定远端程序」模式
• 拖拽上传 / 下载、断点续传、暂停 / 继续,全局传输任务条 (TransferDock)
• 跟随终端当前目录、路径输入直达、连接后落到会话起始目录

Docker 面板

• 容器 / 镜像列表,资产树 DB 化(容器/镜像对象树联动工作区)
• 本地 Docker 主机 + SSH 通道连远程 Docker
• Docker Exec 交互式 TTY:可持续读写的终端会话,支持窗口尺寸同步、命令历史、Tab 补全、Ctrl 组合键
• Docker Compose、镜像加速

本地工作区

• 导入文件夹 / 文件为工作区,目录树懒加载 + 缩进参考线、明细列表(大小/修改时间)
• VSCode 式编辑体验:可点击面包屑、编辑器 tab(dirty 点/关闭钮同槽位)、底部状态栏
• 文件 CRUD、右键菜单、文本编辑 Ctrl/Cmd+S 保存,.xlsx/.csv 自动用 Excel 工具打开
• AI 全局可读本机文件(#LOCAL 绑定)

AI 助手

• OpenAI 兼容协议 (GPT / Claude / DeepSeek / 通义千问 / Ollama 等),流式输出
• 多模型配置与会话级模型选择:每个窗口/标签页独立切换模型,互不影响
• Function Calling 可驱动 SSH / SFTP / DB / Docker / 本地文件工具;Planner → Executor 编排
• @ 调用 Agent、# 绑定目标(AI 工作区与各标签页内嵌助手同源支持)
• AI 记忆:user / global / asset 三级记忆卡 + SQLite FTS5 会话存档检索 + 压缩前 flush / 回合后 review 自动沉淀;侧边栏内置记忆管理
• MCP Server 支持 stdio、Streamable HTTP 与兼容 SSE,动态挂载外部 tools
• 最近对话恢复与单条删除、历史会话全文搜索 (session_search)
• 危险命令强制确认,白名单 / 只读命令可自动放行
• 每个标签页独立聊天历史;主侧边栏内嵌 AI 聊天,快速提问 Ctrl+J

工作台体验

• 多标签工作区,同一资产支持多实例;标签页可拖出为独立窗口
• 单击资产优先激活已有标签,避免误开重复会话
• 全局搜索 Ctrl/Command + K、命令面板 Ctrl/Command + P
• 折叠侧边栏 Ctrl/Command + B、折叠右面板 Ctrl/Command + Shift + B
• 深浅双主题、自动更新 (Tauri Updater)
• 通知中心:操作历史 + 条数 / SQL / 耗时等详情
• Cyber Command Center 设计系统:深色为主、低饱和青色高亮、栅格背景、玻璃面板、等宽数据字体

当前版本

v0.84.1 (2026-08-18)

• 🔧 修复 dsh web 启动失败(「dsh web 未运行(重试中…)」):新安装后 dsh web 就绪探测超时,stderr 报 ERR_MODULE_NOT_FOUND: Cannot find package '@deepseek-ai/dsh-sdk-jsonrpc-server'。根因:web.rs 只给 packages/starhub/ 下 8 个本地包补 junction,而 sdk-jsonrpc-server 不属于 dsh 安装闭包(INSTALL_ANCHOR=apps/cli),dsh 的 healProfilesModuleFallback 永不链接它,web profile 的 cordis.patch.yml 裸 entry 解析在 $DSH_HOME/profiles/node_modules 停步即 fail-loud。修复:新增 RUNTIME_HOSTED_PATCH_DEPS 机制,把闭包外、patch 直接引用的 sdk-jsonrpc-server 从 runtime_dir/node_modules/@deepseek-ai 补 junction 到 profiles/node_modules(与 LOCAL_PACKAGES 同机制),prod 与全新 DSH_HOME 均稳定启动;cargo check 通过

v0.84.0 (2026-08-18)

• 🔧 Redis 专用工作台 React 化(批次 2):Redis 资产从 Vue embed 回落升级为壳内 React 原生工作台(替换 RedisView.vue)

v0.83.4 (2026-08-18)

• 🔧 修复新建/编辑连接对话框的 Elasticsearch 地址回显(壳内 React NewConnectionDialog):

技术栈

快捷键

开发运行

# 安装依赖
npm install

# 启动 Tauri 开发模式(自动构建 Sidecar)
npm run tauri:dev

# 仅构建前端
npm run build

# TypeScript 类型检查
npx vue-tsc --noEmit

# 单独构建 Go Sidecar
npm run sidecar:build         # dev 模式
npm run sidecar:build:release # release 模式

打包

# Windows / macOS / Linux 当前平台打包
npm run tauri:build

Windows 产物

Linux 产物 (Ubuntu 22.04 / glibc 2.35 基线)

Linux 包必须在 Ubuntu 22.04 对应架构的原生环境构建,确保 glibc 2.35 兼容下限;AppImage 不允许交叉编译。CI 使用 ubuntu-22.04 与 ubuntu-22.04-arm runner,完成后执行 bash scripts/verify-linux-bundles.sh。WSL 中可用 Docker 验证 x86_64 构建:

docker run --rm --network host \
  -v ~/.cargo:/root/.cargo -v ~/.rustup:/root/.rustup \
  -v <go-path>:/usr/local/go \
  -v $(pwd):/workspace -w /workspace ubuntu:22.04 \
  bash -c "apt-get update && apt-get install -y libwebkit2gtk-4.1-dev ... && npx tauri build"

打包前置流程 (Tauri 自动完成):

1. npm run sidecar:build:release — Go Sidecar release 编译
2. vite build — 前端 production build
3. cargo build --release — Rust 主进程编译
4. NSIS / MSI 打包

Linux 打包把第 4 步替换为 AppImage / DEB / RPM,随后校验包架构、静态 sidecar 的执行权限、DEB/RPM 依赖元数据以及主程序 ldd 无缺失库。

注:Go sidecar 编译时必须指定正确的 GOOS 和 GOARCH (例如 GOOS=windows GOARCH=amd64),否则二进制无法在目标平台运行。

设计系统

StarHub UI 基于自研 Cyber Command Center 设计语言,集中定义在 src/styles/cyber.css:

• 基调:深色优先 + 低饱和青色高亮 + 等宽数字
• 核心 token:--bg、--panel、--line、--cyan、--text、--grad-primary、--glow-cyan 等
• 字体:Outfit(主体)、JetBrains Mono(终端/数据/序号)、Orbitron(节编号)
• 组件类:.cyber-panel、.cyber-card、.cyber-btn、.connection-card、.tree-item、.status-dot、.terminal-container、.empty-state 等
• 状态色语义:online / connecting / offline / error / warning / active / favorite
• 必备动画:pulse / shimmer / glow / float / 路由切换 / 弹窗弹性入场 / 列表交错

UI 改动必须先读 AGENTS.md 第 4.4 节,token 优先 + 组件类集中,禁止在组件内写死颜色或 20+ 行自定义视觉。

文档

路线图

安全提示

• DB / SSH 密码、私钥和 AI API Key 应存入系统 Keyring (macOS Keychain / Windows Credential Manager / Linux Secret Service;无桌面密钥环时回退到会话级 Keyutils)
• AI 执行命令前会经过安全规则和确认机制,白名单命令可自动放行
• 危险命令、删除类操作和破坏性操作需要显式确认
• 生产环境连接请优先使用最小权限账号,定期轮换凭据

贡献

仓库遵循 Conventional Commits 风格,AI Agent / 人类贡献者请先阅读 AGENTS.md:

• 跨域改动需要协调(SSH / DB / AI 互相依赖)
• 安全 / 性能 / 架构决策先开 Issue 讨论
• 一次 commit 一个主题,工作区不允许长期挂着未提交改动

License

本项目基于 MIT License 开源。

Copyright © 2026 StarHub Authors