一条完整的 Overleaf PDF 编译链路指南从 LaTeX 源码到浏览器预览【免费下载链接】overleafA web-based collaborative LaTeX editor项目地址: https://gitcode.com/GitHub_Trending/ov/overleaf按下重新编译按钮后Overleaf PDF 链路其实已经开工前端把整个项目的文件打包发给 CLSI 编译服务LaTeX 工具链在容器里跑完PDF 再回到浏览器里。这篇文章就跟着这一条编译请求走看看它经过的三站CLSI 编译、Filestore 存储、浏览器预览。第一站编译暗房CLSI可以把 CLSI 理解成一家暗房它不写稿只负责把你送来的底片LaTeX 源文件冲洗成成品PDF再还给你。代码都在 services/clsi/职责边界很清楚——收请求、调 LaTeX 工具链、出结果三件事不越界。编译全流程从请求到 PDF 的五步对应到代码里services/clsi/app/js/ 目录下的RequestParser.js负责校验请求每个文件必须带路径要么给内容、要么给下载地址主文档路径默认main.texCompileController.js编排整体流程LatexRunner.js调用 latexmk 驱动具体编译器。端口与编译参数三个端口各管一件事CLSI 一个进程开三个端口分工互不干扰TCP/3013REST API接收编译请求POST /project/:project_id/compile、停止编译、查询状态TCP/3048负载汇报负载均衡器连上来时CLSI 返回当前剩余负载百分比让它决定要不要把新项目分过来TCP/3049服务控制提供/state/up、/state/down、/state/maint接口可随时把服务切到接单或维护状态。编译行为主要由环境变量控制定义集中在 services/clsi/config/settings.defaults.cjs参数作用默认值TEXLIVE_IMAGE指定 TeX Live 编译环境镜像沙箱编译时生效quay.io/sharelatex/texlive-full:2017.1SANDBOXED_COMPILES是否用 Docker 容器执行编译命令仅 Server Pro 可用默认不启用PROCESS_LIFE_SPAN_LIMIT_MSCLSI 进程存活上限到期后拒绝新编译防止实例老化2 天COMPILE_SIZE_LIMIT编译请求体的大小上限7mb编译器相当于选印刷工艺默认pdflatex也可以指定xelatex、lualatex仓库里还保留了latex。文档里中文或 Unicode 字符多选xelatex通常更省心。第二站PDF 存放在哪暗房冲好的照片交给谁保管CLSI 只管编译工作区不管长期存储。项目源文件、上传的图片、生成后的 PDF统一归 services/filestore/ 下的 Filestore 服务管——它更像全站的收发室凡是存和取都走它。拆开存的原因很实在编译机可以随便替换文件不能丢。如果 PDF 跟着 CLSI 存在一起每次扩容、迁移机器都得拖着数据跑交给 Filestore 后CLSI 随时扩缩容、故障重建文件都原地不动。编译前CLSI 从 Filestore 拉取项目源文件编译产出的 PDF 与日志经 web 服务侧归档入库。前端要展示时再按文件名向 Filestore 取件——收发室有台账找起来不费劲。第三站PDF 如何出现在浏览器里前端预览的代码在 services/web/frontend/js/features/pdf-preview/用 pdf.js 渲染 PDF有三个点值得说实时渲染编译一结束预览面板就换上新的 PDF左边继续敲代码右边马上见结果不用手动刷新。缩放范围 25%–400%从整页概览到放大抠一个公式 工具栏的缩放档位都够用。点击 PDF 跳转源码这不是点哪儿算哪儿。编译时 CLSI 会生成 synctex 文件前端通过/project/:Project_id/sync/pdf和/sync/code两个接口在 PDF 位置和 LaTeX 源码位置之间双向跳转。两个容易卡住的地方编译超时先看两个数字每笔编译请求自带timeout选项默认 600 秒服务端最高也只按 600 秒封顶HTTP 层的请求超时则放宽到 630 秒。文档常规编译就会超时最稳的办法是拆章节单独编译把单次编译的活干小自托管部署时如果请求体过大被拒再考虑调大COMPILE_SIZE_LIMIT。换编译器改一个字段就行编译请求里把compiler字段改掉即可示例{ compile: { options: { compiler: xelatex }, rootResourcePath: main.tex } }rootResourcePath指定入口文件不写的话默认就是main.tex。收尾整条链路其实就是三份工CLSI 管怎么编Filestore 管存哪去前端管怎么显示。每个服务能独立扩缩容谁卡住了也不连累别人——这正是 Overleaf PDF 处理链路拆成多个微服务换来的好处。想继续深入可以从 services/clsi/README.md 和 services/filestore/README.md 接着读。【免费下载链接】overleafA web-based collaborative LaTeX editor项目地址: https://gitcode.com/GitHub_Trending/ov/overleaf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考