如何在同一Docker容器中为gRPC服务配置路径前缀（与REST API共存）

我有一台部署在server.com的服务器，上面运行的多个系统使用不同的路径前缀，比如server.com/abc和server.com/def。我的应用需要使用server.com/reports作为前缀。

该应用基于Go语言构建，包含两个服务：

• REST API：可通过server.com/reports/api访问，运行在80端口；
• gRPC服务：希望能通过server.com/reports/grpc访问，或者直接映射到5578端口。

两个服务运行在同一个Docker容器中。

现有gRPC服务启动代码 #

lis, err := net.Listen("tcp", fmt.Sprintf("0.0.0.0:%s", port))
grpc_server := grpc.NewServer()
pb.RegisterReportServer(grpc_server, newServer())
grpc_server.Serve(lis)

现有Dockerfile片段 #

FROM golang:1.22-alpine as build

WORKDIR /go/src/

COPY . .

RUN go mod download
RUN CGO_ENABLED=0 GOOS=linux go build -o /go/bin/kreports main.go
RUN apk add --no-cache tzdata

FROM scratch

COPY --from=build /go/bin/kreports /go/bin/kreports
COPY --from=build /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ca-certificates.crt
COPY --from=build /go/src/templates /templates

EXPOSE 8000
EXPOSE 5578

ENTRYPOINT ["/go/bin/kreports"]

现有.proto文件内容 #

syntax = "proto3";

package proto_files;

option go_package = "./;proto_files";

service Report {
    rpc SendPetitionReport(ReportPetitionRequest) returns (ReportPetitionResponse) {}
    rpc SendStatusReport(StatusRequest) returns (stream StatusResponse) {}
}

核心问题 #

能不能直接在Go代码中配置gRPC服务的路径前缀（/reports/grpc）？还是需要使用NGINX或Docker Compose等外部工具进行反向代理配置？希望能得到相关指导或示例。

方案一：在Go代码中直接处理路径前缀 #

gRPC本身基于HTTP/2，但默认不支持路径前缀配置，不过可以通过自定义HTTP服务器包装gRPC服务的方式实现。思路是让HTTP服务器拦截请求，只有路径匹配/reports/grpc时才转发给gRPC服务，其他路径交给REST API处理。

示例代码如下：

package main

import (
    "fmt"
    "net"
    "net/http"
    "strings"

    "google.golang.org/grpc"
    pb "your/proto/package/path"
)

func main() {
    // 初始化gRPC服务
    grpcServer := grpc.NewServer()
    pb.RegisterReportServer(grpcServer, newServer())

    // 创建HTTP多路复用器，分发不同请求
    mux := http.NewServeMux()

    // 绑定REST API的处理逻辑（替换成你实际的REST handler）
    mux.Handle("/reports/api/", http.StripPrefix("/reports/api", yourRESTHandler))

    // 拦截gRPC请求，调整路径后转发给gRPC服务
    mux.HandleFunc("/reports/grpc/", func(w http.ResponseWriter, r *http.Request) {
        // 校验是否为HTTP/2请求（gRPC依赖HTTP/2）
        if r.ProtoMajor != 2 {
            http.Error(w, "gRPC requires HTTP/2", http.StatusBadRequest)
            return
        }
        // 移除自定义前缀，转为gRPC默认的根路径
        r.URL.Path = strings.TrimPrefix(r.URL.Path, "/reports/grpc")
        grpcServer.ServeHTTP(w, r)
    })

    // 监听80端口（注意和Dockerfile的EXPOSE配置保持一致，可按需调整）
    lis, err := net.Listen("tcp", ":80")
    if err != nil {
        panic(fmt.Sprintf("failed to listen: %v", err))
    }
    fmt.Println("Server running on :80")
    http.Serve(lis, mux)
}

注意事项：

• 确保gRPC客户端调用时使用server.com/reports/grpc作为地址，且客户端支持HTTP/2（主流gRPC客户端默认支持）；
• 如果REST和gRPC服务要共用同一端口，必须用这种多路复用方式，避免端口冲突；
• 需调整Dockerfile的EXPOSE配置，和代码监听的端口保持一致（比如把EXPOSE 8000改成EXPOSE 80）。

方案二：使用NGINX反向代理（多服务场景推荐） #

如果服务器上有多个系统需要统一管理路径前缀，用NGINX做反向代理更灵活，无需修改Go代码。

NGINX配置示例 #

server {
    listen 80;
    server_name server.com;

    # 转发REST API请求到容器映射的端口
    location /reports/api/ {
        proxy_pass http://localhost:宿主机映射的REST端口/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    # 转发gRPC请求到容器的5578端口
    location /reports/grpc/ {
        grpc_pass grpc://localhost:宿主机映射的gRPC端口/;
        grpc_set_header Host $host;
        grpc_set_header X-Real-IP $remote_addr;
    }

    # 其他系统的路径前缀配置
    location /abc/ {
        proxy_pass http://localhost:abc服务端口/;
    }

    location /def/ {
        proxy_pass http://localhost:def服务端口/;
    }
}

Docker Compose配置示例（管理容器端口映射） #

version: '3.8'
services:
  kreports:
    build: .
    ports:
      - "8080:80"  # 容器80端口映射到宿主机8080
      - "5578:5578" # 容器5578端口映射到宿主机5578
    restart: always

注意事项：

• NGINX版本需1.13.10及以上，确保支持gRPC转发；
• 容器内gRPC服务需监听5578端口，REST API监听80端口；
• 客户端调用gRPC时直接使用server.com/reports/grpc，NGINX会自动转发到对应端口。

方案对比 #

• 代码处理：适合单一服务场景，无需额外依赖，但需修改代码逻辑，耦合度较高；
• 反向代理：适合多服务共存场景，配置灵活，无需修改应用代码，便于统一管理所有路径前缀。

内容的提问来源于stack exchange，提问作者Daniel Nochess