Cloud Blox文档
开始部署

快速开始

本文用最短路径带你从零跑通 Cloud Blox：安装服务端 → 登录管理后台 → 创建存储桶并上传文件 → 用客户端或 S3 工具访问。每一步只保留关键动作，完整说明见各步骤中的链接。

1. 准备环境

一台 Linux 服务器（2GB 内存起，推荐 4GB+），安装好 Docker 20.10+ 与 Docker Compose。MySQL / Redis / ClickHouse 由安装脚本通过 Docker 自动部署，无需提前安装。详见 安装教程 · 环境要求。

2. 安装服务端

获取与服务器 CPU 架构一致的安装包（amd64 或 arm64），解压后运行一键安装脚本：

Shell
tar -xzf cloud-blox-install-<版本>-linux-<架构>-<发行版>.tar.gzcd cloud-blox-install-<版本>-linux-<架构>-<发行版># 交互式安装（推荐首次安装）bash install.sh# 或全默认值自动安装bash install.sh --yes

脚本会先校验安装包与本机架构是否一致，再自动完成数据库选型、端口配置、编排文件生成与服务启动。安装结束时会打印管理员初始密码（仅显示一次），请务必保存。完整选项与配置项说明见 安装教程。

3. 登录管理后台

浏览器打开 http://<服务器IP>:38002（端口以实际配置为准），使用 admin 与初始密码登录，首次登录必须修改密码。界面结构与菜单说明见 后台管理入门。

4. 创建通道与存储桶

  1. 通道管理（系统管理 → 通道管理）：新增一个存储通道（本地磁盘、S3 兼容、各云厂商对象存储等 13+ 种类型），作为文件的实际落盘位置。
  2. 存储桶（对象存储 → 存储桶列表）：创建存储桶并分配通道，随后即可在存储桶详情中上传、下载与管理文件。

详见 通道管理 与 存储桶与文件。

5. 通过协议或客户端访问

6. 生产部署建议

  • 公网部署用 Nginx / Caddy 终止 TLS，并按 Host 分发到各入口端口，见 Nginx 反向代理（也可在管理后台「区域管理 → 服务端配置」按区域生成配置）。
  • 多机房 / 多地域场景可增加区域节点，见 区域节点部署。
  • 用量与计费、统计报表、队列与定时任务等运维能力见 功能总览 与 系统管理。