Lightstreamer Server 镜像文档

镜像概述和主要用途

Lightstreamer是一款针对互联网优化的实时消息服务器。它融合WebSocket、HTTP和推送通知技术，向移动、平板、浏览器、桌面和IoT应用流式传输数据。该镜像为amd64架构构建，提供了便捷部署Lightstreamer Server的方式，适用于需要实时数据交互的各类应用场景。

核心功能和特性

• 实时数据传输：优化互联网环境下的低延迟数据流式传输
• 多协议支持：融合WebSocket、HTTP和推送通知技术
• 多平台兼容：支持移动、平板、浏览器、桌面及IoT设备
• 灵活配置：可通过自定义配置文件调整服务器行为
• 可扩展架构：支持部署自定义Adapter Sets和Web内容

快速参考

维护者

Lightstreamer Server开发团队

获取帮助的途径

Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

问题反馈地址

[***]

支持的架构

(更多信息)
amd64、arm64v8

镜像详情

repo-info仓库的lightstreamer/目录（历史记录）
（包含镜像元数据、传输大小等信息）

镜像更新

official-images仓库的library/lightstreamer标签
official-images仓库的library/lightstreamer文件（历史记录）

描述来源

docs仓库的lightstreamer/目录（历史记录）

支持的标签和Dockerfile链接

• 6.0.3, 6.0
• 6.1.0, 6.1, 6
• 7.0.3-jdk8-temurin, 7.0-jdk8-temurin, 7.0.3-jdk8, 7.0-jdk8
• 7.0.3-jdk11-temurin, 7.0-jdk11-temurin, 7.0.3-jdk11, 7.0-jdk11, 7.0.3, 7.0
• 7.1.3-jdk8-temurin, 7.1-jdk8-temurin, 7.1.3-jdk8, 7.1-jdk8
• 7.1.3-jdk11-temurin, 7.1-jdk11-temurin, 7.1.3-jdk11, 7.1-jdk11, 7.1.3, 7.1
• 7.2.2-jdk8-temurin, 7.2-jdk8-temurin, 7.2.2-jdk8, 7.2-jdk8
• 7.2.2-jdk11-temurin, 7.2-jdk11-temurin, 7.2.2-jdk11, 7.2-jdk11, 7.2.2, 7.2
• 7.3.3-jdk8-temurin, 7.3-jdk8-temurin, 7.3.3-jdk8, 7.3-jdk8
• 7.3.3-jdk11-temurin, 7.3-jdk11-temurin, 7.3.3-jdk11, 7.3-jdk11
• 7.3.3-jdk17-temurin, 7.3-jdk17-temurin, 7.3.3-jdk17, 7.3-jdk17, 7.3.3, 7.3
• 7.4.7-jdk8-temurin, 7.4-jdk8-temurin, 7-jdk8-temurin, 7.4.7-jdk8, 7.4-jdk8, 7-jdk8
• 7.4.7-jdk11-temurin, 7.4-jdk11-temurin, 7-jdk11-temurin, 7.4.7-jdk11, 7.4-jdk11, 7-jdk11
• 7.4.7-jdk17-temurin, 7.4-jdk17-temurin, 7-jdk17-temurin, 7.4.7-jdk17, 7.4-jdk17, 7-jdk17
• 7.4.7-jdk21-temurin, 7.4-jdk21-temurin, 7-jdk21-temurin, 7.4.7-jdk21, 7.4-jdk21, 7-jdk21, 7.4.7, 7.4, 7, latest

使用方法

快速启动

使用默认配置启动容器：

console
$ docker run --name ls-server -d -p 80:8080 amd64/lightstreamer

此命令将容器内的8080端口映射到本地主机的80端口。然后在浏览器中访问http://localhost，即可查看欢迎页面，其中包含实时数据流演示应用，展示Lightstreamer技术的独特功能。更多示例可访问演示站点。

自定义设置

可自定义容器中运行的Lightstreamer实例的各个方面。例如，可提供特定的配置文件：

