---
title: "手把手教你安装 Garnet"
url: https://www.geekcorelab.cn/post/hand-in-hand-teaching-you-how-to-install-garnet
updated: 2026-10-29T13:06:41.194558Z
author: "hhjmk"
summary: "Garnet 是微软用 C# 开发的 Redis 兼容缓存组件，需 .NET8 环境。文章介绍了在 Ubuntu 22.04 服务器上编译 Garnet 的步骤，包括下载源码、安装 .NET8 SDK、设置环境变量、构建和运行。编译成功后，Garnet 会在 3278 端口运行，支持 Redis 客户端连接。文章建议使用境外服务器避免网络问题，并提供了具体命令和操作截图说明。"
---

# 手把手教你安装 Garnet

什么是 Garnet
----------

Garnet 是微软使用 C# 编写的 Redis 客户端兼容缓存组件，你可以使用 Redis 客户端的连接方式来连接 Garnet

但是 Garnet 需要 .NET8 运行环境才可以使用，为了便捷性，可以考虑构建成 Docker 镜像

裸机部署
----

首先，建议使用境外的服务器来构建，避免国内网络环境对安装过程造成影响，本教程使用雨云服务器以及雨云提供的 Ubuntu 22.04 且不预装任何 APP，如果你在安装时遇到了任何问题，可以尝试来雨云 1 元试用一台机子一天，一天的时间足够编译一个 Garnet 出来了，因为涉及到编译操作，这里直接试用一台 8 核心 16G 内存的机子

![](/uploads/import-placeholder/343)

![](/uploads/import-placeholder/16)
首先你需要把 Garnet 的源码下载下来

```
git clone https://github.com/microsoft/garnet.git
```

之后，你需要安装一个 .NET8 SDK[1](#6f322df6-7f52-4ad5-84ff-62d7feb81007)

首先我们下载微软提供的安装脚本并赋予执行权限

```
wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
chmod +x ./dotnet-install.sh
```

执行脚本安装 .NET8 SDK

```
./dotnet-install.sh --channel 8.0
```

![](/uploads/import-placeholder/401)
稍等片刻出现：

```
Installation finished successfully.
```

即为安装成功，随后需要设置一个环境变量

```
export DOTNET_ROOT=$HOME/.dotnet
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
```

之后执行构建命令即可开始构建

```
cd garnet
dotnet restore
dotnet build -c Release
```

![](/uploads/import-placeholder/399)

![](/uploads/import-placeholder/168)
稍等片刻即可看到构建成功的提示，这三行的意思分别是

- 构建成功
- 0警告
- 0错误

之后我们试着运行一下它

```
cd main/GarnetServer
dotnet run -c Release -f net8.0
```

![](/uploads/import-placeholder/101)
可以看到已经有红色宝石了，试着连接一下，要注意的是，Garnet 使用的端口是 3278，从 Redis 直接迁移的需要注意一下更改连接方式，但无需更改客户端，直接使用 Redis 的客户端连接即可

创建一个 Key：

![](/uploads/import-placeholder/194)
成功
