Appearance
平台部署须知
此处汇总了部署会众云平台的须知事项，请部署前后仔细了解相关事项
注意
本文在 持续完善 中，如有后续新增须知事项，也会同步更新到此文档中
人数计费规则
规则说明
1、计费人数等同于正式成员人数（无论是否禁用），待激活、待审核、已移除的人数不会被计费
2、成员数量超过限制后将导致授权失败，所有账号无法继续登录
正式成员 列表查看位置如下图：
1.部署前须知
1.1.硬件参数要求
针对服务器硬件，我们支持的最低配置如下：
- 双核CPU或更高
- 注意1： 服务器的CPU必须支持
AVX指令集 - 注意2： 目前主要支持
x86架构CPU，如果arm架构的CPU则需要联系技术人员处理
- 注意1： 服务器的CPU必须支持
- 内存至少8GB
- 硬盘不少于100GB
检查CPU是否支持 AVX 指令集
如果您是Intel的CPU，仅需知悉是否为 Sandy Bridge 及后续架构的CPU均支持。
- 从 i3/i5/i7 的第二代u开始，引入该架构，后续iu均支持
avx指令 - 引入时间参考：2011年。粗略可以认为11年之后的iu均支持
avx指令
如果您是Linux操作系统：使用 cat /proc/cpuinfo | grep avx 检查是否具备 AVX 指令集，只要有 内容输出 便是支持的。
1.2.操作系统要求
选型规则
针对操作系统，只要可以 安装Docker v21及以上版本 ，且支持运行基于 Linux内核 的 Docker 容器，便可部署运行会众云平台。
如果您知悉这两点核心且具备相应的操作能力，可基于此自行选择和部署会众云平台。
提示
推荐使用 Linux系统 ，部署快速且稳定
针对如下操作系统，还有受支持的安装脚本，一键部署平台：
- rocky 8.0及以上
- almalinux 8.0及以上
针对 Linux 的各个发行版，满足安装特定版本及以上的 Docker 环境，即可运行会众云平台
- docker版本要求：v21及以上
提示
主要针对的是Window下的 Docker 安装，可参考此微软文档：⇲准备Windows容器
特别说明 1
使用 云服务器 时，不可选用 Window 系统。Window 操作系统仅可在 物理机 / 裸金属服务器 部署。
特别说明 2
Windows Server 的 21H2 版本有重大兼容性问题，强烈建议提升至更高版本！！！
若不升级，则部署过程会 异常艰难 ，且即便成功部署后，使用体验也 无法保证 。
针对Window 桌面端，请参照如下表格对比
| Window版本 | 是否支持 | 备注 |
|---|---|---|
| Window XP / vista / 7 / 8 | ❌ | - |
| Window 10/11 | ✔ | 内核版本需要 22H2 不支持 家庭版 必须启用 Hyper-V 和 虚拟机平台 特性 |
针对 Window 服务端：
| Window版本 | 是否支持 | 备注 |
|---|---|---|
最低支持版本，且该版本安装最为复杂，且易失败 | ||
依赖网络环境，容易失败 | ||
| Window Server 2022/2025 | ✔ | 推荐使用 Windows Server 2025 |
1.3.需要收费的项目说明
此处列举概述表格，以供快速查阅，若需知悉详情，请前往对应小节查看。
| 功能内容 | 何时使用 | 前置要求 | 价格参考 | 备注 |
|---|---|---|---|---|
| 联网 | - | - | - | 会众云平台从部署到运行，必须保持（注意：无网络版本不需要联网，但需要特殊授权） |
| 内网穿透软件/ 第三方域名解析软件 | 内部部署 但需外网访问 | - | 可免费 | 可选软件：花生壳、ngork、frp、natapp、快解析等 |
| 云服务器部署 | 云上部署 | 云服务器 | 低配ECS 起步 1000元/年 | 至少满足： 1.双核 8GB内存 100GB硬盘 2.云服务器 Window 操作系统 |
| 域名 | 需通过域名访问 | ICP备案 | 起步 39元/年 | 备案审核时间 10~31个工作日（可以使用内网穿透软件替代，但是如果是接入企微自建应用，会导致域名归属权校验不通过） |
| SSL证书 | 需支持HTTPS协议 | 域名 | 可免费 起步 45元/年 | 如果使用的是阿里云域名，可以使用自动证书-https插件进行免费自动续签 |
| 短信服务 | 需要发送验证码 | - | 0.039~0.08元/条 | 国内短信价格，量越大越便宜 |
| 微信服务号 | 与服务号/公众号联动 | 域名/ 微信服务号/ 微信开放平台 | 服务号：300元/年 微信开发平台：300元 | 服务号是每年都要交钱 微信开放平台 是一次性的认证费用； |
| 企微（服务商代开发） | 多组织版本集成企微 | 域名/ 企微服务商账号 | 1~5元/账号/年 | 当超过一万个账号时，可与企微客服面议价格 |
| 企微（企业内部开发） | 单组织版本集成企微 | 域名 | 免费 | 这里的域名必须是：，否则无法通过域名校验 ，否则企微不允许接口调用 |
| 钉钉（企业内部应用） | 集成钉钉 | 域名 | 免费 | 不同钉钉版本调用量不一样，点击查看详情 |
| 微信小程序 | 封装为小程序访问 | 域名/ SSL证书 | 起步 19.9元/月 账号认证费用：300元/年 | 1.仅当使用 微信云计算 时，会有小程序费用；2.非个人主体账号必须认证，此过程存在审核费用 |
| 地图服务 | 需使用会众云定位控件 | 域名/ SSL证书 | 可免费； 配额提升：300元/12万次； 配额包月：2~6万元/月 | 百度地图有免费额度，可以先使用免费额度，然后追加流量包（企业版需要每年5万认证费用） 苹果手机要求必须使用https才能访问 |
2.部署后须知
部署会众云平台后的须知事项如下
2.1.运行时须知
会众云平台部署后，是通过 联网授权 校验的。如果您的服务器无法访问外网，则会导致授权失败，使部署的会众云服务 无法启动。
特别说明
即便 已经完成授权，在运行过程中，也 不可断开网络 ，否则会使部署的服务 无法通过联网校验 ，此类校验是 不定时 的。
未通过校验时，依然会导致会众云服务停止服务。
2.2.针对本地内网部署
此类部署方式一般只可在内网访问，若需外网访问，则需要依赖 内网穿透/第三方域名解析 软件来提供外网的访问服务。
此类工具一般存在免费使用和付费使用的区别。
- 付费使用相较于免费可以获取更稳定的使用体验
- 付费价格
9元/月起。
注意
会众云不提供内网穿透服务，使用此类软件产生的 额外费用 ，请自行控制。
提示
例如 ngork、frp、natapp 等都属于内网穿透工具，可免费，亦可付费。
注意：部分内网穿透工具被微信等平台 封锁，选择工具时需要自行搜集相关信息。
- 例如
natapp，它的全部域名均被微信封锁，无法通过微信访问。
2.3.针对云服务器部署
此类部署方式一般可以支持通过外网访问，但需要注意开放端口和防火墙规则。
特别说明
使用 云服务器 时，不可选用 Window 系统。Window 操作系统仅可在 物理机 / 裸金属服务器 部署。
2.4.使用域名访问服务
当需要使用域名访问服务时，至少满足以下两个条件：
- 您已具有至少一个域名
- 域名已经通过了
ICP备案
关于购买域名
域名的购买可通过云服务商（例如阿里云、华为云、腾讯云等等）购买获得。
通常，云服务器和域名都在 同一个云服务商 上购买
常用云服务商购买域名页面：
域名ICP备案
这是国家强制要求。任何在国内部署使用的服务器和域名，若需通过域名在公网访问，均需要纳入政府管控之下，详情可查阅：⇲工业和信息化部政务服务平台
通常，若域名就在某云服务商购买，那么可以直接在该云服务商上发起ICP备案申请，常用云服务商备案入口：
关于费用
ICP备案均为免费，无需额外费用。
注意
ICP备案 审核时间 通常在 10~31 个工作日，若需使用域名访问，请提前安排备案工作。
2.5.接入微信须知
当存在微信服务号/公众号需要接入会众云平台时，需要查阅此小节
前置条件一：域名
微信接入强制要求使用域名，所以必须先处理域名以及ICP备案的事务
注意
- 请查阅本文的
2.4.使用域名访问服务
前置条件二：服务号
需要提前备置开通服务号，且必须使用企业主体，不可以使用个人主体。
注意
开通服务号费用：300元/年
前置条件三：微信开放平台 & 费用
会众云平台使用微信开放平台的授权模式接入微信服务号，此方式可以避免因多个应用通知绑定服务号导致的冲突问题。
注意
- ⇲接入：微信开放平台
- 微信开放平台必须使用
企业主体注册 - 微信开放平台必须申请
开发者资质 - 申请开发者资质需要费用：
300元。（一次性费用，此后不再付费）
2.6.接入企微须知
当存在 企微微信 需要接入会众云平台时，需要查阅此小节
前置条件：域名
企业微信接入强制要求使用域名，所以必须先处理域名以及ICP备案的事务
注意
- 请查阅本文的
2.4.使用域名访问服务
使用「服务商代开发」方式时的费用如下
企微待开发应用并非买断制付费，而是采用订阅制，费用参考如下：
| 账号数区间 | 基础账号价格 | 互通账号价格 |
|---|---|---|
| 1-5 | 5元/帐号/年 | 50元/帐号/年 |
| 6-200 | 4元/帐号/年 | 40元/帐号/年 |
| 201-500 | 3元/帐号/年 | 30元/帐号/年 |
| 501-1000 | 2元/帐号/年 | 20元/帐号/年 |
| 1001-10000 | 1元/帐号/年 | 10元/帐号/年 |
| 10001及以上 | 面议 | 面议 |
购买账号数可以是 全部成员 也可以是 指定员工。更多详情信息可以查阅：
2.7.接入短信服务须知
如果需要接入短信服务，则需要选择对应的短信服务商，通常选择与云服务商相同的服务商作为短信服务的购买渠道即可。
通常短信费用是按照 xx元/条 来计算，且具备 发得越多，每条价格越便宜 的规则。
以下给出常用云服务商的短信收费规则：
| 云服务商 | 参考价格 | 参考文档 |
|---|---|---|
| 阿里云 | 0.039~0.05元/条 | ⇲国内短信服务定价 ⇲国际/港澳台短信服务定价 |
| 华为云 | 0.0475~0.08元/条 | ⇲计费概述 |
| 腾讯云 | 0.039~0.05元/条 | ⇲计费概述 ⇲价格总览 |
注意
以上均为大陆短信发送规则，如有 国际/港澳台地区短信 的需求，请自行前往对应服务商查阅。
价格预估参考： 通常，非国内地区的短信价格，普遍为国内地区短信价格的 10倍 及以上。
2.8.接入微信小程序
如需要将会众云平台封装为小程序访问，需要知悉以下内容。
账号性质
必须使用 企业主体账号 作为微信小程序的 开发/发布者账号 。
域名 / SSL证书
服务器 必须 具备域名，且 只能 使用 https协议 。
即，同时存在两项额外费用：域名 、SSL证书。
微信云计算 / 微信云开发
如果该小程序除了接入会众云以外，存在其他功能涉及到了 微信云计算 / 微信云开发 模块，则会存在额外费用。
- 云服务计费预估至少：
19.9元/月
提示
若仅仅是封装会众云平台为微信小程序，则是 免费 发布的。
2.9.接入地图服务
如果需要使用会众云平台的地图插件，需要自行接入地图
注意
会众云平台只是地图服务的 使用者，会众云平台本身 不提供地图服务！！！
会众云平台只是地图服务的 使用者，会众云平台本身 不提供地图服务！！！
会众云平台只是地图服务的 使用者，会众云平台本身 不提供地图服务！！！
特别说明
IOS 只支持 「HTTPS」 调用地图控件！！！
IOS 只支持 「HTTPS」 调用地图控件！！！
IOS 只支持 「HTTPS」 调用地图控件！！！
若需要支持IOS系统的使用，则必须同时接入 域名，并申请 SSL证书 。
- 此两项综合费用至少
39元/年，通常为84元/年。
根据所选地图服务商不同，计费规则如下：
| 提供商 | 参考价格 | 备注 & 参考文档 |
|---|---|---|
| 天地图 | 免费 | 政府提供的地图服务 但数据很老，定位很飘 |
| 百度地图 | 配额提升：300元/12万次； 配额包月：2~6万元/月 | 会带有免费的配额 免费配额用完后，则需要购买配额流量包 ⇲配额流量包购买入口 |
3.部署后操作
部署会众云平台后，可以进行以下操作
3.1.创建组织
平台部署完成后，点击工作台上的+号创建组织
注意
必须使用申请授权时提供的公司名称创建组织，否则无法创建
多组织版本新开组织操作路径：个人中心/我的组织/创建组织
3.1.后台配置
平台部署完成后，修改访问路径即可进入后台管理页面（仅初始管理员有操作权限）
修改方式说明
假设访问地址为：http://192.168.31.168:2020/apaas/workbench
则将地址修改为：http://192.168.31.168:2020/apaas/admin
提示：/apaas/ 后面修改为 admin
3.2.企业形象
进入后台配置后，可以开始配置企业形象，支持修改：Logo、背景、Icon，等所有和品牌相关的配置
特别说明
需要先获得授权，才能进行配置
3.3.组织管理
进入后台配置后，如果是多组织版本，可以配置每个组织单独的：Logo、Icon，人数，等配置信息
特别说明
除特殊版本外，不支持动态修改组织人数，修改组织形象需要先获得授权
3.4.系统配置
进入后台配置后，系统配置支持以下配置项目
基础配置
短信配置
微信开放平台
企业微信
注意
如果是
企微自建应用，则不需要配置代开发相关配置如果您的服务没有公网IP，则可以配置
代理服务器地址，通过代理服务器转发请求
插件配置
3.5.管理工具
进入后台配置后，系统给初始管理员提供了多种特权功能，例如：可以不进行任何校验直接修改指定账号的密码
3.6.数据迁移
当需要将会众云服务迁移到不同的服务器时，可以使用以下方式
注意：迁移需要获得授权，否则迁移后服务无法使用
特别说明
迁移前一定要停止运行会众云服务，否则一定会出现：数据损坏并无法启动数据库！！！
迁移前一定要停止运行会众云服务，否则一定会出现：数据损坏并无法启动数据库！！！
迁移前一定要停止运行会众云服务，否则一定会出现：数据损坏并无法启动数据库！！！
停止运行会众云：docker stop hzy-main
bash
# 将远程服务器192.168.1.1的会众云数据同步到本地
rsync -rv --delete root@192.168.1.1:/var/hzy/ /var/hzy/3.7.查看运行日志
特别说明
运行日志包括：微服务程序运行过程中的数据库操作、接口请求、后台操作等日志
例如：工作流运行在
数据服，查看数据服日志可以看到详细的流程执行情况
以下为日志查看步骤
bash
# 进入会众云主服务容器内部
docker exec -it hzy-main bash
# 进入日志文件夹
cd /root/log
# 查看全部日志文件（有.backup结尾：昨天的日志，无.backup结尾：当天最新日志）
ls -lah
# 例如：查看数据服的日志（-n500 表示：查看最近500行的日志）
tail -f data.log -n500以下为日志功能说明
| 日志文件 | 所属服务 | 包含功能 |
|---|---|---|
| account.log | 账号服 | 登录注册、服务授权等 |
| app.log | 应用服 | 查询应用配置、导入导出应用等 |
| data.log | 数据服 | 查询应用数据、工作流执行等 |
| message.log | 消息服 | 所有通知消息相关 |
| organization.log | 组织服 | OSS相关、查询组织信息,角色,成员等 |
| platform.log | 平台服 | 对应三方平台相关（企微、钉钉等） |
| xlsx.log | 导入导出服 | 导入导出应用数据、成员数据等 |