English | 简体中文
一个现代化、跨平台的终端 / SSH 客户端 —— 把本地终端、远程 SSH、SFTP、主机监控、端口转发与 AI 助手整合到一个桌面应用里。
AShell 注重性能、隐私与可定制性。所有 SSH 凭证本地加密存储，AI 助手在你自己的机器上运行，密钥不离开你的设备。
💡 同一套核心也提供 Web 服务器形态：Docker 一键部署，浏览器远程使用 SSH / SFTP / 终端与 AI 助手，详见 Web 服务器模式。
- 跨平台：macOS / Windows / Linux，覆盖 x86_64 与 ARM64。
- 多 Tab 多窗口：Tab 拖拽重排、右键菜单（重连 / 断开 / 复制连接 / 新窗口 / 复制 SSH 地址 / 重命名 / 导出会话），跨窗口无缝操作。
- 本地终端：Windows ConPTY / Unix forkpty，支持 PowerShell、cmd、Git Bash、Bash、Zsh、Fish。
- 远程 SSH：PTY + 二进制安全帧透传，颜色控制码完整保留。
- Telnet / 串口：除 SSH 外，支持 Telnet 与串口终端连接。
- 渲染加速：WebGL 渲染 + 连字（ligatures）+ 网页链接可点 + Unicode 11 + 搜索 + 序列化。
- 进度条识别：自动识别
cargo/brew/wget/curl/git/rsync/docker等命令的文本进度，同步到任务栏与终端顶部。 - 命令输入建议：Trie 前缀匹配 + 历史关键字搜索，可清空历史。
- sudo 自动填充：识别 sudo 密码提示并自动填充。
- 可配置操作：Ctrl + 滚轮调字号、鼠标右键 / 中键行为可配、Ctrl + F 搜索浮层。
- 断连重连：离线恢复显示"重新连接"浮层按钮，本地终端退出后自动关闭 Tab。
- 无限层级目录树：拖拽移动子树、级联删除、跨目录复制，按目录组织你的主机。
- 凭证加密：密码 / 私钥用 AES-256-GCM 加密落盘，永不通过接口外泄。
- 主机元信息：名称、地址、端口、用户名、图标、颜色、描述，自由归类。
- 可调宽侧面板：边缘拖拽调宽，宽度持久化记忆。
- 左右分栏表单：基本信息与连接配置分栏，编辑更清晰。
- 完整 CRUD：列出（含属主 / 权限 / 时间戳）、新建目录 / 文件、删除、重命名、属性查看。
- 流式传输：上传带进度与可取消、下载走原生"另存为"对话框、支持文件夹整传。
- 路径面包屑：可点击 + 可编辑，快速跳转。
- 连接复用：与终端共享同一 SSH 连接，无需重新认证。
- 在线编辑：内置 CodeMirror 编辑器，支持查找 / 替换、字号调节、行列状态栏。
- 列宽可调：表格列宽可拖动调整。
- 权限着色：权限列按属主 / 属组 / 其他三段独立着色。
- 实时资源：CPU / 内存 / 交换 / 磁盘 / 累计网络字节，1.5s 节流轮询。
- Top 5 进程：兼容 procps 与 BusyBox。
- 网络流量：纯 SVG 双线（rx/tx）环形缓冲图，网卡可切换。
- 磁盘折叠：根挂载主显示，其余挂载点折叠收起。
- 三种模式：本地（
-L）、远程（-R）、动态（-D）。 - 可视化规则表：规则列表 + 流量 / 状态实时刷新。
- 图形化创建：表单填空即可新增转发规则，无需手敲命令。
- 多 Tab 同步：按键级实时转发到多个终端，目标 Tab 可勾选。
- 跨窗口支持：源 Tab 可选、自动追加回车，跨窗口广播无障碍。
- 多 Agent 驱动：统一 sidecar（sidecar-ai）内嵌 Claude Agent SDK 与 Pi coding agent 双引擎（工厂模式按需选择），每个终端会话独立进程。
- 发送给 AI：终端选中文本与 SFTP 右键菜单支持发送给 AI 助手。
- 执行过程可折叠：工具调用与返回聚合成可折叠块，对话整洁可读。
- 破坏性操作确认：执行前弹 y/n 确认条，敏感信息（SSH 会话凭证）不直接透露。
- 远程命令执行：AI 自动复用当前 SSH 会话，在你授权后执行远程命令。
- 模型可配：支持自定义 API Key、Base URL、模型名，按 sidecar 类型区分显示，兼容代理与自托管端点。
- 透明度滑块：实时调整窗口不透明度。
- Acrylic 毛玻璃：macOS / Windows 11 原生模糊效果。
- 背景壁纸：独立透明度，壁纸与窗口透明分离。
- 系统字体枚举：自动列出已安装字体，去重 + 字典序。
- 主题：暗色 / 亮色，配色统一从主题变量派生。
- 双语：简体中文 / English 完整覆盖，UI 语言随选随切。
- 会话恢复：记住上次的 Tab 列表，启动时骨架恢复。
- 自动连接：启动时自动连接记住的 Tab。
- 默认 Shell：可选 Auto / PowerShell / cmd / Git Bash / Bash / Zsh / Fish，启动自动打开本地终端。
- 启动自动检查：应用启动后自动检查 GitHub Releases 是否有新版本，发现时弹出通知。
- 一键更新：通知或「设置 > 关于」中点击「下载并安装」，下载完成后自动重启。
- 更新日志：检查到新版本时展示 Release Notes（Markdown 渲染）。
前往 Releases 下载对应平台的安装包：
| 平台 | 文件 |
|---|---|
| macOS (Apple Silicon) | *.dmg |
| macOS (Intel) | *.dmg |
| Windows x64 | *.msi / *.exe |
| Windows ARM64 | *.msi / *.exe |
| Linux x64 | *.deb / *.rpm / *.AppImage |
| Linux ARM64 | *.deb / *.rpm / *.AppImage |
- Node.js 18+
- Rust（stable）
- Bun（编译 sidecar 二进制）
- 平台依赖：macOS 需 Xcode CLT；Windows 需 MSVC；Linux 需 webkit2gtk 等
# 1. 安装前端依赖
npm install
# 2. 安装 sidecar 依赖
cd sidecar-ai && npm install && cd ..
# 3. 开发模式（Vite + Rust 热重载）
npm run tauri dev
# dev 不会自动编译 sidecar，如需 AI 助手请先手动执行：
npm run sidecar:build
# 4. 生产构建（自动编译 sidecar + 前端 + 打包）
npm run tauri build
npm run tauri build会先自动执行npm run sidecar:build（编译统一 AI sidecar 二进制），再执行npm run build（前端类型检查 + Vite 构建），无需手动编译 sidecar。
除桌面应用外，AShell 可作为 Web 服务器运行，在浏览器中远程使用 SSH / SFTP / 终端与 AI 助手（同一套核心业务层，双目标构建）。
CI 在推送 v* 版本标签（或手动触发 workflow）时自动构建 linux/amd64 + linux/arm64 双架构镜像发布到 GHCR（标签：{版本}、{主}.{次}、latest）：
# 拉取并运行（数据目录 ~/.ashell 挂载进容器，首次启动自动生成登录令牌）
docker run -d --name ashell-server \
-p 8090:8090 \
-v ~/.ashell:/data/.ashell \
ghcr.io/vcqr/ashell-server:latest
# 或用 compose（仓库内 docker-compose.yml，注释含各项可配项）
docker compose up -dGHCR 包首次发布默认为私有：拉取需
docker login ghcr.io，或到仓库 Packages 页把包可见性改为 Public。
浏览器打开 http://<主机IP>:8090，输入访问令牌登录。令牌获取（优先级从高到低）：
ASHELL_WEB_TOKEN环境变量 /--token参数- 数据目录下的
web-token文件（无前两者时自动生成，启动日志会打印；重启不变）
docker exec ashell-server cat /data/.ashell/web-token# 交叉编译 musl 静态二进制（ashell-server + AI sidecar）+ 组装极简镜像
# 首次依赖 cross 工具：cargo install --git https://github.com/cross-rs/cross --locked cross
# x86_64 服务器：TARGET=x86_64-unknown-linux-musl ./scripts/build-server-image.sh
./scripts/build-server-image.sh
docker compose up -d镜像为极简 COPY 式（alpine + 静态二进制 + 前端产物，容器内零编译），内置 bash、 terminfo、AI sidecar（app-ai）；数据目录默认非 root（uid 1000）运行。
npm install && npm run build # 前端产物
cd src-tauri && cargo build --release --bin ashell-server --no-default-features --features server
./target/release/ashell-server --bind 0.0.0.0:8090 --dist ../dist./scripts/sync-frontend.sh # 只改前端：构建 + 同步，刷新浏览器即生效
./scripts/build-server-image.sh # 改了 Rust / sidecar：完整重建镜像
docker compose up -d --build- 能力对齐：SSH / 本地终端 / Telnet / 串口 / SFTP / 主机管理 / 端口转发 / AI 助手全部可用；托盘、全局热键、自动更新等桌面能力自动隐藏。浏览器安全模型无法拦截 Ctrl/Cmd+W/T/N 等硬保留键，离开页面有确认兜底，推荐
chrome --app=http://<主机>:8090应用模式获得近原生体验。 - 数据与密钥：所有数据（SQLite、加密密钥
secret.key、AI 配置）都在挂载的数据目录里，备份该目录即备份一切；容器内强制文件密钥（ASHELL_FORCE_KEY_FILE=1，镜像内置），本机直接运行时可用钥匙串（macOS Keychain 等），加--force-key-file可强制文件密钥。 - 安全提示：单用户模型，对外暴露请置于 HTTPS 反代之后。
- 注意：与桌面版共用数据目录时（含 SQLite），请避免两者同时运行。
AShell 集成了 Tauri 2 Updater，通过 GitHub Releases 分发更新。首次启用需要完成以下一次性配置：
npx @tauri-apps/cli signer generate -w ~/.tauri/ashell.key按提示设置密码，命令会输出 Public Key 并将私钥写入指定文件。
将上一步输出的 Public Key 填入 src-tauri/tauri.conf.json 的 plugins.updater.pubkey 字段（替换占位符 REPLACE_WITH_YOUR_PUBLIC_KEY）。
在仓库 Settings → Secrets and variables → Actions 中添加：
| Secret 名 | 值 |
|---|---|
TAURI_SIGNING_PRIVATE_KEY |
私钥文件完整内容 |
TAURI_SIGNING_PRIVATE_KEY_PASSWORD |
生成密钥时设置的密码 |
配置完成后，每次推送 v* 标签触发 tauri-action 时会自动签名更新包并生成 latest.json 上传到 Release，应用内的检查更新即可正常工作。
MIT