linuxserver/brave 镜像文档

镜像概述和主要用途

linuxserver/brave 是由 LinuxServer.io 团队开发的 Docker 镜像，基于 Brave 浏览器 构建。Brave 是一款快速、私密且安全的网页浏览器，支持 PC、Mac 和移动设备。该镜像将 Brave 浏览器封装为容器化应用，提供便捷的部署和管理方式，适用于需要在隔离环境中运行安全浏览器的场景。

LinuxServer.io 团队的容器具有以下特点：

• 定期及时的应用更新
• 简单的用户映射（PGID、PUID）
• 基于 s6 overlay 的自定义基础镜像
• 每周基础 OS 更新，通过跨生态系统的通用层减少空间占用、 downtime 和带宽消耗
• 定期安全更新

核心功能和特性

1. 多架构支持：支持 x86-64 和 arm64v8 架构，通过 Docker manifest 实现多平台自动适配
2. Web 访问界面：通过 HTTP/HTTPS 端口提供浏览器 GUI 访问，无需本地安装
3. 用户权限控制：支持 PUID/PGID 映射，避免容器与主机权限冲突
4. 安全增强：可选 HTTP 基础认证，支持 HTTPS 加密（默认自签名证书）
5. GPU 加速：支持 DRI3 开源驱动（Intel/AMD/ nouveau）和 Nvidia GPU（通过 Zink）
6. 多语言支持：通过环境变量配置多种语言界面
7. 应用持久化：支持 PRoot Apps 实现应用跨容器生命周期持久化
8. Docker 集成：支持 Docker-in-Docker (DinD) 和主机 Docker socket 挂载，便于容器管理

支持的架构

该镜像通过 Docker manifest 实现多平台支持，拉取 lscr.io/linuxserver/brave:latest 即可自动获取对应架构的镜像，也可通过标签指定具体架构：

使用场景和适用范围

• 隔离浏览环境：在隔离容器中运行浏览器，减少主机安全风险
• 远程浏览器访问：通过网络访问浏览器，适用于服务器或无头环境
• 开发测试环境：快速部署标准化的浏览器测试环境
• 低资源设备：在服务器或嵌入式设备上提供浏览器功能
• 多用户共享：通过反向代理实现多用户安全访问（需额外认证配置）

详细使用方法和配置说明

应用访问

容器启动后，可通过以下地址访问 Brave 浏览器：

• HTTPS: [***]（默认端口，可通过环境变量修改）

安全注意事项

[!WARNING] 本容器提供对主机系统的特权访问，请勿暴露到互联网，除非已采取严格安全措施。

1. HTTPS 要求：现代浏览器功能（如 WebCodecs 音视频处理）仅支持 HTTPS，容器默认使用自签名证书（HTTPS）
2. 认证配置：默认无认证，可通过 CUSTOM_USER 和 PASSWORD 环境变量启用 HTTP 基础认证（仅适用于可信局域网）。互联网暴露需配合反向代理（如 SWAG）实现强认证
3. 容器内权限：Web 界面包含带无密码 sudo 权限的终端，任何访问者可获取容器内 root 权限，安装软件或探测局域网
4. Seccomp 配置：老旧内核或 libseccomp 环境可能需要添加 --security-opt seccomp=unconfined 参数以运行 GUI 应用（不推荐，会降低安全性）

环境变量配置

基础环境变量

Selkies 基础镜像环境变量

多语言支持

通过 LC_ALL 环境变量配置界面语言，示例：

GPU 加速支持

DRI3 开源驱动加速

适用于 Intel/AMD 开源驱动或 Nvidia nouveau 驱动，通过挂载 GPU 设备实现硬件加速：

--device /dev/dri:/dev/dri  # 挂载所有 DRI 设备
-e DRINODE=/dev/dri/renderD128  # 指定特定渲染设备（可选）

支持的驱动类型：

• Intel: i965、i915（集成显卡）
• AMD: AMDGPU、Radeon、ATI（独立显卡/APU）
• NVIDIA: nouveau（开源驱动，闭源驱动不支持 DRI3）

Nvidia GPU 支持

注意：Alpine 基础镜像不支持 Nvidia

