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

更新
该选项卡显示当前版本,并允许您将系统更新到所需的发行版。
顶部有两张版本卡片:
- qubixd binary — Qubix 可执行文件的版本(构建号、构建日期、数据架构版本)。
- live container — 正在运行的容器的版本(标签和镜像、更新程序版本)。
如果二进制文件版本与容器标签不匹配,会出现警告:这通常意味着该容器是在标准更新流程之外启动的,下一次更新会将其覆盖。
如何执行更新
- 在 启动更新 区块中,输入目标版本——例如
1.1.2,或输入latest以获取最新版本。
- 点击 更新。
- 观察进度:系统会拉取新镜像、停止旧版本、启动新版本并检查其健康状况。各阶段以列表形式显示,完成后您可以展开详细日志。
如果新版本的健康检查失败,Qubix 会自动回滚到先前的容器——无需手动操作。
更新进行期间,请勿重启服务器或手动停止容器。自动回滚仅针对正常的健康检查失败而设计。如果回滚也失败(极其罕见的情况),则需要管理员在服务器上手动干预。
主机资源
在版本卡片下方,Qubix 会显示服务器资源的实时快照。该数据在后台采集并自动刷新,页面始终反映当前状态。
- 磁盘可用空间 — 存储数据的磁盘剩余空间。
- 可用内存 — 服务器的可用 RAM。
- Qubix 进程内存 — Qubix 进程本身占用的 RAM。便于判断是 Qubix 在消耗内存,还是服务器上的其他程序所致。
- 交换空间 (swap) — Qubix 进程使用的 swap 量。正常情况下此值为零;若出现明显数值,说明服务器 RAM 已不足并开始将数据换出至磁盘,这会导致整体性能下降。
- CPU 负载 — 过去 5 分钟的处理器平均负载,相对于核心数。

某一指标仅在服务器能够采集时才会显示;在部分环境下,特定指标可能不可用,届时将被隐藏。
资源告警
Qubix 不仅会显示这些数据,还会自行监控,并在出现异常时向技术频道发送 Telegram 告警:
- 磁盘空间不足(另有单独的严重告警,当空间极度紧张时触发);
- 可用内存不足(同样有单独的严重告警);
- Qubix 进程开始使用 swap;
- 处理器持续高负载。
即使您未打开此页面,也能在实例出现问题前得到通知。为避免告警过多,短暂的波动不会触发告警,相同的警告也不会频繁重复发送。当指标恢复正常后,Qubix 会发送恢复通知。
技术频道由管理员在连接 → Telegram中配置。若未配置,告警将无处发送。
Qubix 进程不应进入 swap。若 交换空间 (swap) 显示非零值(或您收到 swap 告警),说明服务器内存不足——请增加 RAM。在 swap 中运行会导致整体性能明显下降。
Geo/cloak DBs
用于检测和 cloaking 的 geo 和 cloak 数据库。该选项卡有两种更新模式:
- 自动更新 — 按计划从授权服务器拉取数据库。您可通过 每隔更新 字段(以小时为单位)设置拉取频率。
- 手动更新 — 关闭计划任务;数据库仅通过 立即更新 按钮更新。
下方是 数据库状态(每个数据库及其当前状态和大小)以及 更新历史 ——更新运行的日志,包含时间、数据库、状态、触发方式(计划或手动)、大小和消息。

JavaScript
用户脚本的限额。这些设置会即时生效,并同时应用于所有脚本。它们被分为几个区块:
- Fetch — 脚本对外发起 HTTP 请求的规则:
- 主机允许列表 — 允许的地址列表,每行一个。如果列表为空,则禁用脚本的对外请求。
- Default timeout 和 Max timeout — 请求的默认超时和最大允许超时(以毫秒为单位)。
- Max body — 响应的最大大小(以字节为单位)。
- 每次运行最大调用数 — 单次脚本运行允许的对外请求数量。
- Runtime — Max script runtime:单个脚本的最长执行时间(以毫秒为单位)。
- SQL — 脚本对数据查询的限额:每次运行的查询数量、每次查询的行数、超时。查询以只读方式运行,并在脚本所有者的权限范围内执行。
- 内存 — 内存限额;即将推出,目前尚不可用。
编辑后,请点击 保存。

allowlist 中的星号 * 会让脚本能够访问任何地址,包括内部地址。请谨慎使用——这是管理员的责任。
Watermark
水印移除工具的限额。它们为上传图片的大小设定上限——以此保护服务器免受内存过载。超出限额的图片会在被处理之前就被拒绝。
- Max megapixels — 图片的最大面积(宽度乘以高度)。
- Max side — 任一边的最大长度(以像素为单位)。
编辑后,请点击 保存。每个字段下方都有一条提示,说明推荐值。
