Cobalt API 服务端口配置指南

端口配置原理

在部署Cobalt API服务时，端口配置涉及两个关键层面：

1. 容器端口映射：通过Docker的端口映射机制将容器内部服务暴露到宿主机
2. 应用层端口绑定：服务应用本身需要明确知道在哪个端口上监听请求

完整配置示例

以下是修改Cobalt API服务端口至9002的完整docker-compose配置示例：

services:
  cobalt-api:
    image: ghcr.io/imputnet/cobalt:7
    network_mode: bridge
    restart: unless-stopped
    container_name: cobalt-api
    ports:
      - "9002:9002/tcp"  # 宿主机端口:容器端口
    environment:
      API_PORT: "9002"   # 应用监听端口
      API_URL: "http://192.168.11.1:9002/"
      API_NAME: "cobalt-api"

配置要点解析

1. 端口映射一致性：

   • 容器内部端口(右侧)必须与应用监听端口(API_PORT)一致
   • 宿主机端口(左侧)可根据实际情况调整

2. 环境变量关联性：

   • API_URL中的端口号需要与API_PORT保持一致
   • 当修改端口时，这三个位置需要同步更新

3. 网络访问控制：

   • 确保防火墙规则允许新端口的入站连接
   • 如果使用反向代理，需要相应更新代理配置

常见问题排查

若服务无法访问，建议按以下步骤检查：

1. 确认容器日志是否有绑定端口的错误信息
2. 使用docker ps检查端口映射是否正确显示
3. 在宿主机上测试端口连通性：telnet localhost 9002
4. 检查是否有其他服务占用了目标端口

进阶建议

对于生产环境部署，建议：

• 使用非特权端口(>1024)增强安全性
• 考虑通过反向代理(Nginx等)暴露服务
• 配置TLS加密以提高通信安全性
• 设置适当的资源限制和健康检查

通过正确理解端口配置的双重机制，可以灵活调整Cobalt API服务以适应不同的部署环境需求。