meatshell

> 编程语言

开源

一个轻量级、低内存占用的 SSH / 终端客户端（A lightweight, low-memory SSH / terminal client）

1.2K stars0 点赞0 次浏览

访问官网 GitHub

工具介绍

一个轻量级、低内存占用的 SSH / 终端客户端（A lightweight, low-memory SSH / terminal client）

meatshell

简体中文 | English

一个轻量级、低内存占用的 SSH / 终端客户端，灵感来自 FinalShell，但完全由 Rust + Slint 实现。目标是保留 FinalShell 的核心体验（资源监控侧栏、会话管理、多标签页终端）的同时，把内存占用从 400 MB+ 的 JVM 压到几十 MB 原生级别。

截图

欢迎页：会话管理 + 左侧本机资源监控

多标签页终端（htop 全屏渲染）+ 底部 SFTP 文件浏览 + 远端资源监控

下载与安装

每次打 v* 标签，GitHub Actions 会自动构建 Windows / Linux / macOS 三平台二进制，发布到 Releases 页面。

Windows

下载 meatshell-*-windows-x86_64.zip，解压后双击 meatshell.exe。

Linux

bash

tar -xzf meatshell-*-linux-x86_64.tar.gz
cd meatshell-*-linux-x86_64
./meatshell                                  # 直接运行
# 可选：系统级安装程序、图标和启动器入口（需要 sudo）
chmod +x install-linux.sh && ./install-linux.sh

一键安装会将程序安装到 /usr/local/bin/meatshell，启动器安装到 /usr/local/share/applications/meatshell.desktop，图标安装到 /usr/local/share/icons/hicolor/512x512/apps/meatshell.png，并清理旧版 tar 包留下的用户级同名启动器。

需要 glibc ≥ 2.35（Ubuntu 22.04+ / Debian 12+）。Wayland 下首次装完图标可能要注销重登一次。

从源码 cargo run（Linux Mint / Ubuntu / Debian）需要先安装 Slint/winit/rfd 等用到的系统开发包：

bash

sudo apt update
sudo apt install -y --no-install-recommends \
  build-essential pkg-config cmake \
  libfontconfig1-dev libfreetype6-dev \
  libxcb1-dev libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev \
  libxkbcommon-dev libxkbcommon-x11-dev libwayland-dev \
  libgl1-mesa-dev libegl1-mesa-dev libgtk-3-dev \
  libudev-dev

macOS

下载得到的是 .zip，里面是 meatshell.app 应用程序包：

bash

# 解压(aarch64 = Apple 芯片，x86_64 = Intel)
unzip meatshell-*-macos-*.zip
# 移到「应用程序」(可选，留在原地也行)
mv meatshell.app /Applications/
# 去掉「未签名应用」的隔离属性，否则会提示「meatshell 已损坏，无法打开」
xattr -dr com.apple.quarantine /Applications/meatshell.app
# 打开(或在「访达」里双击)
open /Applications/meatshell.app

若未移到 /Applications，把上面两条路径换成 .app 实际所在位置(如 ~/Downloads/meatshell.app)即可。

需要 macOS 11 Big Sur 或更高版本，支持 Apple Silicon 和 Intel Mac。

从源码构建见下方运行。

功能

已实现

FinalShell 风格 UI，深色 / 浅色 / 跟随系统主题
本机 + 远端资源监控（CPU / 内存 / 交换 / 网络 / 磁盘）
远端进程监控（按 CPU 排序、PID 复制与权限确认后结束进程）
完整 VT/ANSI 终端模拟（btop / htop / vim 全屏正常渲染）
彩色 emoji（支持肤色、旗帜及 ZWJ 组合序列）
多标签页（欢迎页 + 多个会话）
会话管理：新建 / 编辑 / 删除 / 分组，本地 JSON 持久化，导出 / 导入（兼容 FinalShell 连接文件）
- 配置位置：%APPDATA%/meatshell/sessions.json（Windows） / ~/.config/meatshell/sessions.json（Linux） / ~/Library/Application Support/meatshell/sessions.json（macOS）
SSH（russh，纯 Rust）：密码 / 私钥 / 加密私钥（密码短语）
SFTP 文件浏览 + 上传 / 下载（拖拽）+ 终端内 ZMODEM（sz 下载 / rz 多文件上传）
SSH 端口转发 / 隧道：本地 -L / 远程 -R / 动态 -D（SOCKS5）
快捷命令 + 命令输入框（可群发到所有会话）+ 命令历史
串口 / Telnet 会话
出站代理（SOCKS5 / HTTP）
导入 ~/.ssh/config
会话密码加密存储（ChaCha20-Poly1305）
已知主机（known_hosts）校验 + 首次连接确认
多标签页终端分屏
多窗口：Ctrl+Shift+N（macOS ⌘⇧N）或系统入口“新建窗口”（Windows 任务栏 / Linux 桌面右键），Chrome 式单进程管理

