AI 运维工具

发表于 更新于 阅读次数：

Google Antigravity IDE

  • Trae 也可以依此操作配置

本示例演示 Google Antigravity AI 在运维场景中的使用方法。假如需要让 Google Antigravity AI 远程 SSH 连接到目标服务器并利用其 AI Agent 定位运行问题，可以参考以下步骤：

  1. 建立 SSH 远程连接 。Antigravity 基于 VS Code 内核，因此其连接方式与 VS Code 保持一致，但强化了 AI 对远程环境的感知。

    1. 安装插件 。确保已在 Antigravity 中安装了 Remote - SSH 扩展。

      1. 定位到 Setting -> Extensions （或者左侧边栏）中，在顶部搜索框中输入 @installed remote - ssh ，如果列表中出现了 Remote - SSH （通常由 Microsoft 发布），说明已经安装。如果没有任何显示，说明尚未安装。
      2. 如果没有安装，在搜索框中搜索 Remote - SSH ，找到由 Microsoft 发布的版本（Antigravity 完美兼容 VS Code 市场插件），点击 Install

      或者直接发送需求给 Antigravity 让其自动安装

    2. 配置主机 。在 IDE 侧边栏的 Remote Explorer（远程资源管理器） 中添加并连接服务器。

      如果是首次连接，Antigravity 会在目标服务器上安装一个小型的服务端组件（Server Component），以便 AI Agent 能直接在服务器环境下运行。

  2. 打开项目目录 ，连接成功后，点击 Open Folder（打开文件夹） ，选择你运行服务所在的代码目录或配置目录（如 /etc/nginx 或你的后端代码路径）。

  3. 连接成功后，你不需要像以前那样手动翻阅数 GB 的日志。你可以通过侧边栏的 Chat 面板（Ctrl + L）指挥 AI。

    1. 自动日志分析 (Log Auditing)

      • 指令示例 ：查看 /var/log 下最近 5 分钟的系统错误日志，找出导致我的 Java 应用崩溃的原因。

      • AI 行为： Agent 会自动执行 tail -n 100 或 grep 命令，捕获堆栈信息（Stack Trace），并结合项目代码分析是 OOM（内存溢出）、端口冲突还是权限问题 。

    2. 如果你发现服务无法访问（例如 404 或 502）

      • 指令示例 ：检查 8080 端口是否在监听，并测试 Nginx 反向代理到该端口的连通性。

      • AI 行为 ：Agent 会执行 netstat -tunlp 和 curl -I localhost:8080 ，如果发现端口没启动，它会尝试查看启动脚本（如 docker-compose.yml 或 systemd 配置）来定位根源。

  4. 闭环修复 (The “Fix” Loop)

    这是 Antigravity 区别于普通 IDE 的地方：

    • 生成修复计划 (The Plan) ：

      当 Agent 定位到问题（例如：K8s 配置的 resources.limits 太小导致 Pod 被杀）时，它会生成一个 Plan Artifact。

    • 审批修改

      它会展示修改后的代码或配置文件。你只需点击 Apply ，它就会在服务器上直接修改文件。

    • 验证结果

      你可以紧接着说：”修改后重新启动服务，并尝试用内置浏览器访问，确认首页能正常加载。”
      Antigravity 会启动内置浏览器，通过 SSH 隧道访问远程服务，截图反馈给你看。

例如处理 K8s 集群问题：如果你在服务器上配置了 kubectl ，你可以对 Antigravity 说：”帮我列出所有 Pending 状态的 Pod，并分析它们的事件日志，看看是不是节点资源不足。” 它能像一个初级运维工程师一样帮你完成繁琐的查询。

.agent/rules

生成环境中，AI 所做的操作一定要得到审批。否则会产生不可预期的结果 。

不是所有的 AI 工具都会遵循此规则，使用之前一定要确认清楚。比如 Trae 就不会加载 .agent/rules 文件去读取规则。

