公益 · 免费 · 永久免费

SamCommand

把任何机器变成可远程控制的命令执行代理。一行命令安装，公网 URL 直连，跨平台支持 Linux / macOS / Windows / Android。

🚀 一行安装 📦 直接下载
核心能力

为什么选择 SamCommand

基于 aitun.cc 隧道，无需公网 IP，无需开端口。启动即获得公网 HTTPS URL，任何设备都能远程控制。

🌐
公网 URL 直连
基于 aitun.cc 隧道，启动即获得 https://<sub>.t.aitun.cc 公网地址，任何设备都能访问。
⚡
远程 Shell 执行
POST /exec 即可执行任意 shell 命令（bash/cmd），支持 cwd、timeout、env 自定义。
📁
文件双向传输
POST /upload 上传，GET /download 下载，GET /ls 列目录，GET /stat 查 SHA256。流式传输，支持 200MB。
🔗
SSH 跳板
POST /ssh 端点把 samcommand 主机当作跳板，远程控制内网任何 SSH 主机。
🛡️
Bearer Token 鉴权
所有写操作需 Bearer token，自动生成 256 位强 token，支持 --token 自定义。
📱
跨平台 + 32位 ARM
Linux amd64/arm64/arm（含老 Android 平板）、Windows amd64、macOS amd64/arm64 全支持。
快速安装

一行命令安装

自动检测平台架构，下载对应二进制到 /usr/local/bin 或 ~/.local/bin。

Linux / macOS · curl + bash
# 一行安装（自动检测 amd64/arm64/arm） curl -fsSL https://samai.cc/samcommand/downloads/install.sh | bash # 任何时候重新运行此命令即可更新到最新版
备用安装命令（ModelScope 源，主源不可用时点击展开）
macOS / Linux（Termux 也支持）
curl -fsSL 'https://modelscope.cn/api/v1/models/luoyunlan168/samcommand/repo?Revision=master&FilePath=install.sh' | bash
Windows · PowerShell
# 在 PowerShell 中执行（管理员装到 Program Files，否则装到 %LOCALAPPDATA%） irm https://samai.cc/samcommand/downloads/install.ps1 | iex
备用安装命令（ModelScope 源，主源不可用时点击展开）
Windows（PowerShell，管理员装到 Program Files，普通用户装到 %LOCALAPPDATA%）
irm 'https://modelscope.cn/api/v1/models/luoyunlan168/samcommand/repo?Revision=master&FilePath=install.ps1' | iex
🤖 Android · SamDocker
老平板/手机变公网可控节点 — samcommand 已内置，开机自启，无需 root
下载 SamDocker APK
快速开始

安装后终端运行 samcommand

30 秒拿到公网 URL。

终端运行 samcommand
$ samcommand [samcommand] subdomain ready: samcmd-host-a1b2c3d4e5.t.aitun.cc [samcommand] public URL: https://samcmd-host-a1b2c3d4e5.t.aitun.cc [samcommand] tunnel token (ait_): ait_x7Kd...Qm3f [samcommand] local API listening on :8090
跨平台下载

直接下载二进制

所有二进制均为静态链接，无任何运行时依赖。SHA256 校验请见 checksums-sha256.txt。

平台 架构 文件 大小 下载
🐧Linux x86-64 (amd64) samcommand-linux-amd64 7.4 MB 下载
🐧Linux ARM 64-bit (arm64) samcommand-linux-arm64 6.8 MB 下载
🐧Linux ARM 32-bit v7 (armv7l) samcommand-linux-arm 7.1 MB 下载
🪟Windows x86-64 (amd64) samcommand-windows-amd64.exe 7.5 MB 下载
🍎macOS Intel (amd64) samcommand-darwin-amd64 7.5 MB 下载
🍎macOS Apple Silicon (arm64) samcommand-darwin-arm64 6.9 MB 下载
📜安装脚本 Linux / macOS install.sh 2.1 KB 下载
📜安装脚本 Windows PowerShell install.ps1 2.0 KB 下载
API 参考

HTTP 端点

所有端点（除 /health）需 Authorization: Bearer <token> 或 X-SamCommand-Token: <token> 头。命令端点同时接受 JSON、text/plain 裸命令与 Samai Command 信封体（见下方信封机制）。

方法路径用途
GET/health存活探测（无需鉴权）
GET/info主机信息（OS、CPU、IP、运行时间）
GET/statussamcommand 版本、主机与进程状态
POST/exec执行 shell 命令（Linux bash / Windows cmd；JSON / 裸文本 / 信封体）
POST/exec/async后台异步执行，立即返回 job_id（不受隧道 ~120s 限制）
GET/exec/stream流式执行，实时返回输出
GET/cmd?c64=...&token=...GET 方式执行命令（?c= 明文或 ?c64= base64url，AI Agent 专用）
POST/ps1执行 PowerShell（写入临时 .ps1 文件经 -File 运行，免疫引号转义）
POST/ps1/async后台异步执行 PowerShell
GET/ps1/stream流式执行 PowerShell
POST/ssh通过 SSH 在远程主机执行命令（跳板）
GET/jobs列出所有后台任务（运行中 + 最近完成）
GET/job/{id}?wait=1查询任务状态 / 输出（?wait=1 阻塞等待完成）
POST/job/{id}/kill终止后台任务
GET/service服务自治：列出持久化服务（/start /stop /remove /log 管理）
GET/ls?path=...列目录
GET/stat?path=...文件信息 + SHA256
POST/upload?path=...上传文件（raw body 或 multipart）
GET/download?path=...下载文件（流式）
信封机制

Samai Command 信封

IM/聊天网关会吞引号、剥反斜杠、重排换行，命令到达时早已面目全非；信封机制让命令体只含 base64url 安全字符，任何网关都无法破坏。

用法：命令包进信封体直接 POST 到 /exec 或 /ps1（Content-Type: text/plain）——samaicmdbegin / v=1 / enc=b64url / crc=CRC32 / payload / samaicmdend。

命令端点加 ?respenc=b64url，响应（stdout / stderr / command）同样以 base64url 返回；传统 JSON 请求体 100% 向后兼容。