精选优惠 · 官方会场

轻量应用服务器

新用户专享

2核2G · 200M峰值带宽 · 40G系统盘

限阿里云新用户
68元/年限阿里云新用户
立即选购

云服务器 ECS

新老同享

经济型e · 2核2G · 3M固定带宽 · 40G盘

同主体限1台 · 不可叠券
99元/年同主体限1台 · 不可叠券
立即选购

云数据库 RDS

数据库精选

托管数据库 · 弹性扩容 · 自动备份

按地域与配置选择
查看活动价按地域与配置选择
查看优惠
更多阿里云活动收起阿里云活动
11月1日—30日企业至高减 1728 元

双11满减礼包

个人至高减360元;需对应实名认证,满减门槛及适用产品以官方规则为准。

前往官方会场
AI 专场让 AI 应用轻松上云

AI 产品特惠

浏览 Token Plan、Qoder 与 AI 应用等官方活动,按实际使用需求选择。

前往官方会场
搭配更省心服务器 + 数据库

云产品组合购

查看 ECS、RDS 等组合活动,按业务规模和实际预算搭配。

前往官方会场
官方活动合集热门云产品,一站选

云小站更多特惠

继续查看服务器、数据库与存储等优惠,选择适合自己的配置。

前往官方会场

阿里云服务器字体安装、排错与授权要点

网页在本地显示正常,部署到阿里云服务器后却出现中文方框、字体变形,或导出的 PDF 排版错乱,原因未必在业务代码。很多服务器使用精简版 Linux 镜像,默认没有安装常用中文字体;程序找不到指定字体时,可能改用其他字体,也可能无法显示部分字符。

浏览器截图、图片合成、PDF 导出、报表生成和图表绘制,都可能调用操作系统里的字体文件。替代字体的字宽、字重不同,除了影响观感,还可能让表格换行、分页和图片布局发生变化。配置阿里云服务器字体时,要确认字体已安装、系统能够识别、应用有权限读取,并且字体许可适用于当前用途。程序如果运行在 Docker 容器中,容器里也要有字体;只在宿主机安装,通常不能解决容器内的显示问题。

先确认系统与问题范围

登录实例后,先查看操作系统版本,例如执行 cat /etc/os-release。再用 fc-list :lang=zh 检查系统已识别的中文字体。如果提示找不到命令,可能是尚未安装 fontconfig;如果命令可以运行但没有列出中文字体,则要继续检查字体文件和缓存。

还要分清系统缺字体,还是应用没有调用到已安装的字体。字体文件名、字体内部名称和程序配置里填写的名称可能不一致。可以先通过 fc-list 查看系统识别结果,再核对应用或渲染库要求的字体名称。仅凭文件名判断是否匹配,容易把问题留到运行时才发现。

安装中文字体的常见方式

通过系统软件源安装

如果发行版的软件源提供合适的中文字体包,通常可以优先使用系统包管理器安装,后续维护和升级也更方便。Debian、Ubuntu 通常使用 apt;Alibaba Cloud Linux、CentOS 系列通常使用 yum 或 dnf。先搜索当前软件源中的字体包,再根据系统版本选择字体和 fontconfig。包名会因发行版版本和软件源配置而不同,不要直接照抄另一台服务器上的命令。

安装后执行 fc-cache -f -v 刷新字体缓存,再运行 fc-list :lang=zh 确认系统能列出中文字体。若依赖字体的应用一直在运行,按服务部署方式重启进程,让它重新读取字体配置。只刷新缓存却不重启应用,有时仍会看到旧的渲染结果。

手动安装字体文件

软件源没有所需字体时,可以上传已获授权的字体文件。常见的系统级目录是 /usr/share/fonts,也可以按实际需求安装到特定用户的字体目录。建议为项目建立独立子目录,并记录字体来源、版本和授权范围,方便后续排查和更新。

上传后检查文件及上级目录的读取权限,再执行 fc-cache -f -v。通常应用只需要读取字体,不必给字体目录开放写权限。选择字体时,也要确认程序支持相应格式,并查看随附的许可说明。字体的下载许可、服务器端使用许可,以及用它生成图片或文档后的分发许可,可能不是一回事;来源不明或授权范围不清楚的字体,不宜直接用于商业网站和生产系统。

报表导出的中文为什么会变成方框

例如,某企业把 Java 报表服务部署到阿里云 Linux 实例后,英文显示正常,PDF 里的中文却成了方框。开发环境使用桌面系统,预装了中文字体;生产环境采用精简镜像,没有对应字库。排查时,先用 fc-list 确认实例上没有可用的中文字体,再安装经确认适用于该业务的字体,刷新缓存并重启报表服务。

