⚙️ 概览

rig(项目:X-Zero-L/rig)是一款轻量级的开荒与开发环境管理框架。它通过统一的抽象屏蔽了 Debian/Ubuntu、CentOS/RHEL、Fedora、Arch Linux 及 macOS 等操作系统的差异,支持一键安装、更新、导出与卸载各类 Shell 工具、语言运行时、基础设施及 AI 编程助手。

  • CLI 可执行文件位置: /root/.local/bin/rig
  • 应用配置文件与导出格式: JSON / secrets.env

📜 命令语法结构

rig 的基本语法如下:

rig <subcommand> [options]
子命令说明示例
status查看当前系统各项组件的安装与配置状态rig status
install启动交互式 TUI 选单或按预设安装组件rig install
rig install --preset agent
rig install --all
update更新已安装的工具与组件rig update --all
uninstall卸载特定或全部软件组件rig uninstall --components docker
rig uninstall --all --yes
export将当前环境配置导出为 JSON 配置文件rig export > rig-config.json
import从 JSON 配置文件恢复/迁移开发环境rig import rig-config.json
self-update升级 rig CLI 工具本身rig self-update

📦 支持管理的核心组件列表

├── 基础环境 (Shell & Tools)
│   ├── shell          (Zsh, Starship 提示符)
│   ├── tmux           (Terminal 复用器)
│   ├── git            (版本控制)
│   └── essential-tools (rg, fd, bat, jq, gh 命令行瑞士军刀)
├── 语言运行时 (Runtimes)
│   ├── node           (Node.js via nvm)
│   ├── uv             (Python 环境与包管理)
│   └── go             (Go 语言环境 via goenv)
├── 基础设施 (Infrastructure)
│   ├── docker         (Docker & Docker Compose)
│   ├── tailscale      (虚拟局域网 Mesh VPN)
│   └── ssh            (SSH 安全加固)
└── AI 编程助手 (AI Tools)
    ├── claude-code    (Claude Code CLI)
    ├── codex          (Codex CLI)
    ├── gemini         (Gemini CLI)
    └── skills         (Agent Skills 技能库)

🚀 常见使用场景实战

1. 查看环境状态

rig status

执行后会输出表格,清晰标出每个组件的安装状态(✔ 已安装,✘ 未配置,◐ 部分配置)。


2. 预设快捷安装 (Presets)

不用逐个勾选组件,可直接选择预设批处理:

# 仅安装基础 Shell + CLI 常用工具
rig install --preset minimal

# 仅安装基础设施 (Docker, SSH 加固, Tailscale)
rig install --preset devops

# 全量一键安装
rig install --preset fullstack

3. 环境快照导出与跨机器迁移

在旧服务器导出:

rig export

这会生成 rig-config.json(保存安装的项目列表)和 secrets.env(保存环境变量/Key,自动设为 600 权限)。

在新服务器一键导入恢复:

rig import rig-config.json

4. 精准卸载与清理

# 查看有哪些组件支持卸载
rig uninstall --list

# 仅卸载特定的组件 (如 Docker)
rig uninstall docker

# 卸载特定组件并清理其持久化数据
rig uninstall docker --remove-docker-data

# 无交互模式一键卸载全部组件
rig uninstall --all --yes

🌐 镜像与代理支持 (国内 VPS 加速)

若在网络受限环境或国内 VPS 上使用,可在命令前加 --gh-proxy 参数或环境变量:

# 环境变量方式
export GH_PROXY="https://gh-proxy.org"
rig status

# 命令参数方式
rig install --gh-proxy https://gh-proxy.org