Linux 快速安装（推荐）
一行命令下载 release、校验 checksums 并安装到 PATH。
curl -fsSL https://raw.githubusercontent.com/AS153929/roswire/main/scripts/install.sh | sh
roswire doctor --json`doctor --json` 默认只检查本机环境，不会主动连接 RouterOS。
Guide
安装 roswire
目标：在最短路径内拿到可运行的 `roswire` 二进制，并完成首轮本机诊断与最小 profile 配置。
安装脚本可调参数
| 变量 | 用途 |
|---|---|
ROSWIRE_VERSION |
指定 release tag（例如 v0.0.3） |
ROSWIRE_INSTALL_DIR |
指定安装目录（默认 /usr/local/bin） |
ROSWIRE_REPO |
指定 GitHub 仓库（默认 AS153929/roswire） |
ROSWIRE_VERIFY=0 |
跳过 SHA256 校验（不推荐） |
Cargo / 源码安装
适用于 macOS 或希望从源码构建当前分支的场景。
cargo install roswire --locked
# 或
cargo install --git https://github.com/AS153929/roswire --locked
# 或（本地仓库）
cargo install --path . --lockedRelease 产物命名
| 平台 | 文件 |
|---|---|
| Linux x86_64 | roswire-linux-amd64.tar.gz |
| Linux arm64 | roswire-linux-arm64.tar.gz |
| Windows x86_64 | roswire-windows-amd64.zip |
| 校验文件 | checksums.txt |
最小配置示例
export ROSWIRE_STUDIO_PASSWORD="replace-with-secret"
roswire config init --json
roswire config device add studio host=192.168.88.1 user=admin protocol=auto transfer=ssh --json
roswire config secret set studio password type=env env=ROSWIRE_STUDIO_PASSWORD --json
roswire --profile studio interface print --json建议优先使用 keychain/env secret 引用，不把密码明文写入命令行历史。
常见注意事项
- macOS 目前建议通过源码安装获取本机二进制。
- 文件传输（upload/download）需要 SSH host key 指纹配置。
- 生产前请执行 release checksums 校验，不要跳过完整性验证。
- 卸载二进制不会自动删除系统 keychain 中的凭据。