koalalove/chromium

镜像概述

本镜像基于 https://hub.docker.com/r/linuxserver/chromium/tags 构建，主要通过添加中文字体解决原镜像中文显示异常问题，可提供带中文支持的Chromium浏览器服务，支持Web界面访问。

核心功能与特性

• 基础功能继承：完整继承 linuxserver/chromium 镜像的所有功能，包括Web界面访问、持久化配置等
• 中文支持：预装文泉驿正黑（fonts-wqy-zenhei）和文鼎粗楷体（fonts-arphic-ukai）中文字体，确保中文正常显示
• 灵活配置：支持通过环境变量自定义用户、密码、默认启动页等参数
• 资源优化：包含共享内存优化配置，提升浏览器运行性能

使用场景

• 需要在容器环境中运行带中文显示的Chromium浏览器
• Web自动化测试场景（需中文界面支持）
• 远程浏览器访问需求（如服务器端浏览器操作）

使用方法

docker-compose 部署

创建 docker-compose.yml 文件，内容如下：

yaml
services:
  chromium:
    image: koalalove/chromium:latest
    container_name: chromium
    restart: unless-stopped
    ports:
      - 3020:3000  # HTTP访问端口
      - 3021:3001  # HTTPS访问端口
    volumes:
      - ./config:/config  # 配置持久化存储
    environment:
      - CUSTOM_USER=xxxx  # Web访问用户名
      - PASSWORD=xxxx     # Web访问密码
      - PUID=1000         # 运行用户ID（建议与宿主机用户ID一致）
      - PGID=1000         # 运行用户组ID
      - TZ=Asia/Shanghai  # 时区设置
      - CHROME_CLI=https://www.google.com/  # 浏览器默认启动页
    security_opt:
      - seccomp:unconfined  # 必须配置，解决Chromium沙箱限制
    shm_size: "1gb"  # 共享内存大小，建议至少1GB以保证性能

启动服务：

bash
docker-compose up -d

环境变量说明

访问方式

服务启动后，通过以下地址访问：

• HTTP: http://宿主机IP:3020
• HTTPS: https://宿主机IP:3021

自行构建镜像

Dockerfile

dockerfile
FROM linuxserver/chromium:latest

# 安装中文字体
RUN apt-get update && \
    apt-get install -y --no-install-recommends \
        fonts-wqy-zenhei \  # 文泉驿正黑字体
        fonts-arphic-ukai && \  # 文鼎粗楷体字体
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

构建命令：

bash
docker build -t yourname/chromium:custom .