sourcepole/qwc-admin-gui

QWC Admin GUI

概述

QWC Admin GUI 是 QWC 服务生态系统的管理界面工具，旨在为 QWC 服务提供图形化管理能力。该界面通过直观的交互设计，帮助管理员简化 QWC 服务的配置、监控及运维操作，降低管理复杂度。

项目源代码及详细文档请参考：https://github.com/qwc-services/qwc-admin-gui

核心功能与特性

• 服务配置管理：提供可视化界面配置 QWC 服务参数，支持配置项的新增、编辑、删除及生效管理，无需手动修改配置文件。
• 实时状态监控：展示 QWC 各服务节点的运行状态、资源占用（如 CPU、内存）及关键指标，便于快速识别异常。
• 用户权限控制：支持管理后台用户账户及权限分配，可按角色划分操作权限，确保管理操作安全性。
• 日志集成：整合 QWC 服务日志查看功能，支持日志筛选、搜索及导出，辅助故障排查与审计。
• 操作便捷性：采用用户友好的界面设计，简化复杂操作流程，降低管理员学习成本。

使用场景与适用范围

• QWC 服务管理员：用于日常管理 QWC 服务集群，执行配置更新、节点扩缩容、服务启停等操作。
• 运维人员：在服务部署、升级或故障排查时，通过图形界面快速定位问题节点并执行修复操作。
• 开发与测试环境：开发人员调试 QWC 服务时，可通过界面快速调整配置参数，加速开发迭代。

使用方法与配置说明

前提条件

• 已安装 Docker 引擎（版本建议 ≥ 20.10）
• （可选）已安装 Docker Compose 用于编排部署
• 确保 QWC Admin GUI 与 QWC 服务集群网络连通

Docker 部署示例

1. 基础运行命令

bash
docker run -d \
  --name qwc-admin-gui \
  -p 8080:80 \  # 映射容器内80端口至主机8080端口
  --network qwc-service-network \  # 需与 QWC 服务在同一网络
  -e QWC_API_URL=http://qwc-api:5000 \  # QWC 服务 API 地址（示例）
  qwc-services/qwc-admin-gui:latest

2. Docker Compose 配置示例

yaml
version: '3.8'
services:
  qwc-admin-gui:
    image: qwc-services/qwc-admin-gui:latest
    container_name: qwc-admin-gui
    restart: unless-stopped
    ports:
      - "8080:80"
    networks:
      - qwc-network
    environment:
      - QWC_API_URL=http://qwc-api:5000  # QWC 服务 API 端点
      - ADMIN_USER=admin  # 管理员初始用户名（具体以项目文档为准）
      - ADMIN_PASSWORD_FILE=/run/secrets/admin_password  # 密码文件挂载（推荐）
    secrets:
      - admin_password
    depends_on:
      - qwc-api  # 依赖 QWC API 服务（示例）

networks:
  qwc-network:
    external: true  # 若已存在 QWC 服务网络，设为 true

secrets:
  admin_password:
    file: ./admin_password.txt  # 存储管理员密码的本地文件

关键配置参数

以下为常见配置参数（具体请参考项目 GitHub 文档）：

• QWC_API_URL：QWC 服务 API 地址，用于与后端服务通信
• ADMIN_USER：管理员登录用户名（初始账户）
• ADMIN_PASSWORD 或 ADMIN_PASSWORD_FILE：管理员密码（建议通过文件挂载避免明文）
• LOG_LEVEL：日志级别（可选值：DEBUG、INFO、WARN、ERROR，默认 INFO）

访问与使用

1. 部署完成后，通过浏览器访问 http://<主机IP>:8080
2. 使用配置的管理员账户（默认或自定义）登录
3. 根据界面指引进行服务配置、监控或权限管理操作

注意事项

• 生产环境中建议启用 HTTPS（可通过反向代理如 Nginx 配置）
• 定期更新镜像至最新版本以获取功能更新及安全修复
• 敏感配置（如密码、API 密钥）建议通过 Docker Secrets 或环境变量文件挂载，避免明文暴露
• 详细功能及配置项请以 GitHub 项目文档为准：https://github.com/qwc-services/qwc-admin-gui