e家宜业智慧物业平台 5 分钟本地部署指南:Web 中台 双端小程序一次跑通【免费下载链接】ejyy「e家宜业」是一套开源智慧物业解决方案基于nodejs、typescript、koa、vue开发包含web中台、业主小程序、员工小程序、公众号、物联网应用等涵盖业主服务、物业运营、智能物联、数据统计等功能。项目地址: https://gitcode.com/gh_mirrors/ej/ejyy想在本地搭一套能真实跑起来的物业系统,而不是对着静态 Demo 发呆?「e家宜业」(ejyy) 就是这个场景的合适选择——它是一套基于 Node.js、TypeScript、Koa 和 Vue 开发的开源智慧物业解决方案,覆盖 Web 中台、业主小程序、员工小程序、公众号和物联网应用,把业主服务、物业运营、智能物联、数据统计装进同一套代码里。看完本文,你能在本地启动 API 服务与 Web 中台,并用微信开发者工具打开业主端、员工端两个小程序,看到真实的运行页面。环境自检清单:Node、MySQL 与 Redis 一次备好e家宜业 的后端强依赖 MySQL 和 Redis,Web 中台又基于较老版本的构建链,所以这一节的意义是:动手前确认地基是平的,避免装到一半报错再回头折腾。依赖建议版本用途Node.jsv14 – v16API 服务与 Web 中台运行构建npm≥ 6.9依赖安装Git任意新版拉取项目代码MySQL5.7业务数据存储Redis6.x缓存与 Session微信开发者工具任意新版调试业主/员工两端小程序在终端里跑下面这组命令,输出版本号即代表自检通过:node -v npm -v mysql --version redis-server --version⚠️ 不建议直接用 Node 18:项目构建链较老,高版本 Node 容易在打包阶段报 OpenSSL 相关错误。克隆仓库并给四个模块装上依赖这一步的目标是把代码落到本地,并只给真正有 npm 依赖的模块装依赖——两个小程序本身没有需要安装的运行时依赖,直接跳过即可。先获取代码:git clone https://gitcode.com/gh_mirrors/ej/ejyy cd ejyy四个模块的依赖情况一览:模块路径依赖安装命令API 服务api-server/cd api-server npm installWeb 中台console-web/cd console-web npm install业主小程序owner-mp/无需安装,直接进微信开发者工具员工小程序property-mp/无需安装,直接进微信开发者工具配置要点:只需手写一份 .ejyyrce家宜业 的 API 服务启动时会从当前目录读取 yaml 格式的.ejyyrc,仓库里没有提供这个文件,所以你要在api-server/目录下手动新建一份,写清 MySQL 与 Redis 的连接信息(数据库需提前建好空库,库名填进database字段)。mysql: host: 127.0.0.1 port: 3306 user: root password: 你的MySQL密码 database: ejyy redis: host: 127.0.0.1 port: 6379 password: server: port: 6688其余配置项可以全部不动:微信 appid、阿里云 OSS、地图 key、smtp 等字段留空不影响本地启动;console-web/vue.config.js 里的接口代理默认就指向127.0.0.1:6688,与上端口一致时无需修改。两条命令跑起中台,浏览器验证 8080 端口服务起来之后,你能在浏览器里看到 e家宜业 中台的真实登录页,这是判断部署是否成功的直接依据。开两个终端,分别执行:# 终端一:启动 API 服务 cd api-server npm run dev # 终端二:启动 Web 中台 cd console-web npm run dev启动成功后:终端一应输出 6688 端口监听日志,若看到「未检测到配置文件,程序退出」,说明.ejyyrc没放对位置;浏览器访问http://localhost:8080,会先出现登录页,登录后可进入控制台首页,大致长这样:进阶体验:微信开发者工具打开双端小程序Web 中台跑通后,物业系统的另一端体验在小程序里——业主侧和员工侧各有完整的功能页面,无需改动代码即可预览。打开微信开发者工具,选择「导入项目」,目录分别指向owner-mp/src和property-mp/src(AppID 可以选测试号);把 owner-mp/src/config.js 和 property-mp/src/config.js 里的API_HOST改为http://127.0.0.1:6688;在开发者工具「详情 → 本地设置」中勾选「不校验合法域名、TLS 版本以及 HTTPS 证书」,因为本地是 HTTP 直连。两端小程序的效果参考:常见坑与排查:配置文件、端口占用与 Node 版本 踩坑不可怕,知道怎么绕过去就行。本地部署 e家宜业 时最常遇到下面三种情况:API 启动即退出,提示「未检测到配置文件,程序退出」:.ejyyrc必须放在api-server/目录下(即npm run dev的执行目录),且是 yaml 格式,缩进用空格。8080 或 6688 端口被占用:Web 中台可用npm run dev --port 8081换端口,同时把 vue.config.js 代理指向 6688 的写法保持不变;API 端口则在.ejyyrc的server.port里修改,改完记得同步代理地址。Node 18 下构建报 OpenSSL/md4 相关错误:降级到 Node v14–v16 后删除node_modules重新安装依赖。更多业务页面截图与项目说明可参考仓库内的 README.MD;项目采用 AGPL v3 协议开源,二次分发或商用前记得留意协议条款。【免费下载链接】ejyy「e家宜业」是一套开源智慧物业解决方案基于nodejs、typescript、koa、vue开发包含web中台、业主小程序、员工小程序、公众号、物联网应用等涵盖业主服务、物业运营、智能物联、数据统计等功能。项目地址: https://gitcode.com/gh_mirrors/ej/ejyy创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考