解决docker中文乱码需在镜像构建阶段同步配置utf-8 locale（如run locale-gen c.utf-8）、安装中文字体（如fonts-wqy-microhei）、加固应用编码（如java_opts=-dfile.encoding=utf-8），三者缺一不可。
在 dockerfile 中解决中文乱码，核心不是“临时打补丁”，而是从镜像构建起就配齐语言环境、字体支持和应用编码三要素。只改 env lang 很难生效，必须同步生成 locale、安装中文字体、加固 jvm/python 等运行时行为。
配置 UTF-8 语言环境（必须生成，不能只设变量）
基础镜像通常不带中文 locale 数据，仅设 ENV LANG=C.UTF-8 不够——系统根本没生成对应 locale 文件。
- Debian/Ubuntu 类镜像（如 openjdk:17-jre-slim）： RUN apt-get update && apt-get install -y locales && \ locale-gen C.UTF-8 && \ update-locale LANG=C.UTF-8 LC_ALL=C.UTF-8 ENV LANG=C.UTF-8 LC_ALL=C.UTF-8
- Alpine 镜像（如 openjdk:17-jre-alpine）： RUN apk add --no-cache tzdata musl-locales && \ cp /usr/share/locale/C.UTF-8/LC_ALL /etc/locale.conf ENV LANG=C.UTF-8
注入可用的中文字体（有编码没字体 = 方块/问号）
即使 locale 正确，没有字体仍无法渲染中文。优先选用开源无版权风险字体（如文泉驿系列）。
OpenClaw Docker Setup
下载
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- Debian/Ubuntu 容器： RUN apt-get update && apt-get install -y fonts-wqy-microhei fonts-wqy-zenhei && fc-cache -fv
- Alpine 容器： RUN apk add --no-cache fontconfig ttf-dejavu ttf-droid ttf-freefont && fc-cache -fv
-
验证是否成功： 进容器执行
fc-list :lang=zh，有输出即注册成功
加固应用层编码行为（系统级设置 ≠ 应用自动识别）
Java、Python 等运行时默认不继承系统 locale，需显式指定 UTF-8 编码。
-
Java 应用：
ENV JAVA_OPTS="-Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8"
或启动命令中加：
java $JAVA_OPTS -jar app.jar -
Python 应用（尤其 Python 2）：
在源文件首行加：
# -*- coding: utf-8 -*-Python 3 虽默认 UTF-8，仍建议显式声明 -
Nginx 等 Web 服务：
在配置中强制 charset：
charset utf-8;（写入 nginx.conf）
快速验证三步法（构建后必做）
镜像构建完成，启动容器后立即执行以下命令确认效果：
-
locale→ 检查LANG和LC_ALL是否为C.UTF-8或zh_CN.UTF-8 -
fc-list :lang=zh→ 确认有中文字体路径输出 -
echo "中文测试" | iconv -f utf-8 -t utf-8 >/dev/null && echo ok→ 验证编码链路无转换错误
