safesecurity/nginx-nchan

Nchan Docker镜像

配置了Nchan模块的Docker化Nginx镜像，可用于构建实时通信应用。Nchan是一个功能强大的Nginx模块，提供发布/订阅、WebSocket、消息队列等功能。

Nchan官方文档：Nchan.io

核心功能和特性

• 支持HTTP发布/订阅模式
• 提供WebSocket订阅功能
• 消息缓冲机制，可配置缓冲长度
• 频道管理功能，支持自定义频道ID
• 可配置订阅超时时间

使用场景和适用范围

• 实时通知系统
• 聊天应用
• 实时数据更新服务
• WebSocket通信服务
• 消息推送系统

详细使用方法和配置说明

1. 创建路由配置

创建Nginx配置文件，定义发布者(publisher)和订阅者(subscriber)路由。参考示例配置：

nginxconf
server {
    listen       80;
    listen  [::]:80;
    server_name  localhost;

    location /publish {
        nchan_publisher;
        
        nchan_channel_id example;  # 频道ID，可自定义
        nchan_message_buffer_length 2000;  # 消息缓冲长度
    }

    location /subscribe {
        nchan_subscriber;

        nchan_channel_id example;  # 需与发布者频道ID一致
        nchan_subscriber_timeout 30;  # 订阅超时时间(秒)
    }

}

2. 构建镜像

创建Dockerfile，复制配置文件到镜像中：

注意：为保证稳定性，请使用带标签的版本，latest标签可能会频繁变更，可能影响运行中的应用。

dockerfile
FROM darkflib/nginx-nchan:latest

COPY nchan-example.conf /etc/nginx/conf.d/

执行构建命令：

shell
docker build -t my-nginx-image:latest .

3. 运行镜像

shell
docker run -d --name nginx -p 80:80 my-nginx-image:latest

4. 发布消息

使用curl命令发布消息：

shell
$ curl -d "hello=1" http://localhost/publish
queued messages: 1
last requested: -1 sec. ago
active subscribers: 0
last message id: 1627379093:0

5. 订阅消息

使用curl命令订阅消息：

shell
$ curl http://localhost/subscribe  
hello=1