Nacos 服务注册与配置管理

技能文档

---
name: nacos
title: Nacos 服务注册与配置管理
category: 开发工具
description: Nacos 服务注册与发现、配置中心操作工具。支持查看服务列表、服务详情、实例状态，以及配置列表、配置内容、配置历史、多环境切换。当用户需要查询 Nacos 服务注册状态、查看微服务实例、管理配置中心内容、切换 Nacos 环境时触发。触发词：Nacos、服务发现、配置中心、注册中心、微服务治理
---

# Nacos 操作

通过 `nacos_cli.py` 脚本直接操作 Nacos 服务注册与发现和配置中心。

## 技能工作流

### 步骤1：首次配置

首次执行命令时，如果检测到配置不存在，会自动启动交互式配置向导。也可以手动运行：

```bash
python3 <SKILL目录>/scripts/nacos_cli.py --init
```

配置文件位置：`~/.config/nacos/config.json`（可通过 `AGENT_NACOS_CONFIG` 环境变量覆盖）

配置示例：

```json
{
  "current": "local",
  "local": {
    "server_addr": "localhost:8848",
    "namespace": "",
    "username": "",
    "password": "",
    "group": "DEFAULT_GROUP"
  }
}
```

配置字段说明：

| 字段 | 说明 | 示例 |
|------|------|------|
| `server_addr` | Nacos 服务器地址 | `localhost:8848`、`nacos.example.com:8848` |
| `namespace` | 命名空间 ID，空字符串表示 public | `dev`、`prod`、`` |
| `username` | 用户名（开启认证时填写） | `nacos` |
| `password` | 密码（开启认证时填写） | `nacos` |
| `group` | 默认分组 | `DEFAULT_GROUP` |

支持同时配置多个环境，通过 `--env` 切换：

```json
{
  "current": "local",
  "local": {
    "server_addr": "localhost:8848",
    "namespace": "",
    "username": "",
    "password": "",
    "group": "DEFAULT_GROUP"
  },
  "test": {
    "server_addr": "nacos.test.example.com:8848",
    "namespace": "test",
    "username": "nacos",
    "password": "nacos",
    "group": "DEFAULT_GROUP"
  }
}
```

切换环境：

```bash
python3 <SKILL目录>/scripts/nacos_cli.py --env test --services
```

### 步骤2：服务注册与发现

```bash
# 查看命名空间列表
python3 <SKILL目录>/scripts/nacos_cli.py --namespaces

# 查看所有服务
python3 <SKILL目录>/scripts/nacos_cli.py --services

# 分页查看
python3 <SKILL目录>/scripts/nacos_cli.py --services --page 1 --page-size 20

# 查看指定服务详情
python3 <SKILL目录>/scripts/nacos_cli.py --service user-service

# 查看指定服务的实例列表
python3 <SKILL目录>/scripts/nacos_cli.py --instances user-service

# 指定分组查询
python3 <SKILL目录>/scripts/nacos_cli.py --instances user-service --group MY_GROUP
```

### 步骤3：配置中心管理

```bash
# 查看配置列表
python3 <SKILL目录>/scripts/nacos_cli.py --configs

# 分页查看
python3 <SKILL目录>/scripts/nacos_cli.py --configs --page 1 --page-size 20

# 查看指定配置内容
python3 <SKILL目录>/scripts/nacos_cli.py --config-item app.yaml

# 指定分组
python3 <SKILL目录>/scripts/nacos_cli.py --config-item app.yaml --group MY_GROUP

# 查看配置历史版本
python3 <SKILL目录>/scripts/nacos_cli.py --history app.yaml
```

### 步骤4：结果输出与错误处理

支持 JSON 格式输出：

```bash
python3 <SKILL目录>/scripts/nacos_cli.py -j --services
```

> **注意**：`<SKILL目录>` 会被自动替换为当前技能的实际路径

脚本自动处理以下常见问题：

| 问题 | 自动处理 |
|------|----------|
| `requests` 未安装 | 自动安装依赖 |
| 配置文件不存在 | 自动启动配置向导 |
| Nacos 连接失败 | 显示详细错误信息 |

常见错误排查：
- `HTTP 403` — 认证失败，检查用户名密码
- `HTTP 404` — 服务或配置不存在
- `ConnectionError` — 连接失败，检查 Nacos 服务地址和端口

## 参数说明

| 参数 | 说明 | 示例 |
|------|------|------|
| `--init` | 初始化配置 | `--init` |
| `--env, -e` | Nacos 环境 | `--env prod` |
| `--config, -c` | 配置文件路径 | `--config /path/to/config.json` |
| `--json, -j` | JSON 格式输出 | `-j` |
| `--namespaces` | 查看命名空间列表 | `--namespaces` |
| `--services` | 查看服务列表 | `--services` |
| `--service` | 查看服务详情 | `--service order-service` |
| `--instances` | 查看服务实例 | `--instances order-service` |
| `--configs` | 查看配置列表 | `--configs` |
| `--config-item` | 查看配置详情 | `--config-item app.yaml` |
| `--history` | 查看配置历史 | `--history app.yaml` |
| `--group, -g` | 指定分组 | `--group MY_GROUP` |
| `--page` | 页码 | `--page 1` |
| `--page-size` | 每页数量 | `--page-size 20` |

## 安全注意事项

- 生产环境操作前确认环境是否正确（`--env`）
- 查看配置内容时注意敏感信息（密码、密钥等）不要泄露
- 不确定服务名时先用 `--services` 查看服务列表
- 不确定配置名时先用 `--configs` 查看配置列表

使用说明

# Nacos 服务注册与配置管理

通过命令行直接操作 Nacos 服务注册与发现、配置中心，支持多环境切换。

## 使用

```bash
# 首次配置
python3 <SKILL目录>/scripts/nacos_cli.py --init

# 查看所有服务
python3 <SKILL目录>/scripts/nacos_cli.py --services

# 查看服务实例
python3 <SKILL目录>/scripts/nacos_cli.py --instances order-service

# 查看配置内容
python3 <SKILL目录>/scripts/nacos_cli.py --config-item app.yaml

# 切换环境
python3 <SKILL目录>/scripts/nacos_cli.py --env prod --services
```

## 工作原理

技能通过内置的 `nacos_cli.py` 脚本调用 Nacos Open API，实现服务列表查询、实例状态查看、配置管理与历史追溯。首次使用时自动引导配置连接信息，支持多环境一键切换。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。