install starrocks

config/install_starrocks

@@ -0,0 +1,203 @@
+好的，在本地搭建 StarRocks 是一个非常常见的需求，用于开发、测试或学习。下面我将为你提供两种最常用且简单的方法：**使用 Docker（最简单推荐）** 和 **使用二进制文件直接部署**。
+
+我会以 **macOS 或 Linux** 环境为例进行说明（Windows 用户强烈建议使用 WSL2 或 Docker Desktop）。
+
+---
+
+### 方法一：使用 Docker 搭建（最快最方便，强烈推荐）
+
+这种方法无需处理复杂的依赖关系，几条命令就能拉起一个完整的 StarRocks 集群（包含 1 个 FE 和 1 个 BE）。
+
+#### 步骤 1：安装 Docker
+
+确保你的本地环境已经安装了 Docker Desktop 或 Docker Engine。
+*   官网下载： [https://www.docker.com/products/docker-desktop/](https://www.docker.com/products/docker-desktop/)
+*   安装后启动 Docker 服务。
+
+#### 步骤 2：下载 StarRocks Docker 镜像
+
+打开终端（Terminal），执行以下命令来下载官方镜像：
+
+```bash
+docker pull starrocks/allin1-ubuntu
+```
+
+#### 步骤 3：启动 StarRocks 容器
+
+使用以下命令启动一个容器：
+
+```bash
+docker run -p 9030:9030 -p 8030:8030 -p 8040:8040 --name starrocks -d starrocks/allin1-ubuntu
+```
+
+*   `-p 9030:9030`: 将容器的 FE MySQL 查询端口映射到本地。
+*   `-p 8030:8030`: 将容器的 FE HTTP 端口（用于 Web 界面）映射到本地。
+*   `-p 8040:8040`: 将容器的 BE HTTP 端口映射到本地。
+*   `--name starrocks`: 为容器指定一个名字，方便后续操作。
+*   `-d`: 让容器在后台运行。
+
+#### 步骤 4：进入容器并连接
+
+1.  **进入容器内部**：
+    ```bash
+    docker exec -it starrocks /bin/bash
+    ```
+
+2.  **使用 MySQL 客户端连接**：
+    在容器内部的命令行中，使用预装好的 MySQL 客户端连接至 StarRocks 的 FE。
+
+    ```bash
+    mysql -P9030 -h127.0.0.1 -uroot --prompt="StarRocks > "
+    ```
+    *   默认没有密码，直接回车即可。
+
+#### 步骤 5：验证安装
+
+连接成功后，你会看到 `StarRocks >` 提示符。执行一个简单的 SQL 来验证：
+
+```sql
+SHOW FRONTENDS\G
+```
+如果能看到 `Alive: true` 的节点信息，说明 FE 启动成功。
+
+```sql
+SHOW BACKENDS\G
+```
+如果能看到 `Alive: true` 的节点信息，说明 BE 也启动成功。
+
+**恭喜！至此，一个单机版的 StarRocks 集群就已经在 Docker 中运行起来了。**
+
+---
+
+### 方法二：使用二进制包在本地部署
+
+这种方法更接近生产环境的部署方式，适合想要深入了解其组成和配置的用户。
+
+#### 步骤 1：下载二进制包
+
+访问 StarRocks 官网的 [下载页面](https://www.starrocks.io/zh-CN/download/community) ，选择适合你操作系统（Linux）的版本。通常下载 `.tar.gz` 格式的压缩包。
+
+例如，使用 `wget` 下载：
+
+```bash
+wget https://releases.starrocks.io/starrocks/StarRocks-3.2.6.tar.gz
+```
+
+#### 步骤 2：解压安装包
+
+```bash
+tar -xzvf StarRocks-3.2.6.tar.gz
+cd StarRocks-3.2.6
+```
+
+#### 步骤 3：部署 FE（Frontend）
+
+1.  **进入 FE 目录并创建元数据目录**：
+    ```bash
+    cd fe && mkdir meta
+    ```
+
+2.  **修改 FE 配置文件** (`conf/fe.conf`)：
+    对于本地测试，主要确保端口不被占用即可。如果需要调整 JVM 堆大小（如果机器内存小），可以修改：
+    ```ini
+    JAVA_OPTS = "-Xmx4096m -XX:+UseMembar -XX:SurvivorRatio=8 ..."
+    ```
+    将 `-Xmx4096m`（最大堆内存）改为 `-Xmx2048m`。
+
+3.  **启动 FE**：
+    ```bash
+    ./bin/start_fe.sh --daemon
+    ```
+    使用 `--daemon` 参数让它在后台运行。
+
+4.  **检查 FE 是否启动成功**：
+    ```bash
+    jps
+    ```
+    你应该能看到 `StarRocksFe` 进程。
+    也可以查看日志 `log/fe.log`，看到 `thrift server started` 和 `http server started` 等字样表示成功。
+
+#### 步骤 4：部署 BE（Backend）
+
+1.  **打开一个新终端窗口**，进入 BE 目录：
+    ```bash
+    cd StarRocks-3.2.6/be
+    ```
+
+2.  **创建 BE 数据存储目录**：
+    ```bash
+    mkdir storage
+    ```
+
+3.  **修改 BE 配置文件** (`conf/be.conf`)：
+    同样，本地测试主要关注端口和存储路径。确保 `storage_root_path` 配置正确：
+    ```ini
+    storage_root_path = /path/to/your/StarRocks-3.2.6/be/storage
+    ```
+
+4.  **启动 BE**：
+    ```bash
+    ./bin/start_be.sh --daemon
+    ```
+
+5.  **检查 BE 是否启动成功**：
+    ```bash
+    jps
+    ```
+    你应该能看到 `StarRocksBe` 进程。
+    查看日志 `log/be.INFO`，看到 ` heartbeat` 相关信息表示成功。
+
+#### 步骤 5：将 BE 添加到集群中
+
+现在 FE 和 BE 是两个独立的进程，需要通过 MySQL 客户端告诉 FE 有一个 BE 需要加入集群。
+
+1.  **使用 MySQL 客户端连接 FE**：
+    ```bash
+    # 在FE所在机器的StarRocks-3.2.6目录下操作
+    mysql -P9030 -h127.0.0.1 -uroot
+    ```
+
+2.  **执行添加 BE 的命令**：
+    ```sql
+    ALTER SYSTEM ADD BACKEND "127.0.0.1:9050";
+    ```
+    `9050` 是 BE 的心跳服务端口，默认就是 9050。
+
+#### 步骤 6：验证集群状态
+
+在 MySQL 客户端中执行：
+
+```sql
+SHOW FRONTENDS\G
+SHOW BACKENDS\G
+```
+如果两个节点的 `Alive` 字段均为 `true`，则表明本地集群搭建成功！
+
+---
+
+### 下一步：使用 StarRocks
+
+1.  **访问 Web UI**：在浏览器中打开 `http://127.0.0.1:8030`（Docker 方法端口是 8030，二进制方法默认也是 8030），可以使用内置的 Playground 进行 SQL 查询。
+2.  **创建数据库和表**：
+    ```sql
+    CREATE DATABASE test;
+    USE test;
+    CREATE TABLE test_table (
+        id INT,
+        name VARCHAR(100)
+    ) DUPLICATE KEY(id)
+    DISTRIBUTED BY HASH(id) BUCKETS 8;
+    ```
+3.  **插入数据并查询**：
+    ```sql
+    INSERT INTO test_table VALUES (1, 'StarRocks'), (2, 'OLAP');
+    SELECT * FROM test_table;
+    ```
+
+### 常见问题
+
+*   **端口冲突**：如果 9030, 8030, 8040 等端口被占用，可以在配置文件（方法二）或 Docker 启动命令（方法一）中修改为其他端口。
+*   **内存不足**：如果本地机器内存较小，请务必在 FE 和 BE 的配置文件中调小 `JAVA_OPTS` 和 `mem_limit` 等参数。
+*   **下载慢**：从国内下载 StarRocks 二进制包可能较慢，可以尝试使用镜像源。
+
+对于初学者，**强烈建议从方法一（Docker）开始**，可以避免很多环境问题，让你快速专注于体验 StarRocks 的功能。