API 参考

概述

LLStack 面板提供 REST API，所有端点以 /api 为前缀。

认证

除登录和 Setup 端点外，所有 API 需要在 Header 中携带 JWT Token：

Authorization: Bearer <token>

响应格式

// 成功
{"code": 0, "data": { ... }}

// 错误
{"code": 40001, "message": "error_key"}

错误码

码	含义
0	成功
40001	参数错误
40100	未认证
40300	权限不足
40400	资源不存在
50000	服务器错误

端点列表

认证 (/api/auth)

方法	路径	说明
POST	/api/auth/login	登录
POST	/api/auth/logout	登出
POST	/api/auth/refresh	刷新 Token
GET	/api/auth/me	获取当前用户
POST	/api/auth/2fa/setup	配置 2FA
POST	/api/auth/2fa/verify	验证 2FA

站点 (/api/sites)

方法	路径	说明
GET	/api/sites	站点列表
POST	/api/sites	创建站点
GET	/api/sites/{id}	站点详情
PUT	/api/sites/{id}	更新站点
DELETE	/api/sites/{id}	删除站点
GET	/api/sites/{id}/cache	获取缓存配置
PUT	/api/sites/{id}/cache	更新缓存配置
POST	/api/sites/{id}/cache/purge	清除缓存

数据库 (/api/databases)

方法	路径	说明
GET	/api/databases	数据库列表
POST	/api/databases	创建数据库
DELETE	/api/databases/{id}	删除数据库
POST	/api/databases/{id}/export	导出
POST	/api/databases/{id}/import	导入

WordPress (/api/wordpress)

方法	路径	说明
GET	/api/wordpress/instances	实例列表
POST	/api/wordpress/install-quick	快速安装
POST	/api/wordpress/scan	扫描实例
POST	/api/wordpress/instances/{id}/security-scan	安全扫描
GET	/api/wordpress/instances/{id}/plugins	插件列表
POST	/api/wordpress/instances/{id}/plugins/update-all	批量更新

备份 (/api/backup)

方法	路径	说明
POST	/api/backup/restic/init	初始化仓库
POST	/api/backup/restic/snapshot	创建快照
GET	/api/backup/restic/snapshots	快照列表
POST	/api/backup/restic/restore	恢复快照
POST	/api/backup/restic/forget	清理快照
GET	/api/backup/restic/stats	仓库统计

系统 (/api/system)

方法	路径	说明
GET	/api/system/stats	系统状态
POST	/api/system/upgrade	面板升级
POST	/api/system/service-upgrade	服务升级
GET	/api/system/version-check	检查更新

监控 (/api/monitoring)

方法	路径	说明
GET	/api/monitoring/history	历史数据
GET	/api/monitoring/redis-history	Redis 历史
GET	/api/monitoring/cgroup-pressure	cgroup 压力

Staging 环境 (/api/sites/{id}/staging)

方法	路径	说明
POST	/api/sites/{id}/staging	创建 Staging 环境
POST	/api/sites/{id}/staging/push	Push 变更到正式站点
POST	/api/sites/{id}/staging/pull	Pull 正式站点到 Staging
DELETE	/api/sites/{id}/staging	删除 Staging 环境
GET	/api/sites/{id}/staging/status	获取 Staging 状态

CDN 集成 (/api/sites/{id}/cdn)

方法	路径	说明
GET	/api/sites/{id}/cdn	获取 CDN 配置
PUT	/api/sites/{id}/cdn	更新 CDN 配置
DELETE	/api/sites/{id}/cdn	移除 CDN 集成
POST	/api/sites/{id}/cdn/purge	清除 CDN 缓存

漏洞数据库 (/api/wordpress/vulnerability-db)

方法	路径	说明
POST	/api/wordpress/instances/{id}/security-scan	CVE 漏洞扫描
GET	/api/wordpress/vulnerability-db/status	数据库状态
POST	/api/wordpress/vulnerability-db/sync	同步漏洞数据
PUT	/api/wordpress/vulnerability-db/token	配置 API Token
DELETE	/api/wordpress/vulnerability-db/token	删除 API Token

自动更新 (/api/wordpress/instances/{id}/auto-update)

方法	路径	说明
GET	/api/wordpress/instances/{id}/auto-update	获取自动更新配置
PUT	/api/wordpress/instances/{id}/auto-update	更新自动更新配置

备份调度 (/api/backup/restic/schedule)

方法	路径	说明
GET	/api/backup/restic/schedule	获取调度配置
PUT	/api/backup/restic/schedule	更新调度配置

选择性恢复 (/api/backup/restic/restore)

方法	路径	说明
POST	/api/backup/restic/restore	选择性恢复（支持 mode 参数：all/files/database）

Redis ACL (/api/redis/{id}/acl)

方法	路径	说明
GET	/api/redis/{id}/acl	ACL 用户列表
POST	/api/redis/{id}/acl	创建 ACL 用户
DELETE	/api/redis/{id}/acl/{username}	删除 ACL 用户

用户权限 (/api/users/{id}/permissions)

方法	路径	说明
GET	/api/users/{id}/permissions	获取用户权限
PUT	/api/users/{id}/permissions	更新用户权限

提示

面板运行时可以访问 /api-docs 查看交互式 API 文档。