# 拉取官方镜像
docker pull starrocks/allin1:latest

# 运行容器
docker run -d -p 9030:9030 -p 8030:8030 -p 8040:8040 --name starrocks starrocks/allin1:latest

3.4 源码编译

如果需要自定义构建，可以从源码编译：

# 克隆源码仓库
git clone https://github.com/StarRocks/starrocks.git

# 进入目录
cd starrocks

# 编译
sh build.sh

4. 验证步骤

下载完成后，建议验证文件完整性：

# 计算MD5哈希值
md5sum starrocks-2.5.4.tar.gz

# 计算SHA256哈希值
sha256sum starrocks-2.5.4.tar.gz

# 与官方提供的哈希值进行比对

5. 安装准备

5.1 系统要求

• 操作系统：Linux (推荐)、macOS (开发环境)
• CPU：至少 4 核，生产环境建议 8 核以上
• 内存：至少 8GB RAM，生产环境建议 16GB+
• 存储：根据数据量需求，建议使用 SSD 或 HDD 阵列
• 网络：局域网环境，建议 1Gbps 以上带宽
• 依赖：Java 8 或更高版本

5.2 环境配置

# 设置Java环境变量
export JAVA_HOME=/path/to/java
export PATH=$PATH:$JAVA_HOME/bin

# 设置StarRocks环境变量
export STARROCKS_HOME=/path/to/starrocks
export PATH=$PATH:$STARROCKS_HOME/bin

# 配置文件位置
# $STARROCKS_HOME/fe/conf/fe.conf
# $STARROCKS_HOME/be/conf/be.conf

# FE 主要配置参数
JAVA_HOME=/path/to/java
meta_dir=/path/to/starrocks/fe/meta
http_port=8030
rpc_port=9020
query_port=9030
edit_log_port=9010

# BE 主要配置参数
JAVA_HOME=/path/to/java
storage_root_path=/path/to/starrocks/be/storage
be_port=9060
be_rpc_port=9070
http_port=8040

6. 生产环境推荐

6.1 硬件配置

• FE节点：8-16核CPU，16-32GB RAM，1TB+ SSD
• BE节点：16-32核CPU，32-64GB RAM，2TB+ SSD
• 建议至少部署 3 个 FE 节点和 3 个 BE 节点以实现高可用

6.2 集群规划

• 小型集群：3个 FE 节点，3个 BE 节点
• 中型集群：3-5个 FE 节点，5-10个 BE 节点
• 大型集群：5+个 FE 节点，10+个 BE 节点

6.3 存储配置

• 使用 RAID 10 配置提高数据可靠性
• 为数据目录和日志目录配置独立的磁盘
• 考虑使用 SSD 存储以提高性能

6.4 高可用性

• 部署多个 FE 节点，其中一个为 leader，其他为 follower
• 部署多个 BE 节点，数据自动分片存储
• 配置 FE 节点的元数据同步

6.5 监控与维护

• 使用 StarRocks 内置的系统表进行监控
• 配置 Prometheus + Grafana 监控
• 定期备份元数据
• 设置合理的分区和压缩策略

6.6 安全配置

• 启用用户认证
• 配置 SSL 加密传输
• 设置访问控制列表
• 定期更新密码和密钥

7. 常见问题

• 问题：启动 StarRocks FE 时出现端口占用错误
  解决方案：检查端口是否被占用，修改配置文件中的端口设置
• 问题：StarRocks BE 无法连接到 FE
  解决方案：确保网络连接正常，检查 FE 服务是否运行
• 问题：StarRocks 查询执行缓慢
  解决方案：优化查询语句，调整服务器配置，考虑增加硬件资源