all-in-kingsoft/hhs/gRPC/3. 服务端实现/08-Server 搭建与注册.md

---
tags: [gRPC, Go, Server, Index]
create time: 2026-05-11 16:00
---

# Server 搭建与注册

## 概述

这一组笔记从"如何跑起来"出发，逐步叠加生产环境需要的各种配置——直到你能直接复制一个完整的 server bootstrap 投入生产。按顺序阅读，不要跳。

## 学习笔记（按推荐顺序）

### 入门

| #                                                                 | 笔记                             | 读它如果...                |
| ----------------------------------------------------------------- | ------------------------------ | ---------------------- |
| [[hhs/gRPC/3. 服务端实现/08-Server 搭建与注册/01-Hello World 最小可运行 Server]] | **第一课**：三段式模板，从零搭起一个能跑的 server | 你是 gRPC 新手，想先看到"能跑的代码" |

### 核心概念

| # | 笔记 | 读它如果... |
|---|------|------------|
| [[hhs/gRPC/3. 服务端实现/08-Server 搭建与注册/02-ServerOption 生产级配置速查]] | TLS、消息大小、keepalive、拦截器——高频选项逐一讲解 | 想知道每个参数到底该设多大、为什么这么设 |
| [[hhs/gRPC/3. 服务端实现/08-Server 搭建与注册/03-Service Registration 服务注册详解]] | Proto 生成了什么、单 server 多 service、底层路由机制 | 想理解 `RegisterXxxServer()` 背后发生了什么 |
| [[hhs/gRPC/3. 服务端实现/08-Server 搭建与注册/04-Reflection 开发调试利器]] | 用 grpcurl 无需 proto 就能查 API，生产环境为什么关掉 | 想知道开发时怎么快速调试 |
| [[hhs/gRPC/3. 服务端实现/08-Server 搭建与注册/05-Multi-Port 多端口暴露]] | 一个端口 vs 多个端口的正确写法，内外网分离模式 | 需要内网外网分开暴露，或同时监听 IPv4 + IPv6 |

### 进阶

| # | 笔记 | 读它如果... |
|---|------|------------|
| [[hhs/gRPC/3. 服务端实现/08-Server 搭建与注册/06-Graceful Shutdown 优雅关闭]] | Signal 处理、超时兜底、ctx 驱动模式、常见坑 | 要上线了，不想因为 kill 进程导致数据不一致 |

### 深入专题

| # | 笔记 | 说明 |
|---|------|------|
| [[hhs/gRPC/3. 服务端实现/08-Server 搭建与注册/00-Unimplemented 零-Stub 模式]] | UnimplementedXXXServer 的设计原理和封闭接口技巧，建议在学完 Hello World 后阅读 | 零-Stub 模式的深度原理解析 |
| [[hhs/gRPC/3. 服务端实现/09-Streaming Handler]] | Streaming RPC 的 handler 编写范式 | 流式处理的完整指南 |

## 关联笔记

- [[hhs/gRPC/3. 服务端实现/10-健康检查与反射]]
- [[hhs/gRPC/5. 中间件与拦截器/14-Unary 与 Stream 拦截器]]
- [[hhs/gRPC/4. 客户端开发/11-Client 连接与 Dial]]