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

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 等用到的系统开发包：

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 应用程序包：

# 解压(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）
  • 连接后的 Tunnel 面板可新建、停止、重新启动和删除转发；可保存到当前 SSH 会话，并选择下次连接时是否自动启用。
• 系统托盘：关闭主窗口后会话继续运行；从托盘恢复或新建窗口，选择“退出”才结束程序。
• 快捷命令 + 命令输入框（可群发到所有会话）+ 命令历史
• 串口 / Telnet 会话
• RDP 远程桌面：只保存主机 / 端口 / 用户名 / 密码 / 域，分辨率可选全屏 / 常见分辨率 / 自定义，连接时交给远程桌面客户端（Windows 用系统自带 mstsc；Linux / macOS 用 FreeRDP 的 xfreerdp3 / xfreerdp，需自行安装，Flatpak 版已内置）
• 出站代理（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 钥匙串存储

技术栈

运行

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

查看所有可用命令：

meatshell cli help

常用示例：

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

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

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

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

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

无 GUI 导入会话

云端/服务器可使用 cargo build --locked --features headless，跳过桌面 UI 编译。 产物仍使用同一份 CLI/MCP 和 SSH/SFTP 实现；不带子命令启动会提示用法。 默认构建仍包含完整桌面 UI。当前 Cargo 依赖图仍包含 Slint，平台编译依赖可能仍需安装。

直接使用 MeatShell 导出 功能生成的 JSON 文件：

meatshell --data-dir /absolute/path/to/profile cli import ./meatshell-connections.json --dry-run --json
meatshell --data-dir /absolute/path/to/profile cli import ./meatshell-connections.json --json

导入只追加会话，仅跳过配置内容等价的会话（忽略本地 ID 和最近使用时间），不替换已有会话和应用设置。 同一服务器的不同名称、分组、凭据、代理和跳板配置会分别保留。 跳板引用会映射到新的会话 ID，支持前向引用和指向已存在重复会话的引用。 --dry-run 只校验并返回计数，不改变已保存会话；常规初始化可能创建配置目录和加密密钥。

文件上限为 16 MiB。兼容 MeatShell 便携导出（meatshell_export: 1，包括 enc:exp:v1: 凭据）、FinalShell 导出和原生 JSON 配置。原生配置只导入会话， 其中机器本地 enc:v1: 凭据需要匹配的配置密钥；无法解密的凭据或无效跳板链路会中止整个导入。 私钥文件路径原样保留，不复制私钥文件，需要另外在目标机器准备对应文件。 便携导出的加密使用内置密钥可还原，因此应按含有凭据的敏感文件保管。

MCP 新增 import_sessions，参数为 local_path 和可选的 dry_run（默认 true）， 只返回 added、skipped、dry_run。沿用 MCP 启用和文件传输权限；实际写入还需 显式以 meatshell --data-dir /absolute/path/to/profile mcp serve --allow-config-import 启动，并传入 dry_run: false。不要为不信任的 MCP 客户端启用此参数。 导入不会信任 SSH 主机密钥，连接时仍需完成验证。

MCP

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

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

如需让某台服务器仅供手动使用，在该会话的编辑窗口中取消勾选 允许 MCP 访问此会话： MCP 将无法列出、连接该会话，也无法经由它跳转；CLI 不受影响。

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

{
  "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 通知：

{"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":{}}

查询已保存会话并获取 <session-id>：

{"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":"<session-id>"}}}

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

{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"run_command","arguments":{"session_id":"<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":"<session-id>","path":"/home/jeff/test/heapdumps"}}}

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

{"jsonrpc":"2.0","id":7,"method":"tools/call","params":{"name":"read_remote_text_file","arguments":{"session_id":"<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":"<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 中的会话名称。建议诊断提示词 明确写出目标主机、日志或堆文件路径，以及是否允许重启、修改配置、下载文件等操作边界。

项目布局

meatshell/
├── Cargo.toml
├── build.rs                 # Slint 编译器入口
├── ui/
│   ├── app.slint            # 顶层窗口
│   ├── theme.slint          # 设计 tokens
│   ├── widgets.slint        # 可复用按钮 / 输入框 / sparkline
│   ├── sidebar.slint        # 左侧系统监控面板
│   ├── tabs.slint           # 顶部标签栏
│   ├── welcome.slint        # 欢迎页 / 快速连接
│   ├── session_dialog.slint # 新建 / 编辑会话弹框
│   └── terminal_view.slint  # 终端视图（v0.1 行缓冲）
└── src/
    ├── main.rs
    ├── app.rs               # UI ↔ 后端桥接
    ├── config.rs            # 会话 JSON 持久化
    ├── system.rs            # CPU / 内存 / 网络采样
    └── ssh.rs               # SSH 会话 worker

开发提示

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

发版

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

.\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。

相关群组

扫描二维码加入 QQ 群，与其他用户交流使用经验、反馈问题或获取最新动态

友情链接

• XenTerm (新衍生分支，共同进步)

License

MIT OR Apache-2.0（双许可）。

Authenticated remote MCP / 带认证的远程 MCP

Run the new opt-in Streamable HTTP service with an external OAuth 2.1 provider, HTTPS reverse proxy and an explicitly selected private profile. Existing GUI, CLI and stdio MCP remain unchanged. See deployment, authentication and security limits.