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

在这里插入图片描述

什么是 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:latestcontainer_name: chromiumrestart: unless-stoppedports:- 3020:3000- 3021:3001volumes:- ./config:/configenvironment:- PUID=1000- PGID=1000- TZ=Asia/Shanghai- CHROME_CLI=https://laosu.cf/security_opt:- seccomp:unconfinedshm_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