Skip to content
BranchesTags
 
 

Repository files navigation

简体中文 | English

platform-badge Python-badge License-badge release-badge download-badge download-latest

cube-shell

介绍

cube-shell是linux 服务器远程运维管理工具，可以代替Xshell、XSftp、MobaXterm 等工具对服务器进行管理，cube-shell 简洁且强大。市面上大多数ssh客户端工具都是集成了很多没有用的菜单，而且ui设计十分复杂，对于初用者不太友好。

cube-shell的设计初衷就是简洁且实用，没有任何多余的菜单干扰我们使用它。安装也很简单，解压不需要安装，就可以直接使用。

cube-shell有哪些功能？

1.设备列表

  • 新增配置
  • 编辑配置
  • 删除配置

2.快捷菜单栏

每个菜单栏都支持快捷键

  • 新增配置
  • 新增SSH隧道
  • 导出设备配置
  • 导入设备配置

3.支持sftp协议对文件的操作

下载文件（支持批量下载）

  • 上传文件（支持批量上传）
  • 编辑文件
  • 创建文件夹
  • 创建文件
  • 刷新（新增功能）
  • 删除文件和文件夹（支持批量删除）

4.支持ssh协议远程操作linux系统

  • 可以进行终端操作
  • 支持多标签（支持相同服务器）
  • 支持标签拖动顺序
  • 支持复制、粘贴、清屏
  • 代码高亮显示
  • 支持切换终端主题
  • 支持命令行补全功能
  • 支持多标签之间终端和sftp文件区域联动

5.主题切换

cube-shell 1.5.x版本优化了具有现代化IDE风格的整体主题背景切换，依然支持两种主题切换，暗主题和亮主题两种

6.状态栏

  • CPU 监控
  • 内存监控
  • 磁盘监控
  • 网络上行
  • 网络下行
  • 操作系统
  • 内核
  • 内核版本
  • 进程管理（支持快速kill进程，支持进程搜索）

7.扩展功能区

  • SSH隧道功能
  • 内网穿透功能
  • 容器管理功能
  • 常用容器功能

软件架构

cube-shell主要使用python语言开发。

主要使用技术：

名字 版本 描述
Python 3.12.3
PySide6 6.7.2 是C++ Qt 的Python语言绑定，支持跨平台
paramiko 3.4.0 是python的操作ssh协议和sftp协议的第三方库
Pygments 2.18.0 是python代码高亮的常用库
pyqtdarktheme 2.1.0 是Qt现代主题库
deepdiff 8.0.1 python深度文件比对库
openai 2.37.0 AI大模型SDK
pyte 0.8.2 Linux终端数据流框架
frp 0.61.0 内网穿透套件

图标主要来源以下两个图标库：

https://icons8.com/icons/color

https://www.iconfont.cn/

安装教程

可以直接下载 Releases 中最新发行版应用程序，也可以克隆源代码自行编译。

cube-shell 采用 Nuitka 将 Python 源码编译为原生二进制文件，性能提升约 50%，包体积减小约 40%。

前置条件
条件 说明
Python 3.12 或更高版本
Git 用于克隆仓库
C 编译工具链 Windows 需要 MinGW64 或 MSVC；macOS 需要 Xcode Command Line Tools；Linux 需要 build-essential
磁盘空间 建议至少预留 2 GB（编译过程会生成大量中间文件）
通用步骤（所有平台）
  1. 克隆仓库
git clone https://github.com/Cubeiic-HanXuan/cube-shell.git
cd cube-shell
  1. 创建并激活 Python 虚拟环境
python3 -m venv venv

# Linux / macOS
source venv/bin/activate

# Windows (PowerShell)
.\venv\Scripts\Activate.ps1
  1. 安装项目依赖
pip install -r requirements.txt
编译 Windows 程序

需要已安装 MinGW64 或 MSVC 编译器，以及 Inno Setup（用于打包安装程序）。

  1. 编译为独立可执行程序
build-exe.bat

脚本会自动安装 Nuitka 并编译，产物位于 deploy\cube-shell.dist\ 目录。

  1. 打包为 EXE 安装包（可选）
deploy-install.bat

最终生成 Windows 安装程序（.exe），可分发给用户直接安装。

编译 macOS 程序

需要已安装 Xcode Command Line Tools 以及 create-dmg（脚本会自动通过 Homebrew 安装）。

  1. 赋予脚本执行权限并运行
chmod +x app.sh
./app.sh

脚本会自动完成 Nuitka 编译、资源拷贝、DMG 打包等步骤。

  1. 产物说明
文件 说明
deploy/cube-shell.dmg macOS 磁盘映像安装包，双击挂载后拖入 Applications 即可使用
编译 Linux (Ubuntu/Debian) 程序

适用于 Ubuntu / Debian 系发行版，脚本内置 apt-get 自动安装所需系统依赖。

  1. 赋予脚本执行权限并运行
chmod +x build-linux.sh
./build-linux.sh

脚本会自动安装系统依赖（patchelf、ccache、Qt 运行库等）、编译应用、生成桌面入口文件和启动脚本。

  1. 产物说明
