123marvin123/typst

Typst Docker镜像

概述

这是一个非官方的Typst精简版Docker镜像，基于Debian系统构建，仅包含预编译的Typst-CLI（排版命令行工具）。

注意：镜像中未安装任何额外字体。如需使用系统字体，请参考"使用主机系统已安装字体"部分，或使用Typst可执行文件中内置的字体。

核心功能与特性

• 精简轻量：仅包含Typst-CLI核心组件，无冗余依赖
• 跨平台兼容：基于Debian系统，可在任何支持Docker的环境中运行
• 灵活字体支持：支持挂载主机系统字体，满足个性化排版需求

使用场景

• 需要在隔离环境中进行Typst文档排版的场景
• 避免本地环境差异导致排版结果不一致的场景
• 快速部署Typst环境进行临时文档编译的场景

使用方法

运行镜像

通过以下命令启动Typst容器，将当前目录挂载到容器内的/root目录：

bash
docker run --name typst -v $(PWD):/root -it 123marvin123/typst

在容器环境中，可像常规使用Typst命令，例如编译文档：

bash
typst compile thesis.typ

使用主机系统已安装字体

Debian基础镜像不包含额外字体，可通过以下两种方式使用主机系统字体：

方法1：将系统字体挂载到/usr/share/fonts

直接将主机字体目录挂载到容器的/usr/share/fonts（只读模式），Typst会自动识别：

macOS示例：

bash
docker run --name typst -it -v /System/Library/Fonts:/usr/share/fonts:ro 123marvin123/typst

方法2：挂载到任意位置并配置环境变量

将字体目录挂载到任意位置（如/root/fonts），通过TYPST_FONT_PATHS环境变量指定字体路径：

macOS示例：

bash
docker run --name typst -it -v /System/Library/Fonts:/root/fonts:ro --env TYPST_FONT_PATHS=/root/fonts 123marvin123/typst

注：环境变量配置仅需在创建容器时设置一次。