Docs 如何构建不含 GPL 组件的 MIT 合规前端镜像（PUBLISH_AS

Docs 如何构建不含 GPL 组件的 MIT 合规前端镜像PUBLISH_AS_MIT【免费下载链接】docsDocs is an open-source text editor: web-native, made for real-time collaboration, cleanly structured documents and sub-documents with full ownership of your data. Built to scale with Django and React.项目地址: https://gitcode.com/GitHub_Trending/docs150/docsDocs 主项目以 MIT 许可发布见 LICENSE 中 License 一节的说明但部分高级功能依赖 BlockNote 的 XL 系列包这些包是 GPL 许可、与 MIT 不兼容。如果你的分发形态要求整个产物保持 MIT 合规就需要在构建前端时用PUBLISH_AS_MIT把这几个包从产物中剔除。README.md的 Self-hosting 一节明确给出了这一做法PUBLISH_AS_MITtrueThis builds an image of Docs without non-MIT features.构建一个不含非 MIT 功能的 Docs 镜像。本文给出两条按文档可执行的构建路径Docker 构建镜像和 yarn 直接构建以及如何核对构建结果。PUBLISH_AS_MIT 会移除哪些包documentation/env.md 的 impress-frontend image 一节列出了与 MIT 许可不兼容的包xl-docx-exporterGPLxl-pdf-exporterGPLxl-multi-columnGPL。对应到产品功能就是 DOCX/PDF 导出和多栏布局README.md在警告框中举的例子正是 Export as PDF。PUBLISH_AS_MIT的默认值是trueenv.md 中该选项的默认值列即默认构建产物就是 MIT 合规的。需要注意官方 CI 构建发布镜像时是显式传了PUBLISH_AS_MITfalse的见 .github/workflows/ghcr.yml 和 .github/workflows/docker-publish.yml 中的build-args仓库自带的compose-e2e.yml与开发用compose.ymlfrontend-development服务同样传false。也就是说官方发布镜像和开发环境都是全功能版需要 MIT 合规产物时必须自己构建。路径一用 Docker 构建生产前端镜像PUBLISH_AS_MIT在 src/frontend/Dockerfile 的impress-builder阶段以ARG接收并转成 Next.js 的NEXT_PUBLIC_PUBLISH_AS_MIT环境变量后执行yarn buildARG PUBLISH_AS_MIT ENV NEXT_PUBLIC_PUBLISH_AS_MIT${PUBLISH_AS_MIT} RUN yarn build因此构建命令按 env.md 给出的形式在仓库根目录Dockerfile 的 COPY 路径./src/frontend/...都相对于仓库根Compose 文件也统一使用context: .执行docker build -f src/frontend/Dockerfile --target frontend-production --build-arg PUBLISH_AS_MITtrue docs-frontend:latest说明--target frontend-production是最终运行阶段nginxinc/nginx-unprivileged:alpine3.23把构建产物复制到/app并由 nginx 提供--build-arg只影响 builder 阶段的yarn build。env.md 中的官方示例命令写的是--build-arg PUBLISH_AS_MITfalse那是为了演示这个 build-arg 的用法要产出 MIT 合规镜像就传true与默认值一致。如果你要构建的是开发镜像target 换成impress-devcompose.yml中开发服务用的就是它且该服务固定传了PUBLISH_AS_MIT: false因为开发环境需要测试全部功能——env.md 也说明.env.development中该变量为false。路径二不用 Docker直接用 yarn 构建env.md 给出第二条路径构建前端应用时可以编辑 src/frontend/apps/impress/.env也可以用NEXT_PUBLIC_前缀的环境变量覆盖。生产构建用的.env中已经是NEXT_PUBLIC_PUBLISH_AS_MITtrue所以直接在仓库中执行生产构建即为 MIT 合规产物cd src/frontend/apps/impress NODE_ENVproduction yarn build如果你需要临时改成全功能版例如验证 GPL 功能行为按 env.md 的示例用环境变量覆盖cd src/frontend/apps/impress NODE_ENVproduction NEXT_PUBLIC_PUBLISH_AS_MITfalse yarn build.env.development与.env.test中该值均为false本地开发与测试默认全功能不需要改动。构建结果如何核对文档没有给出专门的检查命令但加载机制在前端源码里是明确的这些模块只有在NEXT_PUBLIC_PUBLISH_AS_MIT false时才会被打包进应用。以导出功能为例src/frontend/apps/impress/src/features/docs/doc-export/hooks/index.ts 的逻辑是let modulesExport undefined; if (process.env.NEXT_PUBLIC_PUBLISH_AS_MIT false) { modulesExport { ...useExportAGPL, }; }AI 模块doc-editor/components/AI/index.ts和多栏模块doc-editor/components/xl-multi-column/index.ts也是同样的条件加载。因此按文档描述的成功条件是PUBLISH_AS_MITtrue构建出的镜像/应用不含DOCX/PDF 导出、多栏布局以及这些 AI 入口——即 an image of Docs without non-MIT features。反过来功能界面上这些入口消失就是构建生效的表现而不是构建失败。边界与许可提醒如果你在生产环境使用PUBLISH_AS_MITfalse即保留 GPL 包的全功能镜像env.md 明确警告make sure you fulfill your BlockNote licensing or subscription obligations确保你履行 BlockNote 的许可或订阅义务。各文档对 XL 包的许可表述存在出入UPGRADE.md 3.3.0 条目写的是 licenced under AGPL-3.0而README.md与documentation/env.md写的是 GPL。两者指向的是同一组 XL 包具体许可文本以包自带的 LICENSE 为准env.md 中附了 BlockNote 仓库各包 LICENSE 的链接。本变量只作用于前端构建。Docs 的部署方式Kubernetes、Docker Compose、Scalingo 等见 documentation/installation/README.md选择哪种方式不影响上述构建参数的用法。【免费下载链接】docsDocs is an open-source text editor: web-native, made for real-time collaboration, cleanly structured documents and sub-documents with full ownership of your data. Built to scale with Django and React.项目地址: https://gitcode.com/GitHub_Trending/docs150/docs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Docs 如何构建不含 GPL 组件的 MIT 合规前端镜像（PUBLISH_AS_MIT）

相关推荐

Go协程池实现与性能优化全解析

WLED 怎么给 HUB75 矩阵屏选择并烧录对应的构建环境？

如何在 Python 或 TypeScript 应用中直接调用 Cua Driver SDK 而不经守护进程？

更多资讯

Flutter与OpenHarmony跨平台开发实战指南

ms-swift GRPO 训练实战指南：算法原理、Colocate/Async 双模式部署与参数详解

Envoy 降级端点（Degraded Endpoints）：负载溢出机制与 detect_degraded_hosts 源码解析

LiveKit Agents 框架实战指南：构建、运行与测试实时语音 AI 智能体

商丘做建设网站的公司3个最佳实践解决网站被黑

数据库技术演进：从关系型到AI原生的关键突破

今日更新

51单片机开环控制磁阻传感器的硬件匹配与代码实现

AI Agent安全操作数据库：SQL注入防御与参数化查询实战

Android逆向实战：还原激励类App签到接口的签名算法

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？