GreptimeDB 单机模式

安装

我们先通过最简单的配置来开始。有关 GreptimeDB 中可用的所有配置选项的详细列表，请参考配置文档。

二进制

你可以在下载页面通过发布的最新稳定版本尝试使用 GreptimeDB。

Linux 或 macOS

如果你使用的是 Linux 或 macOS，可以通过以下命令下载 greptime binary 的最新版本：

  1. curl -fsSL \
  2.   https://raw.githubusercontent.com/greptimeteam/greptimedb/main/scripts/install.sh | sh -s v0.9.3

下载完成后，binary 文件 greptime 将存储在当前的目录中。

你可以在单机模式下运行 GreptimeDB：

  1. ./greptime standalone start

Windows

若您的 Windows 系统已开启 WSL(Windows Subsystem for Linux)，您可以直接打开一个最新的 Ubuntu 接着如上所示运行 GreptimeDB ！

否则请到我们的官网下载并解压最新的 GreptimeDB for Windows 安装包。

在单机模式下运行 GreptimeDB，您可以在 GreptimeDB 二进制所在的文件夹下打开一个终端（比如 Powershell ），执行：

  1. .\greptime standalone start

Docker

请确保已经安装了 Docker。如果还没有安装，可以参考 Docker 官方的文档进行安装。

  1. docker run -p 127.0.0.1:4000-4003:4000-4003 \
  2.   -v "$(pwd)/greptimedb:/tmp/greptimedb" \
  3.   --name greptime --rm \
  4.   greptime-registry.cn-hangzhou.cr.aliyuncs.com/greptime/greptimedb:v0.9.3 standalone start \
  5.   --http-addr 0.0.0.0:4000 \
  6.   --rpc-addr 0.0.0.0:4001 \
  7.   --mysql-addr 0.0.0.0:4002 \
  8.   --postgres-addr 0.0.0.0:4003

GreptimeDB 单机模式 - 图1注意事项

为了防止不小心退出 Docker 容器，你可能想以 “detached” 模式运行它：在 docker run 命令中添加 -d 参数即可。

数据将会存储在当前目录下的 greptimedb/ 目录中。

如果你想要使用另一个版本的 GreptimeDB 镜像，可以从我们的 GreptimeDB Dockerhub 下载。

GreptimeDB 单机模式 - 图2注意事项

如果正在使用小于 v23.0 的 Docker 版本，由于旧版本的 Docker Engine 中存在 bug，所以当你尝试运行上面的命令时，可能会遇到权限不足的问题。

你可以:

  1. 设置 --security-opt seccomp=unconfined：
  1.  docker run --security-opt seccomp=unconfined -p 4000-4003:4000-4003 \
  2.    -v "$(pwd)/greptimedb:/tmp/greptimedb" \
  3.    --name greptime --rm \
  4.    greptime-registry.cn-hangzhou.cr.aliyuncs.com/greptime/greptimedb:v0.9.3 standalone start \
  5.    --http-addr 0.0.0.0:4000 \
  6.    --rpc-addr 0.0.0.0:4001 \
  7.    --mysql-addr 0.0.0.0:4002 \
  8.    --postgres-addr 0.0.0.0:4003
  1. 将 Docker 版本升级到 v23.0.0 或更高;

绑定地址

GreptimeDB 默认绑定地址为 127.0.0.1。如果你需要能够接收来自所有地址的连接，可以通过以下参数启动。

GreptimeDB 单机模式 - 图3危险操作

如果运行 GreptimeDB 的计算机直接向互联网暴露服务，那么绑定 0.0.0.0 会十分危险，因为这将数据库实例暴露给互联网上的所有人。

  • 二进制
  • Docker
  1. ./greptime standalone start \
  2.    --http-addr 0.0.0.0:4000 \
  3.    --rpc-addr 0.0.0.0:4001 \
  4.    --mysql-addr 0.0.0.0:4002 \
  5.    --postgres-addr 0.0.0.0:4003
  1. docker run -p 0.0.0.0:4000-4003:4000-4003 \
  2.   -v "$(pwd)/greptimedb:/tmp/greptimedb" \
  3.   --name greptime --rm \
  4.   greptime-registry.cn-hangzhou.cr.aliyuncs.com/greptime/greptimedb:v0.9.3 standalone start \
  5.   --http-addr 0.0.0.0:4000 \
  6.   --rpc-addr 0.0.0.0:4001 \
  7.   --mysql-addr 0.0.0.0:4002 \
  8.   --postgres-addr 0.0.0.0:4003

你也可以参考配置 GreptimeDB文档在配置文件中修改绑定的地址。

下一步

学习如何使用 GreptimeDB：快速开始。