在OpenWrt软路由上使用Docker Compose高效部署集客AC控制器

对于家庭网络爱好者和中小型企业IT管理员来说，OpenWrt软路由搭配Docker容器技术已经成为构建灵活网络环境的黄金组合。今天我们要探讨的，是如何利用Docker Compose这一现代化工具，在OpenWrt平台上优雅地部署集客AC控制器——一个专门用于管理集客AP的集中控制平台。

传统的手动输入docker run命令方式虽然直接，但在长期维护、版本控制和环境复现方面存在明显短板。Docker Compose通过声明式的YAML配置文件，不仅简化了部署流程，更提供了版本管理、环境隔离和快速迁移等诸多优势。本文将带你从零开始，构建一个可维护、易扩展的集客AC控制器部署方案。

1. 环境准备与前置条件

在开始部署之前，我们需要确保OpenWrt系统已经具备运行Docker和Docker Compose的基本条件。不同于标准Linux发行版，OpenWrt作为嵌入式操作系统，在资源分配和软件包管理上有其特殊性。

1.1 硬件与系统要求

• 硬件建议：

  • x86_64架构设备（如J1900、N5105等）至少2GB内存
  • 16GB以上存储空间（Docker镜像和容器数据会占用可观空间）
  • 双网口或以上（一个用于WAN，一个用于LAN）

• 软件要求：

  • OpenWrt 21.02或更新版本
  • 已安装Docker CE（社区版）
  • 已安装Docker Compose插件
  • 已配置好网络接口和防火墙规则

提示：OpenWrt的Docker支持需要通过软件包手动安装，常见的安装命令为opkg install docker docker-compose，具体取决于你的OpenWrt版本和软件源配置。

1.2 存储空间规划

由于Docker容器会产生持久化数据，合理的存储规划至关重要。建议为集客AC控制器专门创建一个数据目录：

bash复制mkdir -p /opt/docker/gecoos-ac/data
chmod -R 777 /opt/docker/gecoos-ac/data

这个目录将用于存放AC控制器的数据库和配置文件，确保即使容器重建或升级，重要数据也不会丢失。

1.3 网络配置检查

集客AC控制器需要与局域网内的AP设备通信，因此需要确认：

1. OpenWrt的LAN接口配置正确
2. 防火墙允许相关端口通过（默认60650和8080）
3. DHCP服务能够为AP设备分配IP地址

可以通过以下命令检查当前网络配置：

bash复制ifconfig
netstat -tuln
uci show firewall

2. Docker Compose文件深度解