为了防止 AI 在服务器上乱改，你可以在项目中创建一个 .agent/rules 文件，写明：”严禁直接修改生产数据库” 或 “修改配置前必须先备份旧文件”。Agent 在执行任务时会强制遵守这些规则 。

关于 .agent/rules 的生效范围（作用域） :

  • 项目级规则（最推荐） : 放在你项目代码的根目录下。规则仅对当前打开的特定项目生效。
  • 全局(Global)规则 : 如果你希望在打开任何项目文件夹时，AI 智能体都遵循一套通用的逻辑。通常存放在用户家目录的配置文件夹中
    • Windows : %USERPROFILE%\.antigravity\rules
    • Linux : ~/.antigravity/rules

如果要知道目前使用的 rules 都有哪些，可以直接让 AI 进行汇总

快速创建并测试 ，你不需要手动去文件夹里新建，直接在 Antigravity 的 Chat 面板里对 AI 下令即可：

指令 ： 请给出创建全局规则的步骤

如果您希望为您使用的 AI Agent 配置跨所有项目生效的全局规则，通常可以通过以下步骤完成（具体取决于您使用的编辑器客户端）：

1. 通过编辑器的 AI 设置配置（最常见且推荐）
    大部分 AI 辅助编辑器（如 Cursor、Windsurf 或相关 VS Code 插件）都支持在界面中直接配置全局系统提示词 (System Prompts) 或规则：
    
    步骤：
    打开编辑器的全局设置面板（通常快捷键为 Ctrl + , 或 Cmd + ,）。
    搜索 Rules, Rules for AI, 或对应 AI 助手的名称（如 Agent Rules）。
    在对应的文本框中，输入您期望的全局规则。例如：
    
        1. 禁止以 root 用户执行操作
        2. 切换到用户 wind
        3. 执行任何变更操作都必须得到审批确认才能执行
        
    保存设置。此后无论打开哪个项目，Agent 都会优先加载这些全局规则。

2. 在用户主目录下创建全局规则文件
    部分 AI 助手会自动读取用户主目录（Home 目录 ~）下的特定隐藏文件作为全局指令。
    
    步骤：
    切换到您的宿主机主目录：cd ~
    创建全局规则文件。根据具体的插件约定，通常是 ~/.agent/rules、~/.cursorrules 或 ~/.windsurfrules 等。
    将规则写入该文件：
    
        mkdir -p ~/.agent
        echo "1. 禁止以 root 用户执行操作" > ~/.agent/rules
        echo "2. 切换到用户 wind" >> ~/.agent/rules
        echo "3. 执行任何变更操作都必须得到审批确认才能执行" >> ~/.agent/rules
        
 3. 使用全局 Workflows（工作流）
    
    如果您希望在所有项目中都可以随时调用某个标准化的“规则校验流程”，可以使用全局的 Workflows 功能。

    步骤：
    在全局或项目的 .agents/workflows/（或 _agents/workflows/）目录下创建 Markdown 格式的流程文件。
    例如创建一个 .agents/workflows/enforce-rules.md：
    
    ---
    description: 确保并校验 Agent 遵循基础安全规则
    ---
    1. 检查当前是否为 root 用户，如果是则拒绝操作并提示用户。
    2. 确保后续命令以 `su - wind -c` 或类似方式作为 wind 用户执行。
    3. 在进行任何系统变更前，暂停并等待用户审批。

Claude Code

对于无法配置 SSH（例如内网穿透、防火墙严格限制或云厂商限制）的服务器，Claude Code 是目前最顶级的 终端代理（Terminal Agent） 方案

Claude Code 的配置与使用

Claude Code 的优势在于它是一个 CLI 工具，可以直接安装在目标服务器上。它不需要 SSH 隧道，因为它通过 HTTPS 与 Anthropic 的服务器通信，只要服务器能访问外网（或通过代理访问），就能工作。

  • 安装步骤（服务器端） 。在你的 Linux 服务器终端执行：

    curl -fsSL https://claude.ai/install.sh | bash

    部分地区下载有限制，如 HK，可以在可用地区下载脚本上传到服务器后安装

    或者使用 npm

    npm install -g @anthropic-ai/claude-code

  • 配置与初始化

    1. 登录 ：输入 claude 启动，按照提示完成 OAuth 登录（会给出一个 URL 和授权码）。

      Select login method:

      ❯ 1. Claude account with subscription · Pro, Max, Team, or Enterprise

      2. Anthropic Console account · API usage billing

      3. 3rd-party platform · Amazon Bedrock, Microsoft Foundry, or Vertex AI

  • 执行 claude 命令运行

