注意：这是 lightstreamer 官方镜像 的 arm64v8 架构构建的“每架构”仓库——更多信息，请参见官方镜像文档中的“非 amd64 架构？”和官方镜像 FAQ 中的“镜像源在 Git 中已更改，该怎么办？”。

快速参考

• 维护者：
  Lightstreamer 服务器开发团队

• 获取帮助的途径：
  Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的 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

快速参考（续）

• 提交 issues 的途径：
  [***]

• 支持的架构：(更多信息)
  amd64, arm64v8

• 镜像 artifact 详情：
  repo-info 仓库的 repos/lightstreamer/ 目录（历史记录）
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/lightstreamer 标签
  official-images 仓库的 library/lightstreamer 文件（历史记录）

• 本描述的来源：
  docs 仓库的 lightstreamer/ 目录（历史记录）

什么是 Lightstreamer Server？

Lightstreamer 是一个针对互联网优化的实时消息服务器。它融合 WebSocket、HTTP 和推送通知技术，可向移动、平板、浏览器、桌面和 IoT 应用流式传输数据（双向）。

有关 Lightstreamer Server 及其他 Lightstreamer 产品的更多信息和相关下载，请访问 [***]

!logo

如何使用本镜像

启动和运行

使用默认配置启动容器：

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

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

自定义设置

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

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

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

$ 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 arm64v8/lightstreamer

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

$ 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 arm64v8/lightstreamer

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

FROM arm64v8/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 相同的目录中。运行以下命令构建新镜像：

$ docker build -t my-lightstreamer .

然后启动容器：

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

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

适配器集（Adapter Sets）部署

可能需要使用自定义或第三方适配器集。可采用类似上述的策略实现：

部署单个适配器集

部署单个自定义适配器集的最简单方法是将其文件挂载到工厂适配器文件夹：

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

完全替换“adapters”文件夹

若需部署多个自定义适配器集，更合适的策略是用主机中的文件夹替换工厂适配器文件夹：

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

此时，/path/to/my-adapters 文件夹需符合适配器文件夹的 required 结构：

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

构建新镜像

同样，一种线性且清晰的方法是创建包含所有所需文件的新镜像。此时，可编写简单的 Dockerfile，列出所有适配器集配置文件：

FROM arm64v8/lightstreamer

# 将 N 个适配器集的内容复制到工厂适配器文件夹
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 服务器提供自定义页面。同样，可使用上述技术自定义容器。例如，通过以下命令完全替换工厂 pages 文件夹：

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

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

许可证

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

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

可在 repo-info 仓库的 lightstreamer/ 目录 中找到一些能够自动检测到的额外许可证信息。

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