GoWind IM 场景:乙方怎么用一套 IM 平台交付多个客户——档位、租户与离线交付
本文回答一个问题:集成商每个客户项目都要「IM + 审批 + 文件 + 消息通知」,从零开发必亏、用公有云客户不接受。一套可按档裁剪、离线激活、租户隔离的私有化平台,交付模型长什么样?
利益相关声明:我是 GoWind IM 的作者。这篇面向乙方/集成商视角,写的都是交付流水线的真实机制(命令与产物清单出自仓库
docs/commercialization.md与backend/tools/release.sh)。
一、乙方的真实账本
给客户做项目时,IM 相关需求几乎必然出现:站内信、审批通知、文件传输、客户沟通。三条传统路各有死穴:
- 从零开发:IM 是典型的「看起来简单、做深极难」(长连接、弱网、离线、安全),项目工时直接爆掉;
- 接云服务 SDK:客户不接受数据出域(尤其政企/金融客户),且按量成本无法转嫁为一次性项目款;
- 拿开源改:每个客户 fork 一份,三年后你维护着 N 份分叉——这是维护债的复利。
第四条路:一套平台 + 按客户签发的授权。这就是 GoWind IM 售卖化体系设计的原始场景。
二、交付资产:一份制品 + 一张 license
GoWind IM 的交付模型极简:一份制品 + 离线签名 license。对乙方意味着「攒一次制品,签 N 份授权」:
# 私钥一次性生成,离线保管,绝不进仓库
go run ./tools/license-gen keygen
# 每单:取客户机指纹 → 按客户签发
go run ./tools/license-gen fingerprint
go run ./tools/license-gen sign \
-licensee "某某科技有限公司" \
-edition enterprise \
-expires 2027-08-31 \
-max-users 500 \
-fingerprint <客户机指纹>
# 打包:按档裁剪服务清单、出离线镜像 tar
./tools/release.sh --edition enterprise --version 1.0.0 \
--pubkey "$(cat pubkey.pem)" --out dist \
--garble --with-frontend
交付包里是:按档裁剪的镜像 tar、按档渲染的 docker-compose、install.sh(SHA256 校验 → 镜像导入 → license 校验 → 启动)、UPGRADE.md、升级预检工具、外置可编辑配置。客户内网全程无外联——这对内网交付场景是硬需求,也是乙方投标时的加分项。
两个对乙方实用的工程细节:
--arch arm64:鲲鹏/飞腾国产化环境直接出一架构包,install.sh有宿主机架构防呆;- 外置配置:交付包
configs/<服务>/是挂载进容器的外置副本,客户改口令/改参数不用重打镜像——现场实施不用带着构建机。
三、档位即报价单:功能位门控
license 的 claims 是 licensee / edition / features[] / not_before / expires_at / max_users,三档默认功能集(权威源 backend/pkg/license/features.go):
| 档位 | 功能位 | 对应交付面 |
|---|---|---|
| community | 基础 IM + 基座(含 media / ai) | 18 个服务:会话/群/通讯录/房间/看板/applet |
| professional | + drive / bot / channel / 音视频 / 通知 / 文档 / 朋友圈 / 直播 / 访客 / 日历 / 研发协同 / 多维表格 / HR / Office / Ledger | + 11~15 个服务 |
| enterprise | professional 全集 + OA / ERP / 审计 / openapi / CRM / SSO | + 8 个服务 |
签发时 -features 可在档位之上任意增删——乙方的报价单可以直接映射到功能位清单上,「这单只买 IM+OA」和「这单上全量 ERP+CRM」是同一套制品、不同的 features 数组。
门控是后端真强制,不是前端藏菜单,三层强制 + 一层展示:
- 服务启动:
license.MustInit验签失败/硬过期/未授权功能集,服务直接拒绝启动; - RPC 全局:硬过期后所有请求 403(含 MQTT 链路——EMQX 认证回调一并封死);
- RPC 功能级:按 Operation 前缀映射功能位,未解锁 403
FEATURE_NOT_LICENSED; - 前端展示层只负责「少让用户点到必然失败的功能」。
对乙方的意义:客户超范围使用(没买的档硬调接口)在服务端就断了,不会出现「交付后客户偷偷用高级功能」的扯皮。
四、一套部署服务多客户,还是一客户一套部署
两种形态平台都支持,选择权在乙方的运营模型:
形态 A:一客户一套部署(多数乙方适用)。每单独立环境,license 绑定客户机指纹(/etc/machine-id / Windows MachineGuid 等指纹链),客户间零共享。数据边界最清晰,适合 To B 交付。
形态 B:一套部署多租户(乙方自运营 SaaS 适用)。identity/permission/authentication 构成多租户基座:RBAC 策略键是 (tenantId, roleCode),角色码跨租户可重名;数据级权限经 ent privacy 规则注入 created_by 谓词,租户上下文经 JWT 跨 gRPC 透传。租户级功能开关(如翻译开关、短视频开关、AI 租户限额)在 license 之外提供第二层按租户运营的空间。
五、升级与售后边界
- N-1 升级路径:
upgrade-preflight预检工具按 schema 漂移比对基线,跨版本硬拒转人工——乙方的售后承诺可以照抄这条:支持升级到上一版本,更老的先逐级走; - 续期不停机:license 过期有 7 天全功能宽限期,硬过期后覆盖
license/license.key即可,服务每分钟懒式复查自动感知,无需重启——年底批量续期不需要约停机窗口; - 诚实边界:默认不交付源码;安全审计的替代路径是第三方审计报告或保密协议下的有限源码审计。防拷贝目标是「防随手复制给别家跑」,不追求防专业破解(garble 混淆与去符号抬成本,已接入流水线)。乙方给客户的合同条款建议与这个口径对齐,别过度承诺。
六、这套模型适合谁
- 适合:项目型集成商(每单都要 IM+协同面)、行业软件商(给自己的系统配一套内嵌协同层)、要投标国产化环境(arm64 + 离线激活)的乙方;
- 不适合:只做轻量定制(community 档之外的功能用不上)、客户预算里没有软件授权概念的小单。
仓库(说明):GitHub | Gitee——微服务化即时通讯平台,二进制私有化交付,档位 + 离线 license 授权。
交付咨询:微信 yang_lin_bo(备注 go-wind-im)。