通过 Zink 实现 OpenGL 支持，并支持硬件加速视频编码（x264enc），需配置 Nvidia 运行时：

1. 配置主机 Docker 默认使用 Nvidia 运行时：

   sudo nvidia-ctk runtime configure --runtime=docker --set-as-default
   sudo systemctl restart docker
   

2. Docker Run 参数：

   --gpus all  # 传递所有 GPU（可指定具体 GPU）
   --runtime nvidia  # 使用 Nvidia 运行时
   

3. Docker Compose 配置：

   services:
     brave:
       image: lscr.io/linuxserver/brave:latest
       deploy:
         resources:
           reservations:
             devices:
               - driver: nvidia
                 count: 1
                 capabilities: [compute,video,graphics,utility]
   

应用管理

PRoot Apps（持久化，推荐）

通过 proot-apps 安装应用至用户 $HOME 目录，跨容器重建保留：

# 容器内执行
proot-apps install filezilla  # 安装 FileZilla

支持的应用列表

Native Apps（非持久化）

通过 universal-package-install 模块安装系统原生包（容器重建后丢失）：

# docker-compose.yaml 示例
environment:
  - DOCKER_MODS=linuxserver/mods:universal-package-install
  - INSTALL_PACKAGES=libfuse2|git|gdb  # 需安装的包，用 | 分隔

部署方案示例

Docker Compose 配置

---
services:
  brave:
    image: lscr.io/linuxserver/brave:latest
    container_name: brave
    environment:
      - PUID=1000                  # 用户 ID（通过 id 命令获取）
      - PGID=1000                  # 组 ID
      - TZ=Asia/Shanghai           # 时区设置为上海
      - LC_ALL=zh_CN.UTF-8         # 中文界面
      - CUSTOM_USER=browseruser    # HTTP 认证用户名
      - PASSWORD=securepassword    # HTTP 认证密码
    volumes:
      - /path/to/config:/config    # 配置文件持久化目录
    ports:
      - 3000:3000                  # HTTP 端口（建议仅本地访问）
      - 3001:3001                  # HTTPS 端口（推荐使用）
    shm_size: "1gb"                # 共享内存大小（Brave 必需）
    # 可选：GPU 加速
    # devices:
    #   - /dev/dri:/dev/dri
    restart: unless-stopped

Docker Run 命令

docker run -d \
  --name=brave \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e LC_ALL=zh_CN.UTF-8 \
  -e CUSTOM_USER=browseruser \
  -e PASSWORD=securepassword \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/config:/config \
  --shm-size="1gb" \
  --restart unless-stopped \
  lscr.io/linuxserver/brave:latest

参数说明

Docker Mods

LinuxServer 提供 Docker Mods 扩展容器功能：

• Brave 专用 Mods：![Docker Mods]([***]
• 通用 Mods：![Docker Universal Mods]([***]

支持信息

• 容器内 Shell 访问：

  docker exec -it brave /bin/bash
  

• 实时日志查看：

  docker logs -f brave
  

• 容器版本查询：

  docker inspect -f '{{ index .Config.Labels "build_version" }}' brave
  

• 镜像版本查询：

  docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/brave:latest
  

更新方法

Docker Compose

# 更新所有镜像
docker-compose pull
# 或更新单个镜像
docker-compose pull brave

# 重启所有容器
docker-compose up -d
# 或重启单个容器
docker-compose up -d brave

# 清理旧镜像
docker image prune

Docker Run

# 拉取最新镜像
docker pull lscr.io/linuxserver/brave:latest

# 停止并删除旧容器
docker stop brave
docker rm brave

# 用原参数重新创建容器（/config 挂载正确则配置保留）
docker run -d [原参数] lscr.io/linuxserver/brave:latest

# 清理旧镜像
docker image prune

本地构建

git clone [***]
cd docker-brave
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/brave:latest .

跨架构构建（需先注册 qemu-static）：

docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
# 构建 arm64 版本
docker build -f Dockerfile.aarch64 -t lscr.io/linuxserver/brave:arm64v8-latest .

版本历史

• 22.09.25：基于 Debian Trixie 重新构建
• 06.06.25：初始版本发布