HQbird 2027
HQbird 2027
一屏掌握 Firebird 服务器的全部信息。备份通过恢复验证。一个监控中心管理所有服务器。复制和 AI 助手,危险操作由人确认。
- Firebird 5 · 4 · 3 · 2.5
- Windows 和 Linux x86-64
- 100% 兼容 Firebird
- 服务器要求:2+ GB 内存 · 2+ 核 · 5+ GB 磁盘
- 0 个入站端口即可连接中心
概述
四个核心理念
无需打开服务器控制台
Firebird 和操作系统的完整诊断。一台服务器或一组服务器,本地或 HQCenter 中,统一界面呈现。
所有服务器集中一处
数据库服务器无需入站端口即可连接中心。代理自行从 HQCenter 获取 Firebird 和 HQbird 工具的新版本并安装,且可回滚到上一版本。
多节点复制
主库、副本、延迟和数据校验尽在一个界面。主库可迁移到另一台主机而不丢失数据,应用程序无需更改连接字符串。
人类掌控下的 AI 助手
可与 AI 聊天和自主 AI 代理协作。操作按危险等级划分。每次变更都由人确认。危险操作仅在服务器上通过第二通道确认,而非在聊天中:使用 fbmcp ctl approve 命令,或在 Windows 上通过托盘窗口确认。
高级服务器级功能
查看全部- 轻量级监控 (LWM)每分钟采集服务器上所有数据库的性能数据,且不产生额外负载。即 fblwmon 插件。
- 更新冲突与死锁独立的跟踪机制可捕获 SQL 执行期间的冲突。
- 负载下重新初始化副本主库不会停止。副本的数据库副本会自动创建,并检查可用空间和长事务。在 vanilla Firebird 中,这需要手动操作。
- 切换与故障转移计划内将主库迁移到另一台主机,不丢失数据。也可手动或按规则进行紧急迁移。路由器会将应用程序引导至当前主库。在 vanilla Firebird 中,这需要手动操作。
- NGram 索引用于 Firebird 5 HQbird 中的
WHERE … LIKE '%found%'。 - 指标导出到 Prometheus在您的 Grafana 中查看 Firebird 和服务器指标。
界面新增功能
- 所有性能集中在一个屏幕CPU、内存和磁盘:总计与 Firebird 分别显示,包括存放数据库和临时文件的磁盘。一次性查看所有数据库的 Firebird 指标。
- 完整的备份清单服务器上的所有备份,包括由其他程序创建的备份。可发现丢失的数据库副本和备份。
组件
- fbagent
- Firebird 服务器上的代理:备份、维护、指标、跟踪。
- HQ Monitor
- Web 控制台。可本地管理单台服务器,也可在中心管理多台服务器。
- HQCenter
- 服务器集群的管理中心。
- HQbird Cluster
- 复制:节点和集群管理器 (RCM)。
- HQbird MCP
- 面向 AI 助手的 MCP 服务器。
DBA 能获得什么
- 经过还原验证的备份;可直接传到 S3,并支持压缩。
- 每日服务器健康报告;可直接从报告启动操作。
- 带检查与自动回滚的 Firebird 更新。
- 回答“是什么在占用磁盘、CPU 和内存”。
开发者能获得什么
- 按执行计划分组的最昂贵查询。
- 包含应用程序、地址和 Firebird 函数的 SQL 错误。
- SQL 执行期间的冲突和死锁。
- IDE 中的 AI 助手:查询计划、索引建议、迁移。
IT 经理能获得什么
- 面向整个服务器集群的统一监控中心;连接它无需入站端口。
- 带投递状态的远程设置;带自动回滚的更新。
- 适用于 Firebird 4 和 5 以及 HQbird 2.5 和 3.0 的复制,并带延迟控制。
- 按服务器划分的访问权限和审计日志。
详细说明
功能分组
共九组:HQbird 能做什么以及为什么有帮助。截图来自 HQ Monitor 和 HQbird RCM 用户指南。服务器和数据库名称已通过演示模式隐藏。
备份只有在能够还原时才有用。在 gbak 任务中开启测试还原,代理就会还原每一个新备份,并将结果写入任务历史。如果还原失败,您当天就能看到,而不是等到崩溃那天。对于 nbackup,有单独的还原任务。
备份可以直接传到 S3,无需在服务器磁盘上生成中间文件。单独的 file_sync 任务可将副本复制到 S3、FTP 和 FTPS。压缩格式为 zip、gz 或 zstd;gbak 备份的 zip 归档可以加密 (AES-256)。只有在归档验证通过后才会删除源文件。旧副本按每个 nbackup 级别的保留规则删除。
- 1gbak 或 nbackup按计划执行;可针对单个数据库或指定路径中的所有数据库
- 2测试还原gbak 任务选项;备份会被真正还原
- 3压缩zip、gz、zstd;检查后删除源文件
- 4存储文件夹或流式传输到 S3;file_sync 将副本复制到 S3 和 FTP/FTPS
- 5✓ 已验证结果记录在任务历史和健康报告中
替换周期:从备份重建数据库
大型数据库会随时间产生碎片并积累“垃圾”。替换周期会创建备份,将其还原到中间文件,然后替换生产数据库。按计划执行,无需手动夜间操作。
生产数据库会安全下线:代理将其置于关闭状态,所有连接关闭,然后才重命名文件。替换前,代理会检查还原后数据库的大小。不允许使用危险的 gbak 开关。您可以在周期前后运行自己的脚本。
如果断电或重启中断了周期,代理会自行回滚或完成它。如果需要人工介入,结果会明确说明:需要操作员。
- 组作业给定路径中的所有数据库,无论是否包含子文件夹,都在一个作业中。如果某个数据库有自己同类型(gbak 或 nbackup)的作业,组作业不会复制它。
- 多级 nbackup通过简单计划、cron 或计划表执行 0…4 级。计划表显示在编辑器日历中。按级别或按整个周期保留。
- 清单所有备份文件,包括由其他工具创建的备份文件。显示哪个数据库没有新副本。
- 控制台中的 gbak 日志作业显示最后几行日志及其执行的命令历史。无需在服务器上查找文件。
- 从 S3 还原自动检测归档格式,本地和 S3 中均可。
- 过载保护每个数据库一次只执行一个重操作。如果数据库繁忙,gbak 最多等待 60 分钟。
代理每 10 分钟对服务器状态进行一次快照:CPU、内存、磁盘、操作系统限制、firebird.log、事务、锁、查询、备份和复制。健康报告以矩阵形式显示 24 小时、7 天或 14 天的情况。红色单元格会立即告诉你问题发生的位置和时间。
每个发现都会解释原因并给出提示。旁边有一个按钮,可打开相应作业或启动它。从“发现”到“修复”只需一个屏幕。
- 1发现“数据库没有新备份”
- 2提示应设置什么,包括阈值和值
- 3操作按钮“添加 nbackup 作业”
- 4立即运行从控制台启动并观察进度;排队中的运行可以取消
- 5✓ 已修复下一次快照为绿色
是什么在给服务器增加负载:Firebird 还是其他程序
数据库变慢往往不是 Firebird 的错。杀毒软件、其他程序的备份或相邻服务会占用磁盘和 CPU。HQ Monitor 按程序和服务显示负载:读取和写入、CPU、内存。
对于磁盘,你可以看到读写延迟、IOPS 和磁盘“停顿”。分别显示数据库所在磁盘和 Firebird 临时文件所在磁盘。
- 轻量级监控 (LWM)每分钟记录连接、事务、读取和写入,无痕运行。
- 事务OIT/OAT/OST 差距和长事务:在数据库开始变慢之前发出信号。
- 来自数据库头的状态关闭、只读、sweep、nbackup 模式。指标收集器不会连接到处于关闭状态的数据库。
- 带趋势和预测的 gstat表和索引的增长,导出到 XLSX。
- Linux 限制TasksMax、NPROC、NOFILE、OOM、threads-max。“Firebird 在高负载下崩溃”的常见原因在崩溃前即可看到。
- 可用空间和临时文件磁盘满之前发出警告。
- firebird.log 和 replication.log带过滤器,所有服务器集中在一个控制台中。线程创建错误和已删除的锁文件会被高亮显示。
- 配置历史firebird.conf、databases.conf、replication.conf 的版本及差异对比。
- Prometheus / Grafana将指标导出到您现有的监控系统。
Sweep、索引统计重算、gfix 检查和您的 SQL 脚本按计划运行。对于 sweep 和 SQL 脚本,您可以设置维护窗口。默认情况下,组 sweep 有一个窗口(00:15–01:15),SQL 脚本也有一个(03:00–04:00)。同一时间每个数据库只运行一个重负载操作。Sweep、gfix 检查和索引重算会跳过繁忙的数据库,直到下一次运行。
Firebird 更新现在也是一项常规操作。代理会等待更新窗口以及其他任务(gbak、nbackup、脚本)完成。然后它停止 Firebird,替换文件并检查引擎。旧文件保留在更新备份中。如果检查失败,代理会自行恢复之前的版本。
- 1更新窗口仅在允许的时间更新
- 2等待任务gbak、nbackup 和 SQL 脚本完成
- 3替换文件Firebird 已停止;旧文件进入更新备份
- 4检查Firebird 正在运行并响应
- 5✓ 完成或自动回滚
在此服务器上被回滚的构建会被阻止。在有人移除阻止之前,代理不会再次安装它。
- 立即运行一键执行备份、恢复、sweep 或检查,本地或远程均可。您可以看到进度。排队或等待中的运行可以取消。
- 服务器性能测试在硬件、磁盘或设置变更前后建立基线。
- databases.conf 编辑器别名树、针对引擎版本的参数检查、拼写错误提示、保存前备份。从中心:随代理回复一起下发;在表单中编辑会保留注释。
- 从 FBDataGuard 迁移旧 HQbird 的设置会自动导入。
- 从操作系统软件包版 Firebird 迁移安装程序会找到来自 apt 或 dnf 的 Firebird 并打印迁移命令。用户和别名会迁移到 HQbird。
- 无需重启的更改新设置会被检查;出错时代理会恢复到之前的设置。
开发者无需服务器访问权限,就能知道应该优先优化哪个查询。性能报告基于跟踪构建,并按执行计划对查询分组。您可以按持续时间、读取次数、读和写对查询排序。
SQL 错误会附带应用程序名称、IP 地址以及发生错误的 Firebird 函数。对于 SQL 执行期间的更新冲突或死锁,您可以看到双方的语句。单独的跟踪会捕获它们。它会记录所有修改语句,因此会增加自身的负载。
数据库如何变化
gstat 按计划运行。趋势报告比较快照,显示哪些表和索引增长最快,并做出预测。索引统计会找出不活跃的索引和选择性差的索引。gstat 报告的“链接”选项卡显示哪些查询读取了某个索引。
元数据跟踪默认关闭;您可以在设置中开启。代理每 6 小时将新的架构导出与上一次比较,并记录架构变更的时间。
- 长事务哪个连接持有事务并阻止垃圾回收。
- 客户端版本哪些版本的 fbclient 和驱动程序连接到数据库。
- 性能报告:比较与历史 新十种查询排名、存储过程和触发器、按小时统计的执行次数。两个时间段的比较以及单个查询 30 天的历史。
- 按需报告 新“生成报告…”按钮可为最长 24 小时的任意时间段生成报告,支持按数据库、持续时间和程序筛选。
- 本地 API(REST)从您自己的脚本和 CI 获取状态、指标和任务运行情况。
- IDE 中的 AI 助手通过 HQbird MCP:查询计划、索引建议、架构比较、迁移,直接在 Cursor 或 Claude Code 中使用。
代理通过出站 HTTPS 自行将数据发送到中心。数据库服务器无需开放入站端口即可连接到中心;所有流量均通过 mTLS 传输。这也适用于位于 NAT 和防火墙之后的客户服务器。
设置从中心进行更改。代理获取新配置,检查后回复。对于每项更改,你都能看到投递状态以及被拒绝的原因。在替换设置之前,代理会保存旧设置的副本。
- 1在控制台中进行更改作业或设置表单
- 2SENT已保存在中心;代理尚未获取
- 3TAKEN代理已获取并正在检查
- 4APPLIED已应用;或 REJECTED 并附原因
- 来自中心的更新代理和产品更新时会进行签名校验并支持自动回滚。
- 中心自行更新在维护窗口内进行,带签名校验和自动回滚。由 IBSurgeon 开启;中心所有者可以禁止此操作。
- 关于新问题的邮件或 webhook以及整个集群的每周报告。此功能由中心管理员开启。
- 代理保护服务器如果某个代理任务占用过多内存或 CPU,代理会暂停或停止该任务。它不会影响备份和数据发送。
- 用户和访问权限按服务器划分;更改设置、运行作业和执行危险操作分别有独立权限。审计日志。
- 5 种界面语言英语、俄语、德语、葡萄牙语(巴西)、西班牙语。
主节点将复制日志段发送到副本。集群管理器(RCM)监控所有节点:延迟、队列、错误。一个副本可以接收来自多个主节点的数据库。支持 Firebird 4 和 5 以及 HQbird 2.5 和 3.0。
新副本通过 nbackup 创建,无需停止主节点,且可在负载下进行。启动前,RCM 和各节点会检查可用空间。主节点会等待长事务完成。
你可以将主节点迁移到另一台主机。Switchover 按计划执行且不会丢失数据:RCM 自行停止写入,等待副本,并将旧主节点作为副本重新上线。当主节点主机丢失时,需要执行 Failover。应用程序主机上的路由器始终将应用程序发送到当前主节点。
控制与安全
RCM 可识别 20 多种告警类型,每种告警都有相应的处理说明。数据检查会比较主节点和副本上每张表的行数。你可以在设置中开启定期检查。主节点的 Firebird 绝不会被自动重启;副本仅在允许的情况下才会重启。
Switchover 和 failover 按步骤执行。在不可返回点之前,出现错误或取消操作都会使旧主节点重新上线。自动 failover 默认关闭;你需要为每个服务单独开启,并且需要见证路由器。
对于没有服务的数据库,手动方式仍然可用:“提升为主库”会在数据库行中显示每个步骤。如果某个步骤停止,您可以重复执行该步骤。
节点通过 mTLS 与共享 CA 通信。证书自动续期;密钥永远不会离开主机。
- 切换 新在 RCM 中一键或一条命令即可有计划地迁移主库。不会丢失数据。旧主库会自动作为副本回归。
- 故障转移 新主库主机丢失:副本接管主库角色。可手动执行,需明确同意数据丢失,或按服务规则执行。
- 路由器 新应用程序主机上的 HAProxy。主库变更后,连接字符串保持不变。
- 副本文件移动无需重新初始化;出错时回滚。
- 暂停与恢复暂停后,传输从最后一个段继续,无需重新初始化。
- 三步完成集群设置 新在一台主机上开启 RCM,在其他主机上打开配对窗口,在“链接主机”页面上链接主机。
- Firebird 挂起 新节点每分钟自行连接数据库。端口开放但数据库无响应:严重警报。
- 批量参数更改为多个节点设置复制参数,支持预览。
- 表发布为 Firebird 4 和 5 包含、排除和控制发布。
HQbird MCP 将 Firebird 连接到 AI 助手:Claude Desktop、Claude Code、Cursor、Codex 及其他 MCP 客户端。超过 120 个工具,支持 Firebird 2.5–5,以及 fbagent 代理的全部数据。
核心规则:始终由人决定。读取无需确认,在只读事务中运行。每次更改都需要确认。危险操作仅在服务器上通过第二通道确认,而非在聊天中:使用 fbmcp ctl approve 命令,或在 Windows 上通过托盘窗口确认。AI 无法自行确认这些操作。
fbmcp ctl approve 确认。需要打开维护窗口。数据库替换、独占窗口和危险 SQL 还需要不超过 24 小时的已验证备份。- 1助手请求“从备份替换数据库”
- 2fbmcp 检查级别级别 2:窗口已打开,备份已验证
- 3服务器上的人员使用
fbmcp ctl approve批准 - 4执行附带将更改内容的预览
- 5✓ 日志记录哈希链;一条命令即可验证
- 面向 DBA会话、OIT/OAT/OST 事务、gstat、LWM、firebird.log;备份和测试恢复;sweep、验证;用户和权限,带 SYSDBA 锁定保护;从模板创建跟踪。
- 面向开发人员查询计划和索引建议并附带复核;查询编译检查;结果以表格形式直接显示在聊天中;架构和数据比较;带回滚计划的迁移。
- 现成场景健康检查、优化、安全审计、DDL 审查、迁移计划、灾难就绪。
- fbagent 数据健康报告、LWM、gstat、性能、死锁、备份。助手可运行作业并更改其设置;但不能更改凭据。
- 集群 新助手通过 RCM 构建复制集群:打开配对窗口、链接主机、添加数据库并检查副本。它还可以启动切换和故障转移;由人员在服务器上确认。
- 远程模式助手在管理 PC 上,MCP 服务器在数据库服务器上。HTTPS、每人单独的 API 密钥、地址允许列表。密码和数据库路径不会进入聊天。
- 已包含HQbird 安装程序会安装它,代理会更新它。在 Linux 上,未签名的构建不会被安装。
一条命令即可安装 Firebird 2.5–5 以及代理、控制台和 MCP 服务器。支持 Windows 和 Linux,x86-64。安装程序为新 Firebird 和 HQ Monitor 打开防火墙端口:在 Windows 中,firewalld 或 ufw。集群端口仅在服务器上开启 RCM 或配对窗口时才会打开。您可以先查看安装计划:该命令会显示将要执行的操作,不会做任何更改。
- 一台服务器上运行多个 Firebird 实例新实例安装在现有实例旁边,使用空闲端口,并拥有自己的代理。已安装的实例不会改变。
- 变更前先检查安装计划和配置检查会提前显示问题。
- 支持 8 种语言的 Windows 安装向导 新英语、葡萄牙语、德语、俄语、西班牙语、波兰语、土耳其语、中文。
- 云和 Docker 新每个 Firebird 系列都有现成镜像:Firebird、代理和 HQ Monitor 在一个容器中。备份直接发送到 S3。更多。
- Linux:最小权限代理以 firebird 用户运行;root 只运行经过验证的脚本。
- 密码和密钥受到保护在控制台中输入的密码、令牌和访问密钥(例如用于 S3 的密钥)会用代理密钥加密。它们会在报告和配置快照中被隐藏。
- 签名的自更新代理不会安装签名错误的构建。在 Linux 上不会安装未签名的构建。具有降级保护,更新失败时会回滚。
- 无需 HQCenter 的更新 新没有中心的服务器会自行从 IBSurgeon 更新服务器获取更新:代理、HQ Monitor 和 MCP 服务器会自动安装,Firebird 软件包则等待你的命令。
- 安全数据库中的权限存在哪些用户以及谁可以创建数据库;私有安全数据库通过 databases.conf 查找。你可以直接在 HQ Monitor 中创建新用户。
- 封闭网络HQ Monitor 无需互联网即可工作。
- 演示模式隐藏服务器名称、数据库名称和路径,因此你可以安全地截图。本页所有截图都是这样拍摄的。
- 服务器所有者掌控一切可以在服务器本身上关闭远程命令。发送其他程序和服务名称也是如此。
- 代理请求日志每个更改服务器的请求以及每次拒绝,都会在服务器日志中记录为一行。不会写入机密和设置值。保留 30 天。
HQbird 在云服务器上的工作方式与在你自己的服务器上相同。对于 Docker,每个 Firebird 系列都有现成镜像:Firebird、代理和 HQ Monitor 在一个容器中。
数据位于卷上,当你替换容器或镜像时数据会保留。代理会自行连接到 HQCenter,因此云中的服务器不需要为连接到中心开放入站端口。
- 4 个镜像Firebird 5、4、3 和 2.5。这些镜像是公开的:你无需登录注册表。
- 一条命令即可首次启动
docker compose up -d:容器会自行安装 HQbird。 - 一台主机上运行多个实例每个实例都有自己的端口和卷。一个无负载的实例使用约 200–250 MB 内存。
- 更新从 HQCenter 或使用新镜像。两种方式都会保留数据。
- 容器中的集群实例加入集群的方式与服务器相同。
- 备份到 S3备份直接发送到存储桶,磁盘上不保留文件。更多。
须知
- 集群中的自动故障转移默认关闭。你需要为每个服务单独开启,并且它需要路由器。手动故障转移始终需要明确同意数据丢失。
- HQ Monitor 没有自己的警报,也没有 Telegram。中心会发送关于问题的电子邮件和 webhook;中心管理员会开启此功能。
- MCP:危险操作会在服务器上通过
fbmcp ctl approve确认。HQbird 安装程序不会安装托盘窗口。 - MCP:聊天中的结果表格仅在支持 MCP Apps 的客户端中有效。