让开源浏览器Chromium正常显示中文

news2025/6/20 19:37:02

在这里插入图片描述

什么是 Chromium ？

Chromium 是一个开源浏览器项目，旨在为所有用户构建一种更安全、更快、更稳定的网络体验方式。

和老苏之前介绍的 Firefox 的作用是一样的

文章传送门：给群晖安装firefox浏览器

因为是基于 vnc 的应用，感觉资源占用比较高，虽然不是常态，但时不时的会飙升一下，所以不是太建议安装。或者等需要使用的时候再启动容器，用完后就停止，不需要一直开在那里

安装

在群晖上以 Docker 方式安装。

本文写作时， latest 版本对应为 4fed82c2-ls48；

docker cli 安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 chromium 和 子目录
mkdir -p /volume1/docker/chromium/config

# 进入 chromium 目录
cd /volume1/docker/chromium

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name chromium \
   --shm-size="1gb" \
   --security-opt seccomp=unconfined \
   -p 3020:3000 \
   -p 3021:3001 \
   -v $(pwd)/config:/config \
   -e PUID=1000 \
   -e PGID=1000 \
   -e TZ=Asia/Shanghai \
   -e CHROME_CLI=https://laosu.cf/ \
   linuxserver/chromium:latest

其中主要的参数的说明：

范围	功能
`-p 3000`	`Chromium` 桌面图形用户界面 `http` 访问端口。
`-p 3001`	`https` 访问端口
`-e PUID=1000`	`UserID`
`-e PGID=1000`	`GroupID`
`-e TZ=Asia/Shanghai`	指定要使用的时区。
`-e CHROME_CLI=https://laosu.cf/`	指定一个或多个 `Chromium CLI` 标志，该字符串将完整传递给应用程序。
`-v /config`	容器中的用户主目录，存储本地文件和设置。
`--shm-size=`	用于指定共享内存的大小。在某些场景下提高容器的性能和可靠性，特别是当容器内的应用程序需要大量使用共享内存时。
`--security-opt seccomp=unconfined`	仅对于 `Docker` 引擎，如果没有它，`Chromium` 将在无沙箱测试模式下运行。

docker-compose 安装

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: "2.1"

services:
  chromium:
    image: linuxserver/chromium:latest
    container_name: chromium
    restart: unless-stopped
    ports:
      - 3020:3000
      - 3021:3001
    volumes:
      - ./config:/config
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - CHROME_CLI=https://laosu.cf/
    security_opt:
      - seccomp:unconfined
    shm_size: "1gb"

然后执行下面的命令

# 新建文件夹 chromium 和 子目录
mkdir -p /volume1/docker/chromium/config

# 进入 chromium 目录
cd /volume1/docker/chromium

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

第一次初始化的时间会比较长，在浏览器中输入 http://群晖IP:3020，你可能会看到闪了一下 KasmVNC，然后就是黑乎乎的

启动正常后，就能看到主界面

这是基于 KasmVNC 的应用，左侧有隐藏的菜单

从界面看，显然容器内缺中文字体，所以汉字都显示成了方块

中文支持

先进入容器

# 以 root 身份进入容器
docker exec -it --user root chromium /bin/bash

然后在容器内，执行下面的命令来安装字体文件

fonts-wqy-zenhei：这是一款开源的中文字体，也称为文泉驿正黑字体。
fonts-arphic-ukai：这是一款由文鼎资讯公司提供的中文字体。
fonts-arphic-uming：同样由文鼎资讯公司提供的中文字体。

# 安装中文字体
apt-get update && \
    apt-get install -y \
        fonts-wqy-zenhei fonts-arphic-ukai fonts-arphic-uming \
    && apt-get clean

接下来的操作，需要在 Chromium 浏览器中进行

在地址栏输入 chrome://flags，搜索 language，找到 Reduce Accept-Language request header

设置为 Enabled，然后 Relaunch 重启浏览器

现在汉字的显示就正常了

参考文档

linuxserver/docker-chromium: Web accessible Chromium inside an Alpine Container
地址：https://github.com/linuxserver/docker-chromium

chromium - LinuxServer.io
地址：https://docs.linuxserver.io/images/docker-chromium/

Add CJK (Chinese, Japanese, Korean) language support to the docker image · Issue #932 · garris/BackstopJS
地址：https://github.com/garris/BackstopJS/issues/932