跳转到主要内容

KeyDB 开源版入门

在 Docker 上运行#

安装 Docker#

如果您尚未安装 Docker,可以使用 $ sudo apt-get install docker docker.io 进行安装

拉取并运行#

使用 $ sudo docker pull eqalpha/keydb 拉取最新的 KeyDB Docker 镜像。或者,如果您直接使用 run 命令,Docker 会在运行前拉取最新的镜像。基本的运行命令是 $ sudo docker run eqalpha/keydb

您可能希望在启动时自定义配置。您可以在我们的 Docker 页面上找到更多信息。这里我们将介绍几个启动 Docker 容器的示例。

启动实例#

$ docker run -p 6379:6379 --name mycontainername -d eqalpha/keydb keydb-server /etc/keydb/keydb.conf --requirepass mypassword

在这里,我们启动了一个名为 'mycontainername' 的容器,它以“分离”模式在后台运行,我们指定了 'eqalpha/keydb' 仓库,然后调用了 'keydb-server' 程序,并引用了配置文件,同时更新了 'requirepass' 参数。如果没有特别指定程序,keydb-server 将默认启动。如果您需要指定额外的参数,则必须指定程序。

使用 keydb-cli 连接#

为了连接到在 Docker 容器内运行的服务器,您需要其 IP 地址。可以通过运行以下命令获取 IP 地址:

$ docker inspect --format '{{ .NetworkSettings.IPAddress }}' mycontainername

然后运行以下命令:

$ docker run -it --rm eqalpha/keydb keydb-cli -h <上面获取的ip地址> -p 6379

'rm' 参数会在您使用完毕后移除该容器。

使用 KeyDB PPA#

有关我们的 PPA 和使用 deb 包的更多详细信息,请参阅此篇文章。不过,使用 PPA 非常简单:

$ echo "deb https://download.keydb.dev/open-source-dist $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/keydb.list
$ sudo wget -O /etc/apt/trusted.gpg.d/keydb.gpg https://download.keydb.dev/open-source-dist/keyring.gpg
$ sudo apt update
$ sudo apt install keydb

将 KeyDB 作为服务使用#

Debian 软件包安装后,您可以使用以下命令启动或停止服务:

$ sudo service keydb-server start
$ sudo service keydb-server stop

您可以在 /etc/keydb/keydb.conf 中自定义 KeyDB 配置。

已安装的二进制文件#

二进制软件包安装后,您也可以直接调用二进制文件并传递参数来运行实例。例如:

$ keydb-server --port 6379 --requirepass mypassword --server-threads 7

这里我们启动了 keydb-server,并向默认配置文件传递了参数。您也可以指定您可能已经自定义过的配置文件。

$ keydb-server ./path/to/config/keydb.conf

使用 keydb-cli 连接#

$ keydb-cli -h 127.0.0.1 -p 6379

更多信息请参阅PPA 和 DEB 安装

构建社区版 KeyDB#

请查看我们关于构建 KeyDB(开源版)的文档。一旦您安装了二进制文件(make install),您就可以直接在命令行调用程序 keydb-server。您需要指定您的目录位置、日志文件位置和 .conf 文件位置。

安装完成后,您可以移除您克隆的项目文件夹,但请确保将顶层目录中的 'keydb.conf' 文件复制到您选择的位置。