sulinggg/openwrtenv

OpenWrt-Env

本项目基于 P3TERX 的 https://github.com/P3TERX/openwrt-build-env 项目，在镜像构建过程中使用 Project-OpenWrt https://github.com/project-openwrt/build-scripts 项目的 https://github.com/project-openwrt/build-scripts/blob/master/init_build_environment.sh 脚本安装编译 OpenWrt 所需依赖。

Github: https://github.com/SuLingGG/OpenWrt-Env
DockerHub: https://hub.docker.com/r/sulinggg/openwrtenv

核心功能和特性

1. 已预置完善的 OpenWrt 依赖，无需手动安装；
2. 预置配置好的 zsh，方便终端操作；
3. 包含实用小工具和配置，如 bashtop、gotop、tmate、oh-my-zsh、oh-my-tmux 等；
4. 预先配置 SSH，支持远程连接（详情参见 P3TERX 项目的 https://github.com/P3TERX/openwrt-build-env#ssh-security-settings%EF%BC%89%EF%BC%9B
5. 提供含 Lean / Project / 官方 OpenWrt 源码且预编译树莓派 1~4 工具链的镜像，减少工具链编译时间。

镜像介绍

基础镜像

基础镜像包含构建 OpenWrt 的依赖与小工具，未预置源码和工具链，适合构建任意设备的 OpenWrt。

拉取方式（DockerHub）：

bash
docker pull sulinggg/openwrtenv

拉取方式（阿里云香港 Docker 镜像仓库）：

bash
docker pull registry.cn-hongkong.aliyuncs.com/suling/openwrtenv

工具链镜像

工具链镜像在基础镜像上集成 OpenWrt 源码，并预编译树莓派 14 设备的工具链，适合编译树莓派 OpenWrt，可减少 2060 分钟编译时间。

标签名称列表：

拉取方式（DockerHub）：

bash
docker pull sulinggg/openwrtenv:标签名称

拉取方式（阿里云香港 Docker 镜像仓库）：

bash
docker pull registry.cn-hongkong.aliyuncs.com/suling/openwrtenv:标签名称

示例：从 DockerHub 拉取 Lean 版源码且适用于树莓派 3B/3B+ 的工具链镜像：

bash
docker pull sulinggg/openwrtenv:lean-rpi3

源码说明：

• Lean 版：基于 https://github.com/coolsnowwolf/lede/tree/master
• Offical 版：基于 https://github.com/openwrt/openwrt/tree/master
• Project 版：基于 https://github.com/project-openwrt/openwrt/tree/18.06-kernel5.4

OpenWrt 源码路径：/home/admin/openwrt

使用方法（以基础镜像为例）

拉取镜像

从 DockerHub 拉取：

bash
docker pull sulinggg/openwrtenv

国内用户可从阿里云拉取（香港仓库）：

bash
docker pull registry.cn-hongkong.aliyuncs.com/suling/openwrtenv

构建镜像：

bash
docker build -t sulinggg/openwrtenv github.com/SuLingGG/OpenWrt-Env

启动容器

bash
docker run \
    -itd \
    --name openwrtenv \
    -p 10022:22 \
    -v ~/workspace:/home/admin/workspace \
    sulinggg/openwrtenv

容器权限设置

1. 在宿主机查看当前用户 uid 与 gid：

   bash
   $ id
   uid=1001(p3terx) gid=1002(p3terx)
   

2. 修改容器内 admin 用户的 uid 和 gid（替换示例中的 1001、1002 为实际值）：

   bash
   docker exec openwrtenv sudo usermod -u 1001 admin
   docker exec openwrtenv sudo groupmod -g 1002 admin
   

3. 设定容器内工作目录所有权：

   bash
   docker exec openwrtenv sudo chown -hR admin:admin .
   

4. 重启容器：

   bash
   docker restart openwrtenv
   

进入容器

在宿主机终端执行以下命令进入容器：

bash
docker exec -it openwrtenv zsh