# 云端资源（凭证管理 + 云服务对接）

> 文档更新：2026-09-27 ｜ 适用版本：v3 ｜ 功能位置：「云端资源」菜单总览页（/cloud），其余页面从总览页卡片进入

## 这组功能是干什么的

把常用的云服务接入面板统一操作：域名解析、对象存储、文件传输、SSH 终端、CDN 管理、静态站点部署、云服务器管理等。所有云服务都依赖**凭证管理**统一配置 API 密钥——第一次使用某个云服务前，先去添加对应凭证。

## 凭证管理（所有云服务的前提）

统一管理面板接入外部服务的 API 密钥，凭证类型：

| 类型 | 用途 |
|---|---|
| 通用 SSH / 仅 SSH 终端 / 仅 SFTP | SSH 操作、Web 终端、SFTP 文件管理 |
| 腾讯云 / 阿里云 / 雨云 | 域名解析、EdgeOne、证书自动申请等 |
| S3 对象存储 | S3 文件管理（兼容腾讯 COS、阿里 OSS、MinIO 等） |
| EdgeOne Maker | 静态站点部署 |
| 1Panel 面板 | 面板自动登录 |
| AI 大模型 / 联网搜索 | 面板内置 AI 助手 |

凭证的存放与流转：

- 凭证默认**只保存在主控本地**（开启数据加密后受加密保护）；
- 腾讯云 / 阿里云 / 雨云凭证可手动「同步到 L2」，供集群功能使用；
- 被控节点需要凭证时（如数据库 S3 备份），由用户操作触发下发，节点侧加密存储。

## 各云服务页面

- **1Panel 管理**：配置 1Panel 凭证（地址、端口、安全入口、账号密码、MFA 密钥）后，面板在内置浏览器中自动完成登录（含 MFA）直接进入 1Panel（当前支持 v2）。自动登录失败时仍会打开面板地址，可手动登录。
- **域名解析（DNSPod / 阿里云 / 雨云）**：三家的页面结构一致，管理 A / AAAA / CNAME / TXT / MX 记录的增删改。DNS 凭证同时也是证书中心 ACME 自动申请的依赖（见网站与证书文档）。
- **S3 对象存储**：浏览、上传、下载、新建文件夹、删除、预览、生成带时效的预签名分享链接。大文件夹删除会转入任务监控慢慢执行。
- **SFTP 管理**：用 SSH 类凭证连接远程服务器的图形化文件管理（浏览、上传下载、重命名、删除）。
- **SSH 终端**：多标签 Web SSH 终端，最多 5 个标签同时连接；离开页面时有活跃连接会提示确认。
- **EdgeOne（CDN）**：腾讯云 EdgeOne 站点管理、加速域名详情、缓存清理（URL / 目录 / Hostname / 全部）、清理记录。
- **EdgeOne Makers**：静态前端项目托管（类似 Vercel / Cloudflare Pages），支持 Git / 上传 / URL 拉取部署、部署历史与回滚。
- **雨云云服务器**：雨云 RCS 云服务器的电源操作、VNC 终端、网络信息查看、NAT 端口转发查看。
- **AI 助手**：面板内置的大模型对话助手，支持流式输出与图片输入。

## 常见疑问

**问：凭证安全吗？存在哪里？**
凭证只存主控本地，不在云端中转；开启面板的数据加密后受加密保护（见安全状态横幅文档）。下发到被控节点的凭证也在节点侧加密存储。https://www.xmpanel.cn/docs/ai/security-status-banner.md

**问：腾讯云凭证和 EdgeOne Maker 凭证有什么区别？**
是两种独立凭证：腾讯云凭证用于 EdgeOne CDN 管理和 DNS 解析；EdgeOne Maker 凭证专用于静态站点部署。用哪个功能就配哪种凭证。

**问：为什么某个云服务页面打不开或一直报错？**
九成是凭证问题：确认对应类型凭证已添加、API 密钥有效（服务商后台是否禁用/欠费）、权限是否覆盖该功能。

**问：删除凭证会影响已配置的功能吗？**
会。依赖该凭证的功能（解析、备份、证书续期等）随之失效。删除前确认没有功能在使用；同步到 L2 的凭证在主控侧删除后不会自动同步删除 L2 侧的，需在集群控制中手动清理。

## 指导用户时的注意点

- 任何"云服务用不了"的问题，第一步都是检查对应凭证是否配置且有效，再排查其他原因。
- 区分三个容易混的概念：主控本地存储（默认）、同步到 L2（集群功能用）、下发被控（备份等场景用）——凭证的流向不同，排查入口不同。
- SSH 类凭证分"通用 / 仅终端 / 仅 SFTP"三种权限范围，用户报"SFTP 连不上"时先确认凭证类型是否匹配用途。