anycable/anycable-go

AnyCable Docker镜像技术文档

镜像概述和主要用途

AnyCable 是一个开源的语言无关实时服务器，专注于提供可靠的双向通信能力。该镜像封装了 AnyCable 服务端运行环境，旨在为各类 Web 应用提供高性能、跨语言兼容的实时通信支持，无需依赖特定后端编程语言，可与 Ruby、Python、Node.js 等多种后端系统无缝集成。

核心功能和特性

• 语言无关性：支持与任意后端语言集成，通过标准协议实现实时通信逻辑处理
• 可靠双向通信：基于 WebSocket 协议提供稳定的客户端-服务器双向数据传输
• HTTP 广播支持：支持通过 HTTP 接口向订阅频道广播消息，简化服务端消息推送流程
• 高性能连接处理：优化的连接管理机制，支持高并发客户端连接
• 灵活配置：通过环境变量实现服务参数动态配置，适应不同部署场景
• 预设配置模板：提供如 broker 等预设配置，快速启动基础功能

使用场景和适用范围

• 实时聊天应用：构建即时消息、在线客服等实时对话系统
• 实时通知系统：推送订单状态、系统告警、用户互动等实时通知
• 协作编辑工具：支持多人实时协同编辑文档、表格等内容
• 跨语言后端集成：在多语言技术栈（如微服务架构）中提供统一实时通信层
• 高并发实时场景：直播弹幕、实时数据监控等需要处理大量并发连接的应用

使用方法和配置说明

基本部署（Docker Run）

通过 docker run 命令快速启动 AnyCable 服务：

bash
docker run \
  --ulimit nofile=65536:65536 \  # 调整文件描述符限制，适应高并发连接
  -p 8080:8080 \                  # 映射服务端口（主机端口:容器端口）
  -e "ANYCABLE_HOST=0.0.0.0" \    # 绑定服务监听地址（0.0.0.0 允许外部访问）
  -e "ANYCABLE_PUBLIC=true" \     # 启用公开访问模式（允许匿名连接和订阅）
  -e "ANYCABLE_PRESET=broker" \   # 使用 broker 预设配置（基础消息代理模式）
  anycable/anycable-go:latest

Docker Compose 配置示例

对于多服务协同部署场景，可使用 docker-compose.yml 配置：

yaml
version: '3.8'

services:
  anycable:
    image: anycable/anycable-go:latest
    ulimits:
      nofile:
        soft: 65536
        hard: 65536
    ports:
      - "8080:8080"
    environment:
      - ANYCABLE_HOST=0.0.0.0
      - ANYCABLE_PUBLIC=true
      - ANYCABLE_PRESET=broker
      - ANYCABLE_PORT=8080          # 容器内服务监听端口（默认8080）
      - ANYCABLE_LOG_LEVEL=info     # 日志级别（debug/info/warn/error）
    restart: unless-stopped         # 服务异常退出时自动重启

配置参数说明

环境变量配置

端口映射

AnyCable 默认监听容器内 8080 端口，需通过 -p <主机端口>:8080 映射至主机，例如 -p 8000:8080 可将服务暴露在主机 8000 端口。

资源限制建议

实时服务器需处理大量网络连接，建议配置以下资源限制：

• 文件描述符限制：通过 --ulimit nofile=65536:65536 提高文件描述符上限（默认系统限制可能较低）
• 内存限制：根据并发连接数调整，建议单实例至少分配 512MB 内存（通过 --memory=512m 设置）

参考链接

• AnyCable 官方文档
• https://github.com/anycable/anycable-go