1Panel 技能

通过 AI Agent 管理 1Panel 服务器。全面支持 580+ 个 API 接口，覆盖容器、数据库、网站、SSL、文件管理、系统监控等功能。

前置条件

• 1Panel 服务器（https://1panel.cn/）
• 从 1Panel 控制台 → 个人资料 → API 获取 API Key

配置

设置环境变量：

export ONEPANEL_API_KEY="your-api-key"
export ONEPANEL_HOST="localhost"      # 可选，默认值：localhost
export ONEPANEL_PORT="8080"           # 可选，默认值：8080
export ONEPANEL_PROTOCOL="http"       # 可选，默认值：http

快速开始

# 列出容器
node {baseDir}/scripts/1panel.mjs containers

# 获取容器详情
node {baseDir}/scripts/1panel.mjs container 

# 启动 / 停止 / 重启容器
node {baseDir}/scripts/1panel.mjs start 
node {baseDir}/scripts/1panel.mjs stop 
node {baseDir}/scripts/1panel.mjs restart 

# 列出镜像
node {baseDir}/scripts/1panel.mjs images

# 列出网站
node {baseDir}/scripts/1panel.mjs websites

# 列出数据库
node {baseDir}/scripts/1panel.mjs databases

# 列出文件
node {baseDir}/scripts/1panel.mjs files /opt

# 获取系统信息
node {baseDir}/scripts/1panel.mjs system

# 获取仪表盘信息
node {baseDir}/scripts/1panel.mjs dashboard

可用命令

API 覆盖范围

容器与 Docker（24 个工具）

• 容器生命周期管理（创建、启动、停止、重启、暂停、终止、删除）
• 镜像管理（拉取、推送、构建、打标签、保存、加载）
• 网络与卷管理
• Docker Compose 操作

网站管理（24 个工具）

• 网站创建与配置
• 域名管理
• SSL 证书（Let's Encrypt、手动上传）
• HTTPS 配置
• Nginx 配置
• OpenResty（XPack）

数据库（24 个工具）

• MySQL（创建、删除、绑定用户、修改密码）
• PostgreSQL
• Redis（配置、密码、状态）

文件操作（19 个工具）

• 列出、上传、下载
• 压缩 / 解压（zip、tar、tar.gz）
• 移动、重命名、删除
• 权限管理（chmod、chown）

系统与安全（20+ 个工具）

• 系统设置
• 防火墙规则
• Fail2ban
• SSH 管理
• ClamAV 杀毒软件
• FTP 服务器

监控（8 个工具）

• 仪表盘
• 系统监控
• 设备信息
• 磁盘管理

备份与恢复（13 个工具）

• 备份操作
• 备份账户（本地、SFTP、OSS、S3）
• 系统快照
• 回收站

XPack 功能（47 个工具）

• AI Agent 管理
• MCP Server
• Ollama 模型
• GPU 监控
• OpenResty
• Node.js 运行时

输出格式

所有命令均以 JSON 格式输出：

{
  "data": [...],
  "success": true
}

出错时输出：

{
  "error": true,
  "message": "错误描述"
}

高级用法

如需完整访问 API，可将其作为库使用：

import { OnePanelClient } from '1panel-skill';

const client = new OnePanelClient({
  host: 'localhost',
  port: 8080,
  apiKey: 'your-api-key',
  protocol: 'http'
});

// 完整 API 访问能力
const containers = await client.containers.list();
const websites = await client.websites.list();

相关链接

• GitHub
• npm
• 1Panel