pnpm 单体仓库怎么装?后端 migrate 与前端 build 怎么串?subpath 部署的 Nginx 怎么配?本文给出可复用的部署 runbook。
XinWork 是 pnpm 单体仓库:backend/(Laravel 13)提供 API 与 SSO,frontend/(React 19)构建后由 Web 服务器托管,packages/ui 是共享组件库。下面是可复用的部署 runbook。
一、后端
cd backend
composer install --no-dev
cp .env.example .env && php artisan key:generate
php artisan migrate --force基座负责用户中心、通知与插件管理;各插件在 backend/plugins/<id>/ 下拥有自己的迁移与路由。


二、前端
cd frontend
pnpm install
pnpm build # vite build,输出 dist/构建产物由 Web 服务器托管;各插件前端放在 frontend/ 对应的插件目录,共享 @work/ui。
三、Web 服务器(subpath 示例)
若用 subpath 部署,前端 base path 与后端路由前缀必须一致(如 /disk/)。Nginx 把 /<prefix>/api 反代到后端,静态资源指向 dist/。
四、SSO 校验
平台 SSO 用 HS256 JWT(iss=platform),由基座的 WS hub 在本地校验,插件间免重复登录。
五、插件同步
插件管理器 sync() 负责登记插件;注意:已存在的平台插件行,其 mode/host/path 不会被 manifest 覆盖,需要改 DB 行或后台 UI。
常见问题
前端和后端是两套部署吗?
是同一单体仓库的两个部分:后端 Laravel 提供 API 与 SSO,前端 React 构建后由 Web 服务器托管。
subpath 部署要注意什么?
前端 base path 与后端路由前缀要一致(如 /disk/),否则静态资源与接口会 404。



评论 (0)
还没有评论,来抢沙发吧。