⚙️ 概览
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 installrig install --preset agentrig install --all |
update | 更新已安装的工具与组件 | rig update --all |
uninstall | 卸载特定或全部软件组件 | rig uninstall --components dockerrig 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