在 Docker 中安装 Chromium 浏览器并预装中文语言包

本文将介绍如何通过 Docker 安装 Chromium，并预装支持中文显示的字体和语言环境。以下是详细的步骤及命令说明。

1. 安装需求

在安装之前，请确保你的环境满足以下要求：

已安装 Docker
有足够的存储和内存分配给 Docker 容器（建议共享内存设置为 1GB 或更高）

2. 安装命令

使用以下命令启动一个预装中文语言包的 Chromium 容器：

docker run -d \
   --name chromium \
   --shm-size="1gb" \
   --security-opt seccomp=unconfined \
   -e DOCKER_MODS=linuxserver/mods:universal-package-install \
   -e INSTALL_PACKAGES=fonts-noto-cjk \
   -e LC_ALL=zh_CN.UTF-8 \
   -e PASSWORD='你的密码' \
   -e CUSTOM_USER='你的用户名' \
   -v /opt/docker/chrome/config:/config \
   -e PUID=1000 \
   -e PGID=1000 \
   -e CUSTOM_PORT='自定义端口 默认是3000' \
   -e CUSTOM_HTTPS_PORT='自定义HTTPS端口 默认是3001' \
   -e TZ=Asia/Shanghai \
   -e CHROME_CLI=https://www.google.com/ \
   --network=host \
   --device /dev/dri:/dev/dri '用于硬件加速，如果系统不支持/dev/dri设备请删除这条'\
   linuxserver/chromium:latest

3. 参数说明

基本设置

--name chromium
容器名称，可根据需要自定义。
--shm-size="1gb"
共享内存大小，避免 Chromium 在加载大量页面时崩溃。
--security-opt seccomp=unconfined
放宽容器的安全限制，确保 Chromium 能正常运行。

环境变量

DOCKER_MODS=linuxserver/mods:universal-package-install
激活模块，允许安装额外的包。
INSTALL_PACKAGES=fonts-noto-cjk
安装支持中文显示的字体包（Noto CJK）。
LC_ALL=zh_CN.UTF-8
设置默认语言环境为中文。
PASSWORD
设置访问 Web UI 的密码，建议使用强密码。
CUSTOM_USER
自定义访问 Web UI 的用户名。
CUSTOM_PORT
自定义 HTTP 服务的端口，默认是 3000。
CUSTOM_HTTPS_PORT
自定义 HTTPS 服务的端口，默认是 3001。
TZ=Asia/Shanghai
设置时区为上海。
CHROME_CLI
设置默认打开的主页地址。

挂载卷

-v /opt/docker/chrome/config:/config
将容器的配置文件挂载到宿主机的 /opt/docker/chrome/config 路径，方便持久化配置。

网络和设备

--network=host
使用主机网络模式，提升网络性能。
--device /dev/dri:/dev/dri
挂载宿主机的显卡设备，用于硬件加速。

4. 启动和使用

执行命令后，Docker 将启动 Chromium 容器。你可以通过以下方式访问：

HTTP: http://<宿主机IP>:3000
HTTPS: https://<宿主机IP>:3001

登录时，使用 CUSTOM_USER 和 PASSWORD 设置的用户名和密码。

5. 小结

通过本文的教程，你可以快速在 Docker 中安装 Chromium，并预装支持中文的字体包与语言环境。如果在部署过程中遇到问题，可根据容器日志排查，

Xzy®