# ONES 管理后台文档索引

URL: https://docs.ones.cn/deploy/configure/ones-admin/ones-admin-index

本文面向实施维护人员，用于快速跳转到 ONES 管理后台相关操作文档。

V7.6.0+ 版本支持管理后台功能，暂不支持外置数据库。

## 建议阅读顺序

首次开通或排查管理后台时，建议按下面顺序查看：

1. 先看 [打开管理后台](https://docs.ones.cn/deploy/configure/ones-admin/open-ones-admin/) ，确认基础配置和 IDS 登录正常。
2. 再看 [访问名单功能](https://docs.ones.cn/deploy/configure/ones-admin/ones-admin-access-users-usage/) ，确认维护人员账号可以进入管理后台。
3. 如果 IDS 登录不可用，再看 [紧急登录说明](https://docs.ones.cn/deploy/configure/ones-admin/ones-admin-emergency-login/) 。
4. 需要使用具体功能时，再进入对应功能文档。

## 基础配置

| 文档 | 适用场景 | 重点内容 |
| --- | --- | --- |
| [打开管理后台](https://docs.ones.cn/deploy/configure/ones-admin/open-ones-admin/) | 首次打开管理后台，或 IDS 回调地址异常时 | 配置 `baseURL` 、 `onesAdminBaseURL` 、 `onesInstallerAPINodePort` ，执行 `make setup-ones` 生效 |
| [打开管理后台监控功能](https://docs.ones.cn/deploy/configure/ones-admin/open-ones-admin-monitor/) | 需要在管理后台查看监控告警时 | 执行 `make setup-ones-telemetry` ，检查监控组件和页面入口 |

## 功能使用

| 文档 | 适用场景 | 重点内容 |
| --- | --- | --- |
| [巡检功能](https://docs.ones.cn/deploy/configure/ones-admin/ones-admin-inspect-usage/) | 查看环境健康评分、执行巡检、下载巡检报告 | 手动巡检、结果总览、异常筛选、历史和详情 |
| [数据备份功能](https://docs.ones.cn/deploy/configure/ones-admin/ones-admin-backup-usage/) | 查看备份状态、手动触发备份、确认备份结果 | 打开备份配置、手动备份、备份历史和备份文件检查 |
| [数据流功能](https://docs.ones.cn/deploy/configure/ones-admin/ones-admin-dataflow-usage/) | 查看数据链路状态、定位数据同步异常、执行重建 | `mysqlStatusServerEnable` 、链路详情、重建流程、异常处理 |
| [操作日志功能](https://docs.ones.cn/deploy/configure/ones-admin/ones-admin-auditlog-usage/) | 追溯管理后台关键操作，导出操作日志 | 时间范围筛选、CSV 导出、审计记录确认 |
| [访问名单功能](https://docs.ones.cn/deploy/configure/ones-admin/ones-admin-access-users-usage/) | 维护哪些用户可以进入管理后台 | 添加、停用、启用、删除管理员，容器内检查访问名单 |

## 应急和排障

| 文档 | 适用场景 | 重点内容 |
| --- | --- | --- |
| [紧急登录说明](https://docs.ones.cn/deploy/configure/ones-admin/ones-admin-emergency-login/) | IDS 不可用，但必须进入管理后台处理问题时 | 配置紧急账号、容器内验证、页面使用、使用后关闭 |
| [访问名单功能](https://docs.ones.cn/deploy/configure/ones-admin/ones-admin-access-users-usage/) | 登录后提示不在访问名单，或没有可用管理员时 | 检查 `admin_access_grant` ，恢复至少一个启用管理员 |
| [操作日志功能](https://docs.ones.cn/deploy/configure/ones-admin/ones-admin-auditlog-usage/) | 需要确认谁执行了某个管理后台操作时 | 查看 `admin_audit_logs` ，按时间和操作人排查 |

## 常用入口

管理后台页面入口：

```text
http://<管理后台访问地址>/ones-admin/
```

英文界面入口示例：

```text
http://<管理后台访问地址>/ones-admin/?locale=en-US#/inspect/overview
```

生产环境进入操作容器：

```sh
./ones-ai-k8s.sh
cd /data/ones/ones-ai-k8s
```