蒲公英X1路由器安装Docker完整指南与优化实践

蒲公英X1安装Docker深度指南

一、设备兼容性验证

1. 硬件规格核查
   蒲公英X1采用MT7621A双核处理器（880MHz）和256MB内存，需通过cat /proc/cpuinfo确认CPU架构为MIPS 1004Kc。实测Docker运行至少需要：

   free -m  # 确认剩余内存≥150MB
   df -h    # 存储空间≥500MB（建议外接USB3.0存储）

2. 系统版本要求
   官方OpenWRT 18.06及以上版本支持Docker CE，需检查内核版本：

   uname -r  # ≥4.14.180
   opkg list-installed | grep kmod

   若缺少kmod-veth或kmod-nf-nat模块，需手动编译（详见第三章）。

二、依赖环境配置

1. 内核模块加载
   编辑/etc/modules.d/docker添加：

   overlay
   nf_conntrack
   br_netfilter

   执行modprobe overlay加载模块，建议在/etc/rc.local添加自启命令。

2. 存储驱动优化
   由于MT7621的MMC性能有限，推荐使用overlay2驱动：

   {"storage-driver": "overlay2","data-root": "/mnt/usb/docker"}

   需通过mkfs.ext4格式化外置存储，避免JFFS2写入损耗。

三、Docker CE安装实战

1. 软件源配置
   添加MIPS架构专用源至/etc/opkg/customfeeds.conf：

   src/gz docker https://downloads.openwrt.org/releases/18.06-SNAPSHOT/packages/mipsel_24kc/packages/

   安装关键组件：

   opkg install docker-ce libnetwork tini

2. 服务启动验证

   /etc/init.d/docker start
   docker run --rm hello-world  # 测试镜像运行

   若出现exec format error需下载MIPS架构专用镜像。

四、性能调优方案

1. 资源限制策略
   在/etc/docker/daemon.json中配置：

   {
     "default-ulimits": {"nofile": {"Name": "nofile", "Hard": 1024, "Soft": 512}},
     "oom-score-adjust": -500
   }

2. 网络加速技巧
   使用macvlan驱动实现容器直连蒲公英SD-WAN：

   docker network create -d macvlan --subnet=192.168.1.0/24 \
   --gateway=192.168.1.1 -o parent=eth0.2 pgy_net

五、典型问题排查

1. QoS冲突处理
   当容器网络延迟过高时，需在蒲公英管理界面关闭智能QoS：

   iptables -t mangle -D POSTROUTING -j IMQ --todev 0

2. 内存泄漏监控
   添加cron任务定期重启容器：

   docker stats --no-stream | awk '/MEM%/{if($3>90) system("docker restart "$2)}

六、进阶应用场景

1. 自建蒲公英穿透服务
   通过Docker部署frps实现二级穿透：

   version: '3'
   services:
     frps:
       image: snowdreamtech/frps
       devices: [/dev/net/tun]
       cap_add: [NET_ADMIN]

2. 轻量级CI/CD流水线
   使用Drone Runner实现自动化构建：

   docker run -v /var/run/docker.sock:/var/run/docker.sock \
   -e DRONE_RPC_PROTO=https -e DRONE_RPC_HOST=drone.example.com \
   drone/drone-runner-docker

关键提示：长期运行建议搭配UPS电源，避免闪退导致容器文件系统损坏。定期执行docker system prune清理悬空镜像。通过watch -n 1 "cat /proc/loadavg"监控系统负载情况。