Skip to content

GreptimeDB 单机模式

安装

你可以在下载页面通过我们发布的测试版本尝试使用 GreptimeDB。

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

二进制

Linux 或 macOS

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

shell
curl -fsSL \
  https://raw.githubusercontent.com/greptimeteam/greptimedb/main/scripts/install.sh | sh
curl -fsSL \
  https://raw.githubusercontent.com/greptimeteam/greptimedb/main/scripts/install.sh | sh

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

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

shell
./greptime standalone start
./greptime standalone start

Windows

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

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

在单机模式下运行 GreptimeDB,您可以在 GreptimeDB 二进制所在的文件夹下打开一个终端(比如 Powershell ),执行:

shell
.\greptime standalone start
.\greptime standalone start

Docker

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

shell
docker run -p 127.0.0.1:4000-4003:4000-4003 \
-v "$(pwd)/greptimedb:/tmp/greptimedb" \
--name greptime --rm \
greptime/greptimedb:v0.8.2 standalone start \
--http-addr 0.0.0.0:4000 \
--rpc-addr 0.0.0.0:4001 \
--mysql-addr 0.0.0.0:4002 \
--postgres-addr 0.0.0.0:4003
docker run -p 127.0.0.1:4000-4003:4000-4003 \
-v "$(pwd)/greptimedb:/tmp/greptimedb" \
--name greptime --rm \
greptime/greptimedb:v0.8.2 standalone start \
--http-addr 0.0.0.0:4000 \
--rpc-addr 0.0.0.0:4001 \
--mysql-addr 0.0.0.0:4002 \
--postgres-addr 0.0.0.0:4003

注意事项

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

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

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

注意事项

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

你可以:

  1. 设置 --security-opt seccomp=unconfined

    shell
    docker run --security-opt seccomp=unconfined -p 4000-4003:4000-4003 \
    -v "$(pwd)/greptimedb:/tmp/greptimedb" \
    --name greptime --rm \
    greptime/greptimedb:v0.8.2 standalone start \
    --http-addr 0.0.0.0:4000 \
    --rpc-addr 0.0.0.0:4001 \
    --mysql-addr 0.0.0.0:4002 \
    --postgres-addr 0.0.0.0:4003
    docker run --security-opt seccomp=unconfined -p 4000-4003:4000-4003 \
    -v "$(pwd)/greptimedb:/tmp/greptimedb" \
    --name greptime --rm \
    greptime/greptimedb:v0.8.2 standalone start \
    --http-addr 0.0.0.0:4000 \
    --rpc-addr 0.0.0.0:4001 \
    --mysql-addr 0.0.0.0:4002 \
    --postgres-addr 0.0.0.0:4003
  2. 将 Docker 版本升级到 v23.0.0 或更高;

绑定地址

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

危险操作

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

shell
./greptime standalone start \
   --http-addr 0.0.0.0:4000 \
   --rpc-addr 0.0.0.0:4001 \
   --mysql-addr 0.0.0.0:4002 \
   --postgres-addr 0.0.0.0:4003
./greptime standalone start \
   --http-addr 0.0.0.0:4000 \
   --rpc-addr 0.0.0.0:4001 \
   --mysql-addr 0.0.0.0:4002 \
   --postgres-addr 0.0.0.0:4003
shell
docker run -p 0.0.0.0:4000-4003:4000-4003 \
-v "$(pwd)/greptimedb:/tmp/greptimedb" \
--name greptime --rm \
greptime/greptimedb:v0.8.2 standalone start \
--http-addr 0.0.0.0:4000 \
--rpc-addr 0.0.0.0:4001 \
--mysql-addr 0.0.0.0:4002 \
--postgres-addr 0.0.0.0:4003
docker run -p 0.0.0.0:4000-4003:4000-4003 \
-v "$(pwd)/greptimedb:/tmp/greptimedb" \
--name greptime --rm \
greptime/greptimedb:v0.8.2 standalone start \
--http-addr 0.0.0.0:4000 \
--rpc-addr 0.0.0.0:4001 \
--mysql-addr 0.0.0.0:4002 \
--postgres-addr 0.0.0.0:4003

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

下一步

学习如何使用 GreptimeDB 并使用 Grafana 可视化数据:快速开始