datalust/seq

Seq Docker镜像文档

概述

Seq是一款日志服务器，用于收集、存储、分析和可视化结构化日志数据。datalust/seq镜像提供Seq的官方Linux容器化部署方案，便于在Docker环境中快速搭建和运行Seq服务。详细使用说明可参考Seq文档。

快速开始

基础部署

使用容器本地存储并在5341端口运行所有服务：

bash
docker run --name seq -d --restart unless-stopped -e ACCEPT_EULA=Y -e SEQ_PASSWORD=<password> -p 5341:80 docker.xuanyuan.run/datalust/seq:latest

高级部署

使用哈希默认密码、从主机挂载存储目录、将UI映射到主机80端口、5341端口仅用于摄入，并设置外部（公开）URL example.com：

bash
PH=$(echo '<password>' | docker run --rm -i datalust/seq config hash)

docker run \
  --name seq \
  -d \
  --restart unless-stopped \
  -e ACCEPT_EULA=Y \
  -e SEQ_API_CANONICALURI=https://seq.example.com \
  -e SEQ_FIRSTRUN_ADMINPASSWORDHASH="$PH" \
  -v /path/to/seq/data:/data \
  -p 80:80 \
  -p 5341:5341 \
  docker.xuanyuan.run/datalust/seq

将<password>替换为admin用户账户的初始密码。

端口和目录

datalust/seq容器内部使用以下端口和目录：

• :80：UI端口，允许摄入和API请求。
• :5341：仅摄入端口，不允许API请求。
• /data：Seq数据目录。

环境变量

Seq容器支持以下环境变量：

• ACCEPT_EULA：必须设置为Y，表示接受Seq最终用户许可协议（EULA）。
• SEQ_PASSWORD：初始化新实例时必须设置；也可使用SEQ_FIRSTRUN_NOAUTHENTICATION=True禁用认证，或通过SEQ_FIRSTRUN_ADMINPASSWORDHASH提供预哈希的默认密码。
• SEQ_API_CANONICALURI：可选，指定访问Seq容器的外部URI（生成通知/登录重定向中的入站链接时需要）。

其他配置设置（通过seq config命令查看）可通过环境变量设置，格式为SEQ_前缀加上配置路径的大写蛇形命名。例如：

• api.ingestionPort 对应 SEQ_API_INGESTIONPORT
• firstRun.adminPasswordHash 对应 SEQ_FIRSTRUN_ADMINPASSWORDHASH
• storage.secretKey 对应 SEQ_STORAGE_SECRETKEY

完整配置值列表参见文档。

内存限制

为使Seq准确测量可用内存，通常需为容器指定内存限制。若Seq容器意外退出或出现内存不足错误，可在docker run中添加--memory和--memory-swap参数：

bash
docker run --memory=16g --memory-swap=16g <其他参数> datalust/seq

参数值为系统应为容器提供的总内存（建议越大越好）。通常两者设为相同值，以禁用容器交换空间。

支持的标签

Seq镜像采用以下标签方案，可控制实例升级范围：

• latest：最新生产就绪镜像，拉取时可能包含主版本更新。
• major/major.minor/major.minor.patch（如2020/2020.1/2020.1.4292）：指定主版本的最新生产就绪镜像，指定次要或补丁版本可固定实例到对应版本。
• preview：最新非生产预览镜像。注意：preview镜像无法降级到latest，可能导致数据丢失。

许可证

Seq根据其最终用户许可协议（EULA）提供。Seq的“设置”>“许可证”页面包含对应版本生效时的EULA副本。

Seq内置的个人许可证允许开发者本地运行，并支持独立开发者生产环境使用，仅限个人。多用户许可证及定价详情请访问Seq官网。

通过ACCEPT_EULA环境变量传递Y值，即表示您已阅读并接受适用于所使用Seq Docker镜像的最终用户许可协议条款。