彩色 emoji 图形来自 Twemoji，按 CC BY 4.0 使用；完整署名见 THIRD_PARTY_NOTICES.md。

计划中

会话密码改用 OS 钥匙串存储

技术栈

模块	选型
UI	Slint（纯 Rust 编译，无 GC）
异步运行时	`tokio`
SSH 协议	`russh`（无 libssh 依赖）
系统指标	`sysinfo`
序列化	`serde` + `serde_json`
日志	`tracing` + `tracing-subscriber`

运行

bash

cargo run --release

首次启动会在 %APPDATA%/meatshell/sessions.json 建立空的会话库。点击右上角 “＋新建会话” 添加第一台服务器。

CLI 与 MCP 自动化

MeatShell 的 CLI 和 MCP 共用 GUI 中保存的会话及 SSH / SFTP 实现。CLI 适合脚本、 CI 和手动执行明确的命令；MCP 则让支持 MCP 的 AI 客户端通过自然语言完成服务器巡检、日志分析和文件传输。两者只是调用入口不同，不需要重新维护一份服务器配置。

使用前请先在 GUI 中创建并成功连接一次目标会话，以完成主机密钥确认。密码、私钥等凭据不会出现在 CLI/MCP 返回结果中，也不要把明文密码写进提示词或 MCP 配置。

CLI

查看所有可用命令：

bash

meatshell cli help

常用示例：

bash

# 列出已保存的会话，第一列是后续命令使用的 session-id
meatshell cli sessions
meatshell cli sessions --json

# 查看单个会话的非敏感信息
meatshell cli session 

# 执行非交互式 SSH 命令；远端命令必须放在 -- 后面
meatshell cli exec  -- free -h
meatshell cli exec  --timeout 60 --json -- journalctl -n 100 --no-pager

# 浏览、读取和传输远端文件
meatshell cli files  /var/log
meatshell cli read  /var/log/example.log
meatshell cli upload  ./local.txt /tmp
meatshell cli download  /tmp/result.txt ./downloads

CLI 的 `` 可由 meatshell cli sessions 获取。文件下载要求本地目标目录已经存在，且不会覆盖同名文件。

MCP

先打开 MeatShell 的 设置 → 界面 → MCP：

启用 MCP。
根据需要允许使用已保存的凭据。
需要远程诊断时允许执行任意 SSH 命令。
需要上传或下载文件时允许文件传输。

然后在支持 stdio MCP 的客户端中添加名为 meatshell 的服务：

json

{
  "mcpServers": {
    "meatshell": {
      "command": "/absolute/path/to/meatshell",
      //Mac OS
      //"command": "/Applications/MeatShell.app/Contents/MacOS/meatshell",
      //Linux
      //your path 
      "args": ["mcp", "serve"]
    }
  }
}

Windows 下 command 可以填写 C:\\path\\to\\meatshell.exe。重启或刷新 MCP 客户端后，应能看到 meatshell 服务以及会话查询、远程命令、目录浏览、文本读取、上传和下载等工具。不同 AI 客户端的 MCP 配置文件位置不同，请以对应客户端文档为准。

MCP JSON-RPC 示例

一般情况下由 AI 客户端自动生成这些请求，无需手工输入。调试 stdio 连接时，每个请求必须是独立的一行 JSON，依次完成初始化和 notifications/initialized 通知：