字体安装后,中文仍未正常显示。继续检查发现,报表配置填写的是字体文件名,而渲染库需要的是字体内部名称。调整配置后问题才解决。处理这类故障时,要分别确认系统或运行环境里有字体,以及应用能够按正确名称调用它。上线前可以抽查中文、数字、标点和特殊字符,并检查 PDF 的对齐、换行和分页是否符合预期。

Docker、权限与缓存排错

  • 容器内找不到字体:在镜像构建阶段安装字体,或把字体文件和相关配置纳入镜像。宿主机已安装,并不代表容器里的程序可以使用。
  • 应用用户无法读取:检查字体文件及上级目录的权限,确认服务运行用户有读取权限。一般不需要开放写权限。
  • 新增字体后效果没变:运行 fc-cache -f -v 刷新缓存,并按应用的运行方式重启相关进程。
  • 配置了字体仍然报错:用 fc-list 查看系统识别的名称,再按应用或渲染库的要求填写,不要只根据文件名配置。
  • 线上与本地版式不同:核对字体版本、应用依赖、浏览器或渲染引擎版本,以及容器镜像。把字体和配置纳入部署流程,比在不同环境中临时补文件更容易保持一致。

把字体配置纳入部署流程

生产环境里,字体安装不应依赖运维人员临时登录服务器操作。可以在初始化脚本或镜像构建流程中记录系统版本、字体包或文件版本、安装位置、验证命令和授权信息。部署后检查关键字体是否可见;如果字体文件较大,也要考虑镜像体积和后续更新成本。不同环境随意替换字体,可能让网页、图片和文档版式发生变化。

阿里云服务器不会替应用自动选好合适的字体。遇到中文方框或排版异常,可以依次检查系统是否识别字体、应用名称是否匹配、服务用户是否有读取权限、缓存是否刷新,以及字体是否安装在实际运行环境中。按这几项逐一排查,通常比先改业务代码更容易定位问题。

赞 (0)
上一篇 2026年11月15日 上午6:52
下一篇 2026年11月15日 上午6:52

相关推荐

  • 阿里云服务器怎么选、怎么用?从购买到上线的实用指南

    第一次买云服务器,常会同时遇到几个问题:配置怎么选、订单怎么买、网站买完后怎么上线?如果只盯着推荐配置或首购价格,可能买得过高,也可能因内存、磁盘或带宽不足影响运行。动手前先弄清用途,再按购买、部署和检查的顺序处理,会更稳妥。 先明确服务器要跑什么 个人博客、测试环境和小型展示站,通常不需要很高的计算资源;电商系统、数据库服务或多人同时使用的业务,则要更多关…

    云服务器 2026年11月15日
  • 阿里云服务器域名解析怎么加A记录,解析不生效先查什么

    买好阿里云服务器后,很多人第一步就卡住:域名到底怎么指向这台机器。网站打不开、访问跳转出错、邮件收不到,多数时候都和域名解析有关。下面按实际操作顺序讲:先弄清解析在做什么,再添加记录,最后遇到解析不生效时按什么顺序排查。 先弄清域名解析在做什么 可以把 DNS 想成一本通讯录。访问者在浏览器里输入 example.com,DNS 负责查到它对应的 IP 地址…

    2026年11月1日
  • frp阿里云服务器怎么部署?配置步骤与安全要点要留意

    家里的开发环境、办公室测试服务需要临时从外网访问时,可以用 frp 建立内网穿透。常见做法是在有公网 IP 的阿里云服务器上运行 frps,在内网设备上运行 frpc,由内网设备主动连接云服务器,再把指定端口的访问转发到本地服务。 这种方式不需要给内网设备配置路由器端口转发,适合远程查看开发页面、临时演示网页或连接测试环境。不过,流量能转发,不代表服务已经具…

    云服务器 2026年11月15日
  • 云服务器试用一个月多少钱?先看免费额度再算付费

    很多人想把小网站或测试项目先放到云上跑一跑,第一句问的往往是:云服务器试用一个月多少钱?这个问题没有统一答案。同一台机器,在不同厂商、不同活动期间,账单可能差出好几倍。先弄清试用政策怎么算,再结合自己的用法估算,比只盯着一个标价更实际。 试用通常是哪几种形式 主流云厂商的试用大致有三类。第一类是新用户免费额度,给一定时长的入门实例,比如每月若干小时的低配机器…

    2026年10月30日
  • 阿里云服务器交换前,先确认是迁移还是更换配置

    用户说“阿里云服务器交换”时,实际要做的事情可能完全不同:有人只是想提高 CPU 或内存配置,有人需要把业务从旧 ECS 搬到新 ECS,也有人只想调整公网 IP、负载均衡或服务器所在地域。几种方案涉及的操作、费用和风险都不一样。目标没有确认清楚就直接动手,可能遇到数据误删、业务中断,或者新实例已经买好,却无法直接接管原来的访问地址。 可以把这类需求分成三种…

    云服务器 2026年11月15日
返回顶部