roswire · 安装指南
Description: roswire 安装指南：Linux 快速安装、Cargo 安装、平台产物选择、最小配置和校验步骤。

Guide

# 安装 roswire

目标：在最短路径内拿到可运行的 `roswire` 二进制，并完成首轮本机诊断与最小 profile 配置。

文档版本基于 `docs/installation.md`，更新日期：2026-05-19。

查看 Markdown 原文 回到快速开始

## Linux 快速安装（推荐）

一行命令下载 release、校验 checksums 并安装到 PATH。

    curl -fsSL https://raw.githubusercontent.com/AS153929/roswire/main/scripts/install.sh | sh
    roswire doctor --json

`doctor --json` 默认只检查本机环境，不会主动连接 RouterOS。

## 安装脚本可调参数

变量 | 用途
--- | ---
`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 . --locked

## Release 产物命名

平台 | 文件
--- | ---
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 中的凭据。