casbin/casbin-server

Casbin Server

https://travis-ci.org/casbin/casbin-server.svg?branch=master](https://travis-ci.org/casbin/casbin-server) https://img.shields.io/docker/cloud/build/casbin/casbin-server](https://hub.docker.com/r/casbin/casbin-server/builds/) https://coveralls.io/repos/github/casbin/casbin-server/badge.svg?branch=master](https://coveralls.io/github/casbin/casbin-server?branch=master) https://godoc.org/github.com/casbin/casbin-server?status.svg](https://godoc.org/github.com/casbin/casbin-server)

Casbin Server是基于https://github.com/casbin/casbin%E7%9A%84**%E8%AE%BF%E9%97%AE%E6%8E%A7%E5%88%B6%E5%8D%B3%E6%9C%8D%E5%8A%A1%EF%BC%88ACaaS%EF%BC%89**%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%EF%BC%8C%E6%8F%90%E4%BE%9Bhttps://grpc.io/%E6%8E%A5%E5%8F%A3%E5%AE%9E%E7%8E%B0Casbin%E6%8E%88%E6%9D%83%E5%8A%9F%E8%83%BD%E3%80%82

镜像概述

Casbin Server作为Casbin执行器和适配器的容器，负责处理策略执行检查（根据模型和策略数量可能消耗一定计算资源），并与外部数据存储（如数据库）交互存储策略数据。与原生Casbin库类似，每个执行器可使用独立适配器连接外部数据库。

支持同机部署或分离部署策略数据库，结合Redis集群可实现高可用性，此时执行器可视为无状态组件（仅检索策略规则、计算并返回允许/拒绝结果）。

核心功能

1. 提供gRPC接口的ACaaS服务
2. 支持多种策略存储适配器（内置Gorm Adapter，可扩展）
3. 跨语言客户端支持（Go、Java、PHP、Python等）
4. 兼容Casbin的ABAC模型（含部分限制）
5. 支持环境变量配置数据库适配器

使用场景

• 分布式系统的统一权限管理中心
• 多语言微服务架构的跨服务权限验证
• 企业级应用的集中化访问控制
• 高可用性要求的权限服务部署

配置说明

数据库适配器配置

支持环境变量注入，以PostgreSQL为例：

json
{
  "driver": "postgres",
  "connection": "host=$DB_HOST port=$DB_PORT user=$DB_USERNAME dbname=$DB_NAME password=$DB_PASSWORD",
  "enforcer": "examples/rbac_policy.csv",
  "dbSpecified": true
}

注：内置Gorm Adapter默认注释了mssql、mysql等数据库依赖，使用时需取消对应注释或修改源码。

ABAC模型限制

1. 结构体需扁平，成员仅支持基本类型（无嵌套/切片/映射）
2. 成员需公开（首字母大写）
3. 最多包含11个成员（如需扩展需修改源码重建）

Docker部署示例

基本运行

bash
docker run -d -p 50051:50051 docker.xuanyuan.run/casbin/casbin-server

（默认暴露gRPC端口50051）

Docker Compose（结合PostgreSQL）

yaml
version: '3'
services:
  casbin-server:
    image: docker.xuanyuan.run/casbin/casbin-server
    ports: ["50051:50051"]
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_USERNAME=casbin
      - DB_NAME=casbin_db
      - DB_PASSWORD=your_password
    depends_on: [postgres]
  postgres:
    image: docker.xuanyuan.run/postgres:14
    environment:
      - POSTGRES_USER=casbin
      - POSTGRES_DB=casbin_db
      - POSTGRES_PASSWORD=your_password
    volumes: [postgres_data:/var/lib/postgresql/data]
volumes: {postgres_data: {}}

资源与帮助

• https://github.com/casbin/casbin
• https://github.com/casbin/casbin-server#architecture

许可证

本项目采用Apache 2.0许可证，详见LICENSE。