console
$ docker run --name ls-server -v /path/to/my-lightstreamer_conf.xml:/lightstreamer/conf/lightstreamer_conf.xml -d -p 80:8080 amd64/lightstreamer

同样，可提供自定义日志配置，此时可能还需要指定专用卷以确保日志文件的持久性和容器的更好性能：

console
$ docker run --name ls-server -v /path/to/my-lightstreamer_log_conf.xml:/lightstreamer/conf/lightstreamer_log_conf.xml -v /path/to/logs:/lightstreamer/logs -d -p 80:8080 amd64/lightstreamer

如果在my-lightstreamer_log_conf.xml文件中将默认日志路径从../logs更改为/path/to/dest/logs，则命令如下：

console
$ docker run --name ls-server -v /path/to/my-lightstreamer_log_conf.xml:/lightstreamer/conf/lightstreamer_log_conf.xml -v /path/to/hosted/logs:/path/to/dest/logs -d -p 80:8080 amd64/lightstreamer

或者，可通过Dockerfile构建新镜像来完成上述任务：

dockerfile
FROM amd64/lightstreamer

# 仅为所需的自定义配置文件指定COPY命令
COPY my-lightstreamer_conf.xml /lightstreamer/conf/lightstreamer_conf.xml
COPY my-lightstreamer_log_conf.xml /lightstreamer/conf/lightstreamer_log_conf.xml

将自定义配置文件（my-lightstreamer_conf.xml和my-lightstreamer_log_conf.xml）放在与Dockerfile相同的目录中，然后执行：

console
$ docker build -t my-lightstreamer .

构建完成后启动容器：

console
$ docker run --name ls-server -d -p 80:8080 my-lightstreamer

有关如何配置Lightstreamer服务器的更多详细信息，请参阅安装目录下conf文件夹中的lightstreamer_conf.xml和lightstreamer_log_conf.xml文件中的内联文档。

部署Adapter Sets

可使用自定义开发或第三方提供的Adapter Sets。有以下几种部署策略：

部署单个Adapter Set

将Adapter Set文件挂载到factory adapters文件夹：

console
$ docker run --name ls-server -v /path/to/my-adapter-set:/lightstreamer/adapters/my-adapter-set -d -p 80:8080 amd64/lightstreamer

完全替换"adapters"文件夹

如需部署多个自定义Adapter Sets，可将factory adapters文件夹替换为主机中的文件夹：

console
$ docker run --name ls-server -v /path/to/my-adapters:/lightstreamer/adapters -d -p 80:8080 amd64/lightstreamer

此时，/path/to/my-adapters文件夹需符合adapters文件夹的要求结构：

console
/path/to/my-adapters+
                    +my_adapter_set_1
                    +my_adapter_set_2
                    ...
                    +my_adapter_set_N

构建新镜像

通过Dockerfile包含所有需要的Adapter Sets配置文件：

dockerfile
FROM amd64/lightstreamer

# 将N个Adapter Sets的内容复制到factory adapters文件夹
COPY my-adapter-set-1 /lightstreamer/adapters/my-adapter-set-1
COPY my-adapter-set-2 /lightstreamer/adapters/my-adapter-set-2
COPY my-adapter-set-3 /lightstreamer/adapters/my-adapter-set_3

然后按照前述方法构建并启动容器。

部署Web服务器页面

如需为Lightstreamer Server的内部Web服务器提供自定义页面，可使用类似方法：

console
$ docker run --name ls-server -v /path/to/custom/pages:/lightstreamer/pages -d -p 80:8080 amd64/lightstreamer

其中/path/to/custom/pages是主机中包含替换Web内容文件的路径。

许可证

查看此镜像中包含软件的许可证信息。

与所有Docker镜像一样，此镜像可能还包含其他软件（如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项），这些软件可能采用其他许可证。

部分可自动检测的附加许可证信息可在repo-info仓库的lightstreamer/目录中找到。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可证。