jsonl

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"example-client","version":"1.0.0"}}}
{"jsonrpc":"2.0","method":"notifications/initialized","params":{}}
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}

查询已保存会话并获取 ``：

jsonl

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_sessions","arguments":{}}}
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"get_session","arguments":{"session_id":""}}}

执行 OOM 只读诊断并浏览堆转储目录：

jsonl

{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"run_command","arguments":{"session_id":"","command":"free -h; printf '\\n=== kernel OOM ===\\n'; dmesg 2>/dev/null | grep -iE 'oom|out of memory|killed process' | tail -50 || true; printf '\\n=== Java ===\\n'; ps -ef | grep '[j]ava'","timeout_seconds":30,"max_output_bytes":1048576}}}
{"jsonrpc":"2.0","id":6,"method":"tools/call","params":{"name":"list_remote_files","arguments":{"session_id":"","path":"/home/jeff/test/heapdumps"}}}

读取日志或下载一个堆文件：

jsonl

{"jsonrpc":"2.0","id":7,"method":"tools/call","params":{"name":"read_remote_text_file","arguments":{"session_id":"","path":"/home/jeff/test/logs/meatshell-log-demo-error.log"}}}
{"jsonrpc":"2.0","id":8,"method":"tools/call","params":{"name":"download_file","arguments":{"session_id":"","remote_path":"/home/jeff/test/heapdumps/example.hprof","local_directory":"/existing/local/directory","timeout_seconds":120}}}

read_remote_text_file 只接受有大小和行数限制的 UTF-8 文本；HPROF 等二进制文件应使用 download_file。下载目标目录必须已经存在，且工具不会覆盖同名文件。

配置完成后，可以直接对 AI 客户端说：

用 meatshell MCP 排查一下：我的 192.168.100.41 服务器出现 OOM，堆转储位于 /home/jeff/test/heapdumps。请检查系统内存、内核 OOM 记录、Java 进程、应用日志和 HPROF 文件，判断根因；先只读排查，不要重启服务或删除文件。

MCP 会先通过 list_sessions 查找匹配的已保存会话，再按已授予的权限调用远程命令或 SFTP 工具。若存在多条同主机会话，可在提示词中补充 GUI 中的会话名称。建议诊断提示词明确写出目标主机、日志或堆文件路径，以及是否允许重启、修改配置、下载文件等操作边界。

项目布局

…

开发提示

Slint 控件有非常严格的布局 DSL，改 .slint 后 cargo check 是最快的反馈方式。
应用事件循环是单线程（Slint 要求），所有跨线程 UI 更新通过 slint::invoke_from_event_loop 回调。
SSH / SFTP 共享 known_hosts 校验逻辑：首次连接会确认并记住主机密钥，后续密钥变化会再次提示。

发版

不要直接手动修改 Cargo.toml 后再打标签。使用发布脚本，让 Git tag 指向的提交本身就已经包含正确版本号：

powershell

.\scripts\release.ps1 v0.6.0 -Push

脚本会更新 Cargo.toml / Cargo.lock，运行 cargo check --locked，验证 meatshell --version，提交 Release v0.6.0，创建 annotated tag，并推送当前分支和 tag。更多细节见 docs/release.md。

License

MIT OR Apache-2.0（双许可）。

Issues· 0 开放

查看全部 Issues 在 GitHub 打开

暂无开放 Issues，或尚未同步最近议题。

> 标签

Rust

暂无评论，来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日

最后更新2026年9月17日

分类编程语言

定价开源

> 相关工具

TypeScript

JavaScript 的超集，为前端与全栈提供静态类型

Python

通用编程语言，广泛用于 Web、数据与 AI

Google 推出的简洁高效系统语言

meatshell

工具介绍

meatshell

截图

下载与安装

Windows

Linux

macOS

功能

已实现

计划中

技术栈

运行

CLI 与 MCP 自动化

CLI

MCP

MCP JSON-RPC 示例

项目布局

开发提示

发版

相关群组

License

Issues· 0 开放

> 标签

> 讨论区

> 工具信息

> 相关工具