1
# 使用官方推荐的 Ubuntu 22.04 LTS 作为基础镜像
2
FROM ubuntu:22.04
3

4
# 设置环境变量，避免在包安装过程中出现交互式提示
5
ENV DEBIAN_FRONTEND=noninteractive
6

7
# 一次性更新软件源并安装 OpenWrt 编译所需的所有依赖包
8
RUN apt-get update && \
9
    apt-get install -y --no-install-recommends \
10
    # 编译工具链
11
    build-essential \
12
    clang \
13
    flex \
14
    bison \
15
    g++ \
16
    gawk \
17
    gcc-multilib \
18
    g++-multilib \
19
    # 文本和版本控制工具
20
    gettext \
21
    git \
22
    subversion \
23
    # 核心库和开发头文件
24
    libncurses5-dev \
25
    libssl-dev \
26
    zlib1g-dev \
27
    # Python 相关工具
28
    python3-distutils \
29
    python3-docutils \
30
    python3-pyelftools \
31
    python3-setuptools \
32
    # 常用辅助工具
33
    rsync \
34
    swig \
35
    texinfo \
36
    unzip \
37
    wget \
38
    file \
39
    time \
40
    # 解决 SSL 证书验证问题的关键包
41
    ca-certificates \
42
    # 为非 root 用户提供提权能力的工具
43
    sudo \
44
    && \
45
    # 清理 apt 缓存，减小最终镜像大小
46
    apt-get clean && \
47
    rm -rf /var/lib/apt/lists/*
48

49
# 创建一个名为 'builder' 的非 root 用户，并赋予其免密 sudo 权限
50
# 这是为了安全起见，避免在容器中直接使用 root 用户进行编译等操作
51
RUN useradd -m -s /bin/bash builder && \
52
    adduser builder sudo && \
53
    echo 'builder ALL=(ALL) NOPASSWD:ALL' >> /etc/sudoers
54

55
# 切换到新创建的非 root 用户
56
USER builder
57

58
# 为 builder 用户设置工作目录
59
WORKDIR /home/builder
60

61
# 设置容器启动时执行的默认命令，即启动一个 bash shell
62
CMD ["/bin/bash"]

1
version: '3.8'
2

3
services:
4
  openwrt-builder:
5
    # 使用当前目录下的 Dockerfile 来构建镜像
6
    build: .
7
    # 给构建出的镜像命名
8
    image: openwrt-builder-image
9
    # 容器的名字
10
    container_name: openwrt_build_env
11
    # 覆盖 Dockerfile 中的 CMD，确保我们能进入 bash
12
    command: /bin/bash
13
    # 保持容器在前台运行，并分配一个伪终端 (等同于 -it)
14
    stdin_open: true
15
    tty: true
16
    # 网络模式
17
    network_mode: host
18
    # 挂载卷
19
    volumes:
20
      # 将宿主机的 ./openwrt 目录挂载到容器的 /home/builder/openwrt
21
      - ./openwrt:/home/builder/openwrt
22
    # 设置工作目录，进入容器后会自动切换到这个目录
23
    working_dir: /home/builder/openwrt

1
~/openwrt_dev/
2
├── Dockerfile
3
├── docker-compose.yml
4
└── openwrt/