在局域网环境中使用Docker部署Cobalt服务指南

背景介绍

Cobalt作为一款开源服务框架，其Docker部署方式通常需要配置公网IP或域名以便外部访问。但在某些企业内网或家庭局域网环境中，用户可能仅需在本地网络中使用该服务。本文将详细介绍如何在无公网IP和域名的纯局域网环境下完成Cobalt的Docker化部署。

核心配置要点

网络地址配置

关键在于正确设置API_URL环境变量：

1. 使用本地网络IP地址（如192.168.x.x或10.x.x.x等私有地址段）
2. 需包含完整的访问协议（http/https）
3. 必须指定服务暴露的端口号

典型配置示例：

API_URL=http://192.168.1.100:9000/

Docker运行参数

建议使用以下docker run命令参数：

docker run -d \
  -p 9000:9000 \
  -e API_URL="http://<局域网IP>:9000/" \
  --name cobalt \
  wukko/cobalt

实施步骤详解

1. 确定主机IP地址

   • 在Linux/macOS终端执行ifconfig
   • 在Windows命令提示符执行ipconfig
   • 记录以太网或Wi-Fi适配器的IPv4地址

2. 创建持久化配置文件 建议创建docker-compose.yml文件：

   version: '3'
   services:
     cobalt:
       image: wukko/cobalt
       ports:
         - "9000:9000"
       environment:
         - API_URL=http://<你的IP>:9000/
       restart: unless-stopped
   

3. 防火墙配置

   • 确保主机防火墙放行9000端口
   • 企业网络可能需要网管开放内网访问权限

验证与测试

1. 在同一局域网的其他设备上通过浏览器访问：

   http://<你设置的IP>:9000/
   

2. 使用curl命令测试API连通性：

   curl http://<IP>:9000/api/status
   

高级应用场景

1. 多节点部署：在集群环境中，可通过内部DNS或Consul等服务发现机制动态配置API_URL
2. HTTPS支持：虽然在内网，仍可配置自签名证书实现加密通信
3. 负载均衡：结合Nginx可实现多实例负载分发

排错指南

常见问题及解决方案：

• 连接被拒绝：检查Docker容器是否正常运行（docker ps）
• 无法访问：确认IP地址是否属于同一子网
• 端口冲突：修改docker run命令中的端口映射（如-p 9001:9000）

通过以上配置，用户可以在完全隔离的局域网环境中安全、高效地运行Cobalt服务，无需任何公网基础设施支持。