castylab/grpc

Casty gRPC服务器镜像

镜像概述

本镜像基于Go语言开发，是一个高性能的gRPC服务器项目，用于在各类环境中高效连接服务，支持负载均衡、追踪、健康检查和认证等功能，适用于数据中心内服务通信及分布式计算场景。

核心功能

• 基于gRPC框架，提供跨环境的高性能RPC通信能力
• 集成MongoDB数据库存储业务数据
• 使用JWT实现安全身份认证
• 可选接入Sentry进行错误追踪
• 支持共享卷存储上传文件（如头像、横幅等）

使用场景

• 数据中心内服务间的低延迟通信
• 分布式系统中设备、移动端应用与后端服务的连接
• 需要高可靠性和可扩展性的RPC服务场景

配置说明

前置条件

1. 安装Go 1.11及以上版本（支持Go Modules）
2. 部署MongoDB数据库

克隆项目

bash
git clone https://github.com/CastyLab/grpc.server.git

配置文件设置

复制示例配置文件并修改为自定义配置：

bash
cp config.example.yml config.yml

MongoDB配置

在config.yml中填写MongoDB连接信息：

yaml
secrets:
  db:
    name: "casty"
    host: "localhost"
    port: 27017
    user: "service"
    pass: "super-secure-password"

JWT配置

设置JWT认证参数及密钥路径：

yaml
secrets:
  jwt:
    expire_time: 60
    refresh_token_valid_time: 7
    private_key_path: "./config/jwt.key"
    public_key_path: "./config/jwt.pub"

生成JWT密钥对：

bash
ssh-keygen -t rsa -N '' -b 4096 -m PEM -f ./config/jwt.key &&\
openssl rsa -in ./config/jwt.key -pubout -outform PEM -out ./config/jwt.pub;

其他配置

yaml
# 存储路径（用于上传头像、横幅等文件）
storage_path: "your-storage-path"

# Sentry DSN（可选，用于错误追踪）
secrets:
    sentry_dsn: "your-sentry-project-dsn"

运行方式

使用Go编译运行

bash
# 安装依赖并直接运行
go run server.go

# 或构建可执行文件
go build -o server .

使用Docker构建与运行

bash
# 构建镜像
docker build . --tag=casty.grpc

# 后台运行容器（自动重启）
docker run -dp --restart=always 55283:55283 casty.grpc

贡献

欢迎您为该项目贡献代码或提出改进建议！