服务器上运行 gemini cli

Gemini 在服务器运维场景下有一个独特的优势： 超长上下文窗口（Context Window） 。相比 Claude，Gemini 能够一次性 “吞下” 更多的日志文件或整个 Kubernetes 命名空间下的所有配置（YAML），从而提供更具全局观的分析。

  1. 安装 Google AI CLI (基于 Node.js)

    如果还未按照 Node.js , 可以使用以下命令( nvm 管理 Node.js 版本 )安装最新版本(版本太低的话, gemini 不支持)

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
    source ~/.bashrc

    nvm install 20
    nvm use 20
    nvm alias default 20

    安装 Node.js 后安装 gemini-cli

    # 安装
    npm install -g @google/gemini-cli

    # 配置 API Key (从 Google AI Studio 免费获取)
    export GEMINI_API_KEY="你的_API_KEY"

    # 开始对话
    gemini

    参考以下步骤,获取 API Key:

    1. 打开浏览器，访问 Google AI Studio。

    2. 进入页面后，点击左侧导航栏顶部的 Get API key 按钮（通常带有一个钥匙图标）。

    3. 在打开的界面中，你会看到 Create API key 的选项：

      • Create API key in new project ：如果你是第一次使用，选这个。Google 会在你的 Google Cloud 控制台中自动创建一个名为 Generative Language Client 的项目。

    4. 立即复制并保存这串密钥。

  2. 使用命令 gemini 运行

在旧版本 Linux 上通过 Docker 间接运行 Claude Code 或者 ChatGPT Codex

在较旧得 Linux 系统（如 Centos 等）上，因内核版本或者系统库版本较旧，无法运行 Claude Code 或者 ChatGPT Codex 或者其他 AI Agent，此种情况下可以在较旧得系统上首先安装 Docker，然后在 Docker 容器中安装 AI Agent Tools，并挂载宿主机（较旧得 Linux）系统文件到容器中，利用 AI 进行分析。

为了进行持久化操作，本实例使用 Docker Compose 和 Dockerfile，实例 Dockerfile 如下：

Dockerfile

FROM node:22-bookworm

LABEL org.opencontainers.image.title="AI Linux Development Environment"
LABEL org.opencontainers.image.description="SSH development container for Visual Studio, Codex, Claude Code and AI tools"

ARG USERNAME=root

ENV DEBIAN_FRONTEND=noninteractive
ENV TZ=Asia/Shanghai

