mirror of
https://github.com/2234839/web-font.git
synced 2026-04-29 21:00:45 +08:00
- 修复 HTTP header 大小写不敏感匹配,解决浏览器上传请求体为空的问题
- 重写 createStreamAfterTarget,修复大文件上传时 body stream 数据流断裂
- 添加 chunked transfer encoding 解码支持
- 读取完 body 后 cancel stream,防止后台循环抛异常炸进程
- 修复 parseHttpRequest 中 split(":") 对含冒号 header value 的错误拆分
- 临时上传同名文件直接覆盖,不再加时间戳前缀
- 移除 tjs (txiki.js) 运行时支持及相关代码
- 安装并配置 vite-plugin-pilot 浏览器测试工具
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
3.5 KiB
3.5 KiB
web font 字体裁剪工具
之前的版本请查看 master 分支,为了能使用 llrt ,我进行了重写,之后只维护此分支
上面的内存占用是空载状态下,在执行字体裁剪时会将字体加载到内存中,所以会占用更多的内存,不过 llrt 也具有 gc 功能,在内存不够用时会自动释放。 虽然 llrt 内存占用低,但它运行速度慢,不到node的1/2。有运行速度要求的建议使用node/bun运行
起因
ui 需要展现一些特定的字体,但直接引入字体包又过大,于是想到了裁剪字体,一开始想的使用「字蛛」但他是针对静态网站的,而且实际他会多出许多英文的,估计是直接将源码中存在的文字都算进去了。后来又找到阿里的「webfont」 但他的字体有限,项目又不开源,所以自己写了这个
在线尝试
目的与功能
1.裁剪字体包使其仅包含选中的字体,其体积自然十分之小 2.另外可以生成 css 直接复制可用,部署在公网便可永久访问 3.支持字体文件上传(临时上传和管理员上传两种模式) 4.支持下载裁剪后的字体文件 5.字体名称支持模糊匹配(精确 > 前缀 > 包含)
安装与使用
使用 node / llrt 等运行时
拉取项目,并将字体文件放到项目内的 font 目录下,然后运行:
pnpm install && pnpm build && pnpm build_backend
node ./dist_backend/app.cjs llrt ./dist_backend/app.cjs
使用 docker 安装
此镜像使用 llrt 运行时
https://hub.docker.com/repository/docker/llej0/web-font 很小的包体积 
docker compose.yml
version: '3'
services:
app:
image: docker.io/llej0/web-font:latest
ports:
- "8087:8087"
volumes:
- ./data:/home/font # 挂载本机字体目录
environment:
- ENABLE_TEMP_UPLOAD=true # 开启临时上传(默认 false)
- TEMP_MAX_FILES=10 # 临时上传最大文件数(默认 10)
- ADMIN_API_KEY=你的管理员密钥 # 设置后开启管理员上传,不设置则不可用
deploy:
resources:
limits:
memory: 900M # 设置内存限制为900MB,根据实际需求来设置
restart: on-failure # 设置重启策略为 on-failure
其中 font 目录替换成你的字体文件存放目录
提供的服务
API 接口
| 接口 | 说明 |
|---|---|
GET /api?font=字体名&text=文字 |
裁剪字体,字体名支持模糊匹配 |
GET /api/fonts |
列出所有可用字体 |
GET /api/config |
获取公开配置(是否开启上传等) |
POST /api/upload?mode=temp |
临时上传字体文件(需开启 ENABLE_TEMP_UPLOAD) |
POST /api/upload?mode=admin |
管理员上传字体文件(需 Authorization: Bearer <API_KEY>) |
上传功能
- 临时上传:设置环境变量
ENABLE_TEMP_UPLOAD=true启用,最多保留 10 个字体文件,超出后自动删除最早上传的(FIFO) - 管理员上传:设置环境变量
ADMIN_API_KEY=你的密钥启用,上传的字体永久保存,需要通过 API Key 认证 - 支持的字体格式:
.ttf.otf.woff.woff2
鸣谢
License
MIT © 崮生
