feat(deploy): 默认安装 ONLYOFFICE 标准组件

This commit is contained in:
Cheng Zhou
2026-07-16 17:09:12 +08:00
parent 3e77127687
commit 1837ceff58
8 changed files with 128 additions and 52 deletions
+5 -5
View File
@@ -9,7 +9,7 @@
- 生产入口:`docker-compose.yaml`
- 初始化方式:`docker compose run --rm --build backend-init`
- 启动方式:`docker compose up -d --build`
- 运行拓扑:`nginx``backend``db`
- 运行拓扑:`nginx``backend``db``onlyoffice`
- 对外入口:`nginx` 提供前端静态资源,并同域反代后端 API
- 数据库 schema 来源:Alembic migration,不再依赖 `database/init.sql`
- 默认无任何业务预置数据;生产初始化只确保固定管理员 `admin@huapont.cn / admin123` 存在
@@ -50,11 +50,11 @@
- Web 与桌面端共用产品版本;执行 `npm run version:set -- <version>` 统一升级,执行 `npm run version:check` 检查漂移。
- 桌面端与 Web 端从同一发布标签和 Git 提交构建,具体流程见 `docs/guides/client-release.md`
## ONLYOFFICE 开发预览
## ONLYOFFICE 标准组件
- 普通开发环境仍不强制启动 Document Server
- 需要 Office 只读预览时执行 `bash scripts/onlyoffice-dev-up.sh`
- 脚本会自动生成并持久化本机开发密钥,不需要手工填写;详细说明`docs/guides/onlyoffice-preview.md`
- `./install.sh``bash scripts/install.sh dev|main|release` 默认生成独立 JWT、持久化实例标识并启动 Document Server,不再需要额外启用 Compose profile
- `bash scripts/onlyoffice-dev-up.sh` 仅保留为开发环境重建、健康验证和密钥轮换入口;普通安装无需再执行
- 默认镜像、字体、安全配置和生产许可要求`docs/guides/onlyoffice-preview.md`
## 仓库治理文档
- 分支治理规范:`docs/branch-governance.md`