文件 说明
deploy/cube-shell.dist/ 完整的应用目录，可直接运行 ./cube-shell.sh 启动
deploy/cube-shell-linux-x86_64.tar.gz 压缩发布包，可分发至其他机器解压使用
deploy/cube-shell.dist/cube-shell.desktop 桌面快捷方式文件，复制到 ~/.local/share/applications/ 后可在应用菜单中找到
Web 远程桌面部署（Linux 服务器无显示器场景）

若需要在没有显示器的 Linux 服务器上运行 cube-shell 并通过浏览器远程访问，可按以下步骤部署。

  1. 安装桌面环境与远程访问组件
# 安装 XFCE 桌面环境
sudo apt-get install -y xfce4 xfce4-terminal

# 安装 VNC 服务器
sudo apt-get install -y x11vnc
mkdir -p ~/.vnc
x11vnc -storepasswd <你的密码> ~/.vnc/passwd

# 安装 noVNC（Web VNC 客户端）
sudo apt-get install -y novnc websockify

# 安装 Firefox 浏览器（可选，用于远程浏览网页）
sudo apt-get install -y firefox-esr
  1. 启动虚拟显示与桌面环境
# 启动 Xvfb 虚拟显示器
export DISPLAY=:99
Xvfb :99 -screen 0 1920x1080x24 &

# 启动 XFCE 桌面
startxfce4 &
  1. 启动 VNC 服务
x11vnc -display :99 -rfbport 5900 -rfbauth ~/.vnc/passwd -shared -forever -bg
  1. 启动 noVNC Web 代理
websockify --web /usr/share/novnc 6080 localhost:5900 &

现在可以通过浏览器访问 http://<服务器IP>:6080/vnc.html 看到桌面。

  1. 启动 cube-shell
cd cube-shell
export DISPLAY=:99
source venv/bin/activate
python cube-shell.py
  1. （可选）Nginx 反向代理配置

若需通过域名 + HTTPS 访问，配置 Nginx 反向代理：

server {
    listen 443 ssl;
    server_name <你的域名>;

    ssl_certificate /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:6080/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 86400;
    }
}
Docker 部署

通过 Docker 一键部署 cube-shell 远程桌面环境（包含 noVNC Web 界面）。

  1. 构建镜像
# 方式一：直接构建（需要先编译好 Linux 版本）
docker build -t hassis/cube-shell:latest .
  1. 运行容器
# 方式二：从 Docker Hub 拉取（推荐）
docker pull hassis/cube-shell:latest

# 运行
docker run -d \
  --name cube-shell \
  --restart=always \
  -p 6080:6080 \
  hassis/cube-shell:latest
  1. 通过浏览器访问
http://<服务器IP>:6080
  • VNC 密码：无密码（使用前需要在容器里设密码）

Docker Hub 地址： https://hub.docker.com/r/hassis/cube-shell

Dockerfile 功能：

  • 基于 Ubuntu 24.04
  • 内含 XFCE 桌面 + x11vnc + noVNC
  • 内含 Firefox ESR 浏览器
  • 使用 Supervisor 管理所有服务（自动重启）
  • VNC 密码可通过 x11vnc -storepasswd 在容器里设密码

使用自定义密码启动示例：

docker run -d \
  --name cube-shell \
  --restart=always \
  -p 6080:6080 \
  -e VNC_PASSWORD=*** \
  hassis/cube-shell:latest

IPv6 支持（如需连接 IPv6 only 的服务器）：

Docker 默认不启用 IPv6，需先在宿主机配置：

# 在宿主机上运行（只需一次）
curl -sL https://raw.githubusercontent.com/jeffreyrobeson/cube-shell/master/scripts/setup-ipv6.sh | bash

# 然后正常启动容器即可
docker run -d --name cube-shell -p 6080:6080 hassis/cube-shell:latest

如果目标服务器无法访问 IPv6（如没有公网 IPv6 路由），容器内 SSH 连接 IPv6 only 服务器会失败（Network is unreachable）。此时可使用 socat 做 IPv6→IPv4 代理：

# 在有 IPv6 的宿主机上运行
socat TCP-LISTEN:2222,fork,reuseaddr TCP6:[<IPv6地址>]:22 &

# 容器内 SSH 连接时使用 127.0.0.1:2222

参与贡献

欢迎各位朋友积极参与代码贡献。

  1. Fork 本仓库
  2. 新建 Feat_xxx 分支
  3. 提交代码
  4. 新建 Pull Request

视频教程地址

cube-shell-video

有任何不懂的可以加交流群

follow on QQ follow on Weixin 维护不易，觉得不错的可以赞助一下 维护不易，觉得不错的可以赞助一下

About

Linux 服务器远程管理工具，可以代替Xshell、XSftp 等工具对Linux服务器进行管理，cube-shell 简洁且强大。这款免费开源的国产运维神器之 rdp协议 把 Windows、MAC、Linux等远程桌面搬进终端。

Resources

Readme
License
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages