Proxy Manager — 代理管理器

代理管理器（Proxy Manager） 管理共享的nginx-proxy Docker容器（jwilder/nginx-proxy）和所有开发实例使用的Docker网络（nginx-proxy_net）。代理自动发现带有VIRTUAL_HOST标签的容器并创建路由。它还拥有允许MySQL和应用容器通信的共享Docker网络。

架构 proxy-manager/ ├── docker-compose.yml # nginx-proxy容器 + codai_net网络 └── run.sh # 生命周期 + 网络连接CLI

启动顺序：代理管理器（proxy-manager）首先启动（创建网络），然后是mysql-manager，最后是worktree-manager。

命令 ./run.sh start # 启动nginx-proxy（创建codai_net网络） ./run.sh stop # 停止nginx-proxy ./run.sh status # 显示状态、连接的网络、活跃的路由 ./run.sh connect # 将代理连接到实例的Docker网络 ./run.sh disconnect # 将代理从实例网络断开 ./run.sh auto-connect # 将代理连接到所有项目网络 ./run.sh reload # 重新加载nginx配置而不重启

执行任务 首次设置 cd proxy-manager && ./run.sh start 创建共享的nginx-proxy_net Docker网络并在端口80上启动代理。

启动应用实例后 在worktree-manager start 后，连接代理以使路由可用： ./run.sh connect 路由：http://.frontend.localhost 和 http://.backend.localhost

重启Docker或主机后 代理通过restart：unless-stopped自动重新连接。如果路由丢失，运行： ./run.sh auto-connect 检查活跃路由 ./run.sh status

启动顺序 proxy-manager start — 创建网络，启动代理 mysql-manager start — 加入共享网络 worktree-manager start — 启动应用容器 proxy-manager connect — 激活路由

配置变量 默认值 目的 PROXY_CONTAINER codai_nginx_proxy nginx-proxy容器名称 CODAI_NETWORK nginx-proxy_net 共享Docker网络名称 PROJECT_PREFIX codai-dev Docker Compose项目前缀

VIRTUAL_HOST路由工作原理 应用容器声明VIRTUAL_HOST=.frontend.localhost作为标签 jwilder/nginx-proxy读取Docker socket事件并生成nginx配置 代理容器必须至少与应用容器共享一个Docker网络 ./run.sh connect 连接代理到实例的网络

规则 在mysql-manager和worktree-manager之前启动proxy-manager。 在worktree-manager start 后，始终运行proxy-manager connect 以激活路由。 stop不会删除Docker网络。网络上的其他容器仍然可达。

相关插件 mysql-manager — 共享MySQL容器（在proxy-manager之后启动） worktree-manager — 应用实例和git工作树（在proxy-manager和mysql-manager之后启动）