d4software/querytree

QueryTree 镜像文档

概述和主要用途

QueryTree 是一款适用于 Microsoft SQL Server、PostgreSQL 或 MySQL 数据库的临时报表工具。它允许用户在无需编写代码的情况下查询数据库、构建报表，并安排报表自动发送至电子邮件分发列表，简化数据报表的生成与分发流程。

核心功能和特性

• 多数据库兼容：支持连接 Microsoft SQL Server、PostgreSQL 及 MySQL 数据库，满足多样化数据环境需求。
• 安全连接机制：可通过 SSH 隧道连接 MySQL 和 PostgreSQL 数据库，支持密码或密钥文件进行安全验证，保障数据传输安全。
• 自定义配置：支持自定义应用内的徽标图像、系统名称及 CSS 样式，可根据企业需求调整界面外观。
• 灵活数据存储：可选择 Sqlite 或 Microsoft SQL Server 数据库存储自身的用户信息和报表数据，适配不同部署场景。
• 加密数据保护：数据库和 SSH 密码采用 AES 加密方式存储于系统数据库中；用户可提供自定义密钥文件，或由系统在首次运行时自动生成；密钥支持在负载均衡架构中实现多 Web 服务器间共享，确保分布式部署下的数据一致性。

使用场景和适用范围

• 非技术用户：数据分析人员、业务人员等无需编程知识即可快速生成临时报表，降低技术门槛。
• 企业定制化需求：需要自定义品牌标识（如徽标、系统名称）的企业内部应用场景，提升品牌一致性。
• 分布式部署环境：适用于单服务器部署或多 Web 服务器负载均衡场景，支持密钥共享以确保加密数据跨服务器兼容。

配置说明

数据库连接配置

• SSH 隧道连接：连接 MySQL 和 PostgreSQL 时，可通过配置 SSH 隧道实现安全访问，支持密码验证或密钥文件验证两种方式。
• 数据存储选择：系统自身的用户及报表数据可存储于 Sqlite（轻量部署）或 Microsoft SQL Server（企业级部署），需在部署时指定对应数据库连接信息。

自定义界面配置

• 品牌元素定制：通过替换徽标图像文件、修改系统名称参数及自定义 CSS 样式表，调整应用界面的视觉呈现，适配企业品牌规范。

加密密钥管理

• 密钥生成与配置：首次运行时，系统可自动生成 AES 加密密钥；用户也可通过挂载外部密钥文件进行自定义配置，密钥文件路径需在部署时明确指定。
• 负载均衡适配：在多 Web 服务器负载均衡场景中，需确保所有服务器共享同一密钥文件，以保证加密数据的正常解密与访问。

Docker 部署示例

bash
# 基础部署命令（示例，具体参数需根据实际环境调整）
docker run -d \
  --name querytree \
  -p 8080:80 \  # 端口映射（主机端口:容器端口）
  -v /path/to/custom-key:/app/encryption.key \  # 挂载自定义密钥文件（可选，未指定则系统自动生成）
  -v /path/to/custom-assets:/app/assets \  # 挂载自定义资源（徽标、CSS等，可选）
  -e STORAGE_DATABASE="sqlserver" \  # 指定数据存储类型（sqlite/sqlserver，默认sqlite）
  -e STORAGE_CONNECTION="sqlserver://user:password@sqlserver-host:1433/querytree_db" \  # 数据存储数据库连接字符串（当STORAGE_DATABASE为sqlserver时必填）
  querytree:latest

注意：上述命令为基础示例，实际部署时需根据网络环境、数据存储需求及安全策略调整端口映射、挂载路径及环境变量参数。