在服务器上安装
Qubix 运行在您自己的服务器上——一条安装命令即可启动整个技术栈 （数据库、后端、Web 服务器及辅助组件）。您只需要一台全新的 Linux 服务器， 配备 SSH 访问权限和 Docker。
服务器要求
安装程序在启动前会检查服务器配置，如果机器资源明显不足则会拒绝继续。推荐最低配置：
| 资源 | 推荐最低配置 |
|---|---|
| CPU | 4 vCPU |
| RAM | 8 GB |
| 磁盘 | 20 GB SSD 或 HDD |
这些是安装程序推荐的配置值；低于这些值仍可运行，但会发出警告， 提示 ClickHouse 在流量高峰时会变慢。磁盘有一个硬性下限：10 GB 可用空间—— 低于此值安装将停止。
磁盘类型不影响流量服务速度——SSD 和 HDD 均可正常使用，选择 HDD 可节省费用；SSD 仅在大流量场景下加速管理面板中的报告。20 GB 足以入门：可容纳平台本身以及数千个创意素材，而流量历史几乎不占用空间。关于特定磁盘容量能支撑多少流量和多少创意素材，请参阅选择您的服务器。
几项硬性要求：
- 64 位 Linux 服务器（VPS/VDS 或独立主机），不能是个人电脑或共享虚拟主机。
- Docker 及
docker compose插件（V2）。旧版独立docker-compose（V1）不受支持——安装程序会检测并停止。 - 出站 HTTPS，以便服务器能拉取 Qubix 镜像。
请将 Qubix 安装在专属服务器上。该技术栈需要端口 80、443 （Cloudflare 选项还需要 8443）处于空闲状态。如果其他 Web 服务器已占用这些端口， 请先释放它们，或在向导后期选择 Cloudflare 选项。
安装
-
以 root 身份通过 SSH 连接到服务器。
-
运行安装命令：
Bashcurl -sSL https://qubix.pro/install.sh | bash（或使用
wget -qO- https://qubix.pro/install.sh | bash）
-
安装程序显示 Qubix 横幅，检查服务器，询问几个问题 （安装目录、使用哪个网络接口对外发布），然后拉取并启动技术栈。 请等待直到它报告一切正常运行。
请让安装程序完整运行。中途停止可能导致技术栈配置不完整—— 如果发生这种情况，最安全的恢复方法是删除安装目录，然后在全新服务器上重新运行命令。
安装后您将获得
安装程序会启动一组构成 Qubix 的容器：分析数据库、Qubix 后端、 Web 服务器，以及自动更新、证书和 AI 辅助组件。您无需手动管理这些容器——Qubix 会为您统一管理。
在浏览器中完成设置
技术栈启动后，安装程序会打印如下链接：
http://<your-server-ip>:7000/install?k=…
在浏览器中打开该完整链接（?k=… 密钥为必填项）。它将打开设置向导，
您可以在其中选择 Qubix 的访问方式、输入许可证，并创建第一位管理员。
设置向导仅在完成之前可访问。第一位管理员创建后，链接将停止工作——这是预期行为。 此后您可通过面板自身的地址登录。