wiki/智能体平台调研/CONFIG.md

name, description, metadata

name	description	metadata
spring-ai-alibaba-deployment-config	Spring AI Alibaba 全功能平台部署配置清单 — 账号密码、端口、地址	type project

Spring AI Alibaba 全功能平台 — 配置清单

部署时间：2026-06-05 环境：WSL2 Debian 13 · 本地内网 WSL2 IP：172.18.79.129 关联文档：spring-ai-alibaba-deployment-guide

---

一、服务端口与地址

中间件

服务	端口	用途	本地访问	内网访问
PostgreSQL 16	5432	Agent 状态 + 数据集 + 向量检索	localhost:5432	172.18.79.129:5432
Nacos	8848	控制台 + HTTP API	http://localhost:8848/nacos	http://172.18.79.129:8848/nacos
Nacos gRPC	9848	MCP 服务注册发现（gRPC）	localhost:9848	—
MinIO API	9000	S3 对象存储 API	http://localhost:9000	—
MinIO Console	9001	MinIO Web 管理界面	http://localhost:9001	http://172.18.79.129:9001

应用

服务	端口	用途	地址
Agent Platform	8080	Spring AI Alibaba 主应用	http://localhost:8080
Admin Studio	8080/chatui	可视化编排 + 评测 + 监控	http://localhost:8080/chatui
Actuator Health	8080/actuator/health	健康检查	http://localhost:8080/actuator/health
Actuator Metrics	8080/actuator/metrics	指标采集	http://localhost:8080/actuator/metrics

外网模型 API

服务	地址	说明
DashScope（百炼）	https://dashscope.aliyuncs.com	通义千问 LLM，外网调用
DashScope 控制台	https://dashscope.console.aliyun.com/	API Key 管理

---

二、账号密码（开发环境）

中间件凭证

服务	用户名	密码	数据库/命名空间
PostgreSQL	sa_agent	agent_2026	spring_ai_agent
Nacos	nacos（v2.5.1 默认无鉴权）	nacos	—
MinIO	minioadmin	minioadmin	—

Nacos 命名空间

命名空间 ID	名称	用途
sa-agent-mcp	MCP 注册发现	MCP Server/Client 服务注册
sa-agent-config	动态配置	Prompt 模板 + 模型参数热更新
sa-agent-a2a	A2A 通信	多 Agent 跨服务通信（可选）

MinIO Bucket

Bucket	用途
sa-agent-memory	Agent 记忆文件（MEMORY.md / 快照 / 知识图谱）
sa-agent-datasets	评测数据集存储
sa-agent-skills	自定义 Skill 文件存储

外网 API Key

服务	环境变量	获取地址
DashScope	DASHSCOPE_API_KEY	https://dashscope.console.aliyun.com/
Jina AI（可选）	JINA_API_KEY	https://jina.ai/

systemd 服务

服务名	用途
agent-platform	Spring AI Alibaba 应用自启动
docker	Docker daemon

---

三、文件路径

/mnt/d/wiki/智能体平台调研/
├── 代码/
│   ├── docker-compose.yml        # 中间件 Docker 编排（Nacos + PG + MinIO）
│   ├── start.sh                  # 一键启动脚本
│   ├── health-check.sh           # 健康检查脚本
│   └── agent-platform/           # Spring Boot 应用源码
│       ├── pom.xml               # Maven 依赖（全功能）
│       ├── .env                  # 环境变量模板
│       ├── .mvn/settings.xml     # Maven 仓库配置
│       └── src/main/
│           ├── resources/
│           │   └── application.yml   # 全功能配置
│           └── java/com/demo/agent/
│               └── AgentPlatformApplication.java
├── 报告/
│   ├── ai-agent-platform-comparison.html        # 平台调研报告
│   └── spring-ai-alibaba-deployment-guide.html  # 部署指南
└── CONFIG.md                    # ← 本文件

Docker 数据卷

卷名	宿主机路径（默认）	内容
sa_pg_data	Docker volumes	PostgreSQL 数据文件
sa_nacos_data	Docker volumes	Nacos 数据
sa_minio_data	Docker volumes	MinIO 对象数据

---

四、Docker 容器

容器名	镜像	自启动
sa-pg	pgvector/pgvector:pg16	restart: unless-stopped
sa-nacos	nacos/nacos-server:v2.5.1	restart: unless-stopped
sa-minio	minio/minio:latest	restart: unless-stopped
sa-minio-init	minio/mc:latest	一次性（初始化 Bucket 后退出）

---

五、快速操作命令

启动

# 1. 启动中间件（Docker Compose）
cd /mnt/d/wiki/智能体平台调研/代码
docker compose up -d

# 2. 加载环境变量
source agent-platform/.env   # 记得先填写 DASHSCOPE_API_KEY

# 3. 构建并启动应用
cd agent-platform
mvn spring-boot:run

# 或构建 jar 后运行
mvn clean package -DskipTests
java -jar target/agent-platform-1.0.0.jar

停止

# 停止应用：Ctrl+C 或
sudo systemctl stop agent-platform

# 停止中间件
cd /mnt/d/wiki/智能体平台调研/代码
docker compose down

常用运维

# 查看中间件日志
docker compose -f /mnt/d/wiki/智能体平台调研/代码/docker-compose.yml logs -f nacos

# 查看应用日志
tail -f /mnt/d/wiki/智能体平台调研/代码/agent-platform/logs/agent-platform.log

# 健康检查
bash /mnt/d/wiki/智能体平台调研/代码/health-check.sh

# 数据备份
pg_dump -h localhost -U sa_agent spring_ai_agent > backup_$(date +%Y%m%d).sql

---

六、安全提醒

1. 所有密码为开发环境默认值，生产内网部署后应立即修改
2. Nacos 不要暴露到公网（默认鉴权较简单），当前纯内网使用可接受
3. DashScope API Key 不要提交到 git，已通过 .gitignore 排除 .env
4. Nacos Auth Token（SecretKey0123...）是 Nacos 鉴权密钥，生产环境必须更换为 32 位以上随机字符串
5. PostgreSQL 远程访问（pg_hba.conf）已配置 0.0.0.0/0 md5，仅限内网使用