将Tmux设为Docker Entrypoint导致Unicode字符失效问题排查

问题背景 #

我在2020款MacBook Air M1（Monterey 12.5.1）上构建预装常用工具的终端Docker镜像，希望容器启动后直接进入tmux会话，但遇到字符显示不一致的问题：

• 当ENTRYPOINT设为["zsh"]时，进入容器后手动执行tmux，字符显示正常：
  
  执行tmux后：
  
• 但将ENTRYPOINT改为["zsh", "-c", "tmux"]时，tmux界面字符显示异常：
  

对应的Dockerfile如下：

FROM ubuntu:22.04

ARG USER=ben
ENV GROUP=${USER}
ENV HOME=/home/${USER}
ENV TMUX_SESSION_NAME=devops

RUN groupadd ${GROUP}

RUN useradd -m -g ${GROUP} ${USER}

RUN apt-get update -y && apt-get upgrade -y
RUN DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends tzdata
RUN apt-get install -y \
    ca-certificates \
    curl \
    git \
    wget \
    docker \
    vim \
    fzf \
    zsh \
    fd-find \
    zsh-syntax-highlighting \
    tmux \
    locales \
    locales-all

RUN usermod -s /bin/zsh ${USER}

# 配置时区与本地化
RUN ln -fs /usr/share/zoneinfo/Europe/Paris /etc/localtime \
    && dpkg-reconfigure --frontend noninteractive tzdata

USER ${USER}
WORKDIR /home/${USER}

# 安装Oh-My-Zsh
RUN wget https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh -O - | zsh || true

# 安装ZSH插件
RUN git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k
RUN git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-${HOME}/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
RUN git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-${HOME}/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

COPY --chown=${USER}:${GROUP} zshrc ${HOME}/.zshrc
COPY --chown=${USER}:${GROUP} tmux.conf ${HOME}/.tmux.conf
COPY --chown=${USER}:${GROUP} p10k.zsh ${HOME}/.p10k.zsh

# ENTRYPOINT ["zsh", "-c", "tmux"]
ENTRYPOINT ["zsh"]

问题原因 #

使用zsh -c "tmux"时，zsh以非交互式模式运行，不会加载.zshrc中的终端环境配置（比如Powerlevel10k的特殊字符设置、字符集配置），同时tmux无法正确继承终端的关键环境变量（如TERM、LC_ALL），导致特殊字符渲染失败。

解决方案 #

方法1：让zsh以交互式模式启动tmux #

修改Dockerfile中的ENTRYPOINT为：

ENTRYPOINT ["zsh", "-i", "-c", "tmux"]

-i参数强制zsh以交互式模式运行，会完整加载.zshrc配置，确保终端环境变量正确传递给tmux。

方法2：直接将tmux设为ENTRYPOINT #

跳过zsh的中间调用，直接启动tmux会话：

ENTRYPOINT ["tmux", "new-session", "-A", "-s", "${TMUX_SESSION_NAME}"]

-A参数表示如果指定名称的会话已存在则接入，不存在则创建；-s指定会话名。由于已经设置用户默认shell为zsh，tmux启动后会自动使用zsh作为默认终端，同时直接继承容器的终端环境。

方法3：在.zshrc中添加自动启动tmux逻辑 #

保持ENTRYPOINT为["zsh"]，在.zshrc末尾添加以下代码：

# 仅在交互式非tmux环境下自动启动tmux
if [[ -z "$TMUX" && -n "$PS1" ]]; then
  tmux new-session -A -s ${TMUX_SESSION_NAME}
fi

这样每次启动zsh交互式会话时，会自动进入tmux，同时保留了手动启动的灵活性。

额外优化建议 #

在.tmux.conf中添加以下配置，确保tmux支持256色和特殊字符渲染：

set -g default-terminal "screen-256color"
set -ga terminal-overrides ",xterm-256color:Tc"

内容的提问来源于stack exchange，提问作者Ben