# ------------------------------------------------------------
# 基础开发环境
# ------------------------------------------------------------
RUN apt-get update && \
    apt-get install -y --no-install-recommends \
        # SSH
        openssh-server \
        openssh-client \
        sudo \
        \
        # C/C++ / Visual Studio Linux Development
        build-essential \
        gcc \
        g++ \
        gdb \
        cmake \
        ninja-build \
        make \
        pkg-config \
        rsync \
        zip \
        unzip \
        \
        # Git / Source
        git \
        git-lfs \
        \
        # Python
        python3 \
        python3-pip \
        python3-venv \
        python3-dev \
        \
        # 常用 Shell 工具
        bash \
        bash-completion \
        curl \
        wget \
        ca-certificates \
        gnupg \
        jq \
        ripgrep \
        less \
        vim \
        nano \
        tree \
        file \
        locales \
        \
        # 系统/网络诊断
        procps \
        psmisc \
        lsof \
        strace \
        iproute2 \
        iputils-ping \
        net-tools \
        dnsutils \
        telnet \
        traceroute \
        tcpdump \
        \
        # 压缩/证书等
        xz-utils \
        tar \
        openssl \
    && rm -rf /var/lib/apt/lists/*

# ------------------------------------------------------------
# Locale
# ------------------------------------------------------------
RUN sed -i '/en_US.UTF-8/s/^# //g' /etc/locale.gen && \
    locale-gen

ENV LANG=en_US.UTF-8
ENV LANGUAGE=en_US:en
ENV LC_ALL=en_US.UTF-8


# ------------------------------------------------------------
# SSH 配置
# ------------------------------------------------------------
RUN mkdir -p /run/sshd && \
    mkdir -p "/root/.ssh" && \
    chmod 700 "/root/.ssh" && \
    chown -R root:root "/root/.ssh"

RUN printf '%s\n' \
    'Port 22' \
    'ListenAddress 0.0.0.0' \
    'Protocol 2' \
    'PermitRootLogin yes' \
    'PubkeyAuthentication yes' \
    'PasswordAuthentication yes' \
    'KbdInteractiveAuthentication no' \
    'AuthorizedKeysFile .ssh/authorized_keys' \
    'AllowTcpForwarding yes' \
    'GatewayPorts no' \
    'X11Forwarding no' \
    'PrintMotd no' \
    'PrintLastLog yes' \
    'PermitUserEnvironment no' \
    'ClientAliveInterval 60' \
    'ClientAliveCountMax 3' \
    'Subsystem sftp internal-sftp' \
    > /etc/ssh/sshd_config \
    && chmod 600 /etc/ssh/sshd_config

RUN mkdir -p /run/sshd && ssh-keygen -A 

# ------------------------------------------------------------
# AI CLI
#
# Codex:
#   npm install -g @openai/codex
#
# Claude Code:
#   npm install -g @anthropic-ai/claude-code
# ------------------------------------------------------------
RUN npm install -g \
        @openai/codex \
        @anthropic-ai/claude-code \
    && npm cache clean --force

# ------------------------------------------------------------
# 用户环境
# ------------------------------------------------------------
RUN printf '%s\n' \
    '' \
    '# AI Development Environment' \
    'export EDITOR=vim' \
    'export VISUAL=vim' \
    'export PATH="$HOME/.local/bin:$HOME/bin:$PATH"' \
    '' \
    "alias ll='ls -alF'" \
    "alias la='ls -A'" \
    "alias l='ls -CF'" \
    'alias python=python3' \
    'alias pip=pip3' \
    '' \
    'echo ""' \
    'echo "AI Development Container"' \
    'echo "------------------------"' \
    'echo "Codex:       $(command -v codex 2>/dev/null || echo not-installed)"' \
    'echo "Claude Code: $(command -v claude 2>/dev/null || echo not-installed)"' \
    'echo "Node:        $(node --version 2>/dev/null)"' \
    'echo "Python:      $(python3 --version 2>/dev/null)"' \
    'echo "Git:         $(git --version 2>/dev/null)"' \
    'echo ""' \
    >> /root/.bashrc

RUN chown root:root "/root/.bashrc"

# ------------------------------------------------------------
# Workspace
# ------------------------------------------------------------
RUN mkdir -p /workspace && \
    chown root:root /workspace

WORKDIR /workspace

主要操作：

  • 安装常用工具
  • 安装并配置 sshd 以供 ssh 远程连接（Visual Studio Code 等工具）
  • 安装 codex 、 claude 等 AI 工具

docker-compose.yaml 内容如下：

docker-compose.yaml

services:
  agent:
    build:
      context: .
    volumes:
      - /:/workspace:ro
    command: ['/usr/sbin/sshd', '-D', '-e']
    ports:
      - 22:22

主要操作：

  • 启动容器，容器启动时运行 sshd 服务
  • 挂载文件系统，本示例挂载了整个宿主机根目录，如果定位得问题无需读取整个宿主机文件系统，只需要挂载所需得文件系统内容即可。

容器启动后，需要手动配置 ssh 登陆信息（密码或者密钥）