跳到主要内容

系统

这是面向管理员的技术板块。共有五个选项卡:更新Geo/cloak 数据库JavaScript水印。在这里您可以更新 Qubix 版本、管理 geo/cloak 数据库、添加自己的 Web 服务器配置,并设置防护限额。

带有各选项卡的«系统»板块

更新

该选项卡显示当前版本,并允许您将系统更新到所需的发行版。

顶部有两张版本卡片:

  • qubixd binary — Qubix 可执行文件的版本(构建号、构建日期、数据架构版本)。
  • live container — 正在运行的容器的版本(标签和镜像、更新程序版本)。

如果二进制文件版本与容器标签不匹配,会出现警告:这通常意味着该容器是在标准更新流程之外启动的,下一次更新会将其覆盖。

如何执行更新

  1. 启动更新 区块中,输入目标版本——例如 1.1.2,或输入 latest 以获取最新版本。 版本输入框和«更新»按钮
  2. 点击 更新
  3. 观察进度:系统会拉取新镜像、停止旧版本、启动新版本并检查其健康状况。各阶段以列表形式显示,完成后您可以展开详细日志。

如果新版本的健康检查失败,Qubix 会自动回滚到先前的容器——无需手动操作。

请勿中断更新

更新进行期间,请勿重启服务器或手动停止容器。自动回滚仅针对正常的健康检查失败而设计。如果回滚也失败(极其罕见的情况),则需要管理员在服务器上手动干预。

主机资源

在版本卡片下方,Qubix 会显示服务器资源的实时快照。该数据在后台采集并自动刷新,页面始终反映当前状态。

  • 磁盘可用空间 — 存储数据的磁盘剩余空间。
  • 可用内存 — 服务器的可用 RAM。
  • Qubix 进程内存 — Qubix 进程本身占用的 RAM。便于判断是 Qubix 在消耗内存,还是服务器上的其他程序所致。
  • 交换空间 (swap) — Qubix 进程使用的 swap 量。正常情况下此值为零;若出现明显数值,说明服务器 RAM 已不足并开始将数据换出至磁盘,这会导致整体性能下降。
  • CPU 负载 — 过去 5 分钟的处理器平均负载,相对于核心数。

«更新»选项卡上的«主机资源»面板

某一指标仅在服务器能够采集时才会显示;在部分环境下,特定指标可能不可用,届时将被隐藏。

资源告警

Qubix 不仅会显示这些数据,还会自行监控,并在出现异常时向技术频道发送 Telegram 告警

  • 磁盘空间不足(另有单独的严重告警,当空间极度紧张时触发);
  • 可用内存不足(同样有单独的严重告警);
  • Qubix 进程开始使用 swap;
  • 处理器持续高负载。

即使您未打开此页面,也能在实例出现问题前得到通知。为避免告警过多,短暂的波动不会触发告警,相同的警告也不会频繁重复发送。当指标恢复正常后,Qubix 会发送恢复通知。

技术频道由管理员在连接 → Telegram中配置。若未配置,告警将无处发送。

留意 swap 使用情况

Qubix 进程不应进入 swap。若 交换空间 (swap) 显示非零值(或您收到 swap 告警),说明服务器内存不足——请增加 RAM。在 swap 中运行会导致整体性能明显下降。

Geo/cloak DBs

用于检测和 cloaking 的 geo 和 cloak 数据库。该选项卡有两种更新模式:

  • 自动更新 — 按计划从授权服务器拉取数据库。您可通过 每隔更新 字段(以小时为单位)设置拉取频率。
  • 手动更新 — 关闭计划任务;数据库仅通过 立即更新 按钮更新。

下方是 数据库状态(每个数据库及其当前状态和大小)以及 更新历史 ——更新运行的日志,包含时间、数据库、状态、触发方式(计划或手动)、大小和消息。

带有模式切换和数据库状态的«Geo/cloak DBs»选项卡

JavaScript

用户脚本的限额。这些设置会即时生效,并同时应用于所有脚本。它们被分为几个区块:

  • Fetch — 脚本对外发起 HTTP 请求的规则:
    • 主机允许列表 — 允许的地址列表,每行一个。如果列表为空,则禁用脚本的对外请求。
    • Default timeoutMax timeout — 请求的默认超时和最大允许超时(以毫秒为单位)。
    • Max body — 响应的最大大小(以字节为单位)。
    • 每次运行最大调用数 — 单次脚本运行允许的对外请求数量。
  • RuntimeMax script runtime:单个脚本的最长执行时间(以毫秒为单位)。
  • SQL — 脚本对数据查询的限额:每次运行的查询数量、每次查询的行数、超时。查询以只读方式运行,并在脚本所有者的权限范围内执行。
  • 内存 — 内存限额;即将推出,目前尚不可用。

编辑后,请点击 保存

带有 Fetch、Runtime、SQL 区块的 JavaScript 选项卡

注意

allowlist 中的星号 * 会让脚本能够访问任何地址,包括内部地址。请谨慎使用——这是管理员的责任。

Watermark

水印移除工具的限额。它们为上传图片的大小设定上限——以此保护服务器免受内存过载。超出限额的图片会在被处理之前就被拒绝。

  • Max megapixels — 图片的最大面积(宽度乘以高度)。
  • Max side — 任一边的最大长度(以像素为单位)。

编辑后,请点击 保存。每个字段下方都有一条提示,说明推荐值。

带有两个限额字段的«Watermark»选项卡

接下来