TaskSSH 是一个单文件、无依赖的 SSH 批量运维工具。你只需要写一个 inventory.yaml，定义服务器组、认证信息和任务步骤，就能一次对多台服务器执行命令、上传文件、下载文件。

一份清单，一条命令，一批服务器。

如果你厌倦了用 Shell 循环 + sshpass 管理服务器，又觉得 Ansible 对小型场景太重，TaskSSH 可能正适合你。

特性

核心定位

• 单文件、无依赖：下载即用，不需要 Python、Agent 或额外运行环境。
• YAML 声明式配置：服务器、变量、任务全部写在 inventory.yaml，可提交、可审查。
• 跨平台：Windows、Linux、macOS，一个二进制文件。

任务编排

• Action + Task 模型：command、push、fetch、script 四种原子操作，自由组合为有序流程。
• 变量系统：{{var}} 语法，global / 组 / 主机 / CLI 四级合并，支持递归展开。
• 条件执行：when 表达式，按主机变量决定 step 是否执行。
• 错误容忍：ignore_errors 让单步失败不中断整条任务。

批量控制

• 按组分批：serial 与 min_available 控制每批主机数与安全余量，支持滚动部署。
• 并发执行：-c 控制批内并发数，默认串行。
• Dry-run：--dry-run 不连接主机，输出每台每步将执行的内容。

安全

• 密码加密存储：AES-256-GCM 加密，清单中不出现明文。
• 密钥外置：密钥由用户管理，不硬编码在二进制中。
• 多种认证：公钥、keyboard-interactive、密码，按优先级尝试。

传输能力

• 文件与目录传输：push / fetch 支持单文件和目录。
• 两种目录模式：默认递归逐文件，-z 则打包传输，减少连接开销。

支持平台

平台	架构
Windows	amd64
Linux	amd64
Linux	arm64
macOS	amd64 (Intel)
macOS	arm64 (Apple Silicon)

安装

前往 Releases 页面，下载对应平台的压缩包，解压后得到 taskssh / taskssh.exe。

Linux / macOS 下添加执行权限：

chmod +x taskssh

快速开始

1. 创建密钥文件

用于加密清单中的密码。只需创建一次：

mkdir -p ~/.taskssh
openssl rand -base64 32 > ~/.taskssh/vault-key
chmod 600 ~/.taskssh/vault-key

2. 加密密码

taskssh encrypt "your-password"
# 输出：xxxxx

3. 创建 inventory.yaml

global_vars:
  username: deploy
  password: "xxxxx"        # 上一步的密文

servers:
  prod:
    vars:
      service_path: /opt/myapp/
    hosts:
      web1: 192.168.1.10
      web2: 192.168.1.11

tasks:
  release:
    steps:
      - name: "上传新版本"
        action: push
        with:
          file: "./dist/app.jar"
          dest: "${service_path}"
          force: true
      - name: "重启服务"
        action: command
        with:
          command: "systemctl restart myapp"
        delay: 5

4. 执行任务

taskssh release prod -y

文档

完整文档见 document.html，包含：

• 清单文件详解（global_vars / servers / tasks）
• Action 参考（command / push / fetch / script）
• 变量替换规则
• Vault 密钥管理
• 命令行选项
• 认证方式
• 常见问题

更新日志

CHANGELOG