毕昇 BISHENG 的部署门槛,我先把结论放这:这是一套 22 个容器垒起来的企业平台,单机小团队别碰。它的价值不在「能跑」,在跑起来之后的管控能力。这篇拆它的安装脚本和 docker-compose,记我在 M2 Pro 上卡在哪一步。

我在本机(Apple M2 Pro,32 GB,10 核,macOS 14.6.1)真去装了一遍。先照 README 的要求核对:CPU 要 8 核以上,内存 32 GB 起,还得装好 Docker 和 Compose。我这台核数、内存都贴着下限过,卡点不在这两项。

一次拉起 22 个服务

我抓了 1 遍 docker/docker-compose.yml,把顶层服务数了 1 遍,一共 22 个:mysql、redis、elasticsearch、etcd、minio、milvus、openfga、backend、backend_worker、frontend,还有两个 code-runner、gateway、runtime-manager、docker-socket-proxy 这些。基础部署就带 MySQL、Redis、MinIO、OpenFGA、ES、Milvus 六个外部依赖。这不是「装个 Python 包」级别的项目。

这个服务清单本身就是它的定位。它要 RBAC 加 ReBAC 的权限,要 OpenFGA 算授权关系;要 Milvus 存知识库向量;要 MinIO 存对象;要 etcd 给 Milvus 做元数据。少一个都转不起来。

install.sh 只编排不编译

安装入口是 bash docker/install.sh。我把这份 5750 字节的脚本打开读了 1 遍,它干四件事:先 docker compose version 检查 Compose 在不在;没有 .env 就从 .env.example 复制一份并 chmod 600;然后 docker login cr.dataelem.com 登进私有镜像仓库;最后 compose pull 拉镜像、compose up -d 起服务。全程用预构建镜像,不编译你下载的源码。

它有个我没想到的开关。--prepare-only 这个参数走到 compose config --quiet 校验完配置就退出,一个容器都不起。也就是说,你可以在不动 Docker daemon 的情况下,先验一遍 compose 文件写得对不对。这个设计挺实在。

git clone https://github.com/dataelement/bisheng.git
cd bisheng
bash docker/install.sh --prepare-only   # 只校验配置,不起服务

脚本还有个 Gateway 分支值得讲。它支持 --gateway 加 --license-file 加 --public-url 三件套,启用后会给 nginx 加一层网关转发,把 /api 和 websocket 都指到 gateway:8080。License 文件内容写进 .env,HMAC 密钥和网关数据库密码用 od -An -N32 -tx1 /dev/urandom 现生成。这一套是给商业版授权用的,开源版不启用也能跑。我打开这段读了 1 遍,逻辑比我预想的细。

镜像版本锁死在 v3.0.2

.env.example 里把每个组件的镜像版本都写死了,我抄了 1 遍。业务镜像 bisheng-backend 和 bisheng-frontend 都是 v3.0.2;MySQL 锁 8.0,Redis 锁 7.0.4,Elasticsearch 锁 8.12.0,etcd 锁 v3.5.5,Milvus 锁 v2.5.10,OpenFGA 锁 v1.15.2-dm。这套固定版本是好事,企业环境最怕「某天升级了依赖」这种隐性变更。

端口也定了:前端 3001,后端 7860,MySQL 3306,Redis 6379,ES 9200,Milvus 19530。我自写了一份精简拓扑,把重的地方标出来:

services:
  mysql:    { image: "cr.dataelem.com/mysql:8.0" }
  redis:    { image: "cr.dataelem.com/redis:7.0.4" }
  milvus:   { image: "cr.dataelem.com/milvusdb/milvus:v2.5.10" }
  backend:  { image: "cr.dataelem.com/dataelement/bisheng-backend:v3.0.2" }
  frontend: { image: "cr.dataelem.com/dataelement/bisheng-frontend:v3.0.2", ports: ["3001:3001"] }

我的 M2 Pro 卡在 daemon

真到动手这步,卡住了。我跑了 1 遍 docker info,返回的是 failed to connect to the docker API at unix:///Users/zhangcheng/.docker/run/docker.sock ... no such file or directory。Docker 客户端 29.4.0 在,daemon 没起。compose pull 和 compose up -d 这两步都得等 daemon 起来才能走。

所以这篇的实测边界是:我拆了脚本、核了组件和版本、跑了 1 遍 docker info 确认 daemon 状态,但没拉起整套平台。要完整起服务,得先起 Docker Desktop,再让它去拉那几个 G 的镜像。我没在自动化里起 Docker Desktop,因为那会动本机环境。卡在哪、报什么,我如实写了。

管控是它的护城河

这套东西真正值钱的是管控层,我核了 1 遍 README。权限分了两套:RBAC 管功能菜单和操作,ReBAC 管知识空间、文件夹、单个文件的访问,能授权到个人、部门、用户组。API Key 也是分开的,接口权限决定你能做什么,资源授权决定你能对哪些资源操作。拿到密钥不等于拿到整个平台。

这段我印象很深。普通开源项目配个 token 就完事,它把「能调什么接口」和「能碰哪些数据」拆成两维。多租户企业里,这是硬需求,不是锦上添花。

# 权限边界的最小示例:接口权限(能做什么)与资源授权(能碰什么)分开签
# 接口权限: 只能读知识库
# 资源授权: 只能碰「研发部」这个空间

值不值得上,我给了个硬分界。你要的是多租户、部门权限、操作审批、审计留痕这套企业管控,BISHENG 是开源里少见能一次给全的。你要的只是本地跑个 Agent 干活,那 22 个容器就是纯负担。这个判断我坚持:它的成本在运维,不在开发。

还有个判断别忽略。这套东西的门槛不是「装不上」,是「装完谁维护」。MySQL、Milvus、OpenFGA 六个中间件,任何一个挂了你都得会排查。没有专职 SRE 的小团队,别把命运押在上面。