yellowfinbi/yellowfin-app-only Docker Image Overview

yellowfinbi/yellowfin-app-only

yellowfinbi

Yellowfin应用程序专用Docker镜像，仅包含Yellowfin应用，可连接现有仓库数据库，支持单实例或集群节点部署，适用于生产环境，数据持久化在外部仓库确保容器关闭时数据不丢失。

3 次收藏下载次数: 0状态：社区镜像维护者：yellowfinbi仓库类型：镜像最近更新：26 天前

轩辕镜像，让镜像更快，让人生更轻。点击查看

中文简介版本下载

轩辕镜像，让镜像更快，让人生更轻。点击查看

Yellowfin应用程序专用Docker镜像

镜像概述和主要用途

Yellowfin应用程序专用镜像仅包含Yellowfin应用程序，可连接到现有仓库数据库。该镜像可用作单实例部署或集群节点，适用于生产环境。由于数据持久化存储在外部仓库中，容器关闭时不会导致数据丢失。

其他部署选项

通过修改DockerFile，可根据特定自定义部署需求调整镜像。构建Docker镜像所需的DockerFile及其他资源可在GitHub获取：[***]

先决条件

Docker安装：运行Yellowfin容器需先安装Docker，请参考官方Docker安装指南。
Yellowfin仓库：应用程序专用镜像要求Yellowfin仓库已预安装在可访问的主机上。

构建应用程序专用镜像

构建Yellowfin应用程序专用镜像时，当前目录需存在Yellowfin JAR安装程序，并命名为yellowfin-installer.jar。

执行以下命令创建镜像：

bash
docker build . -t yellowfinbi/yellowfin-app-only

启动应用程序专用镜像

bash
docker run -d -p 80:8080 \
-e JDBC_CLASS_NAME=org.postgresql.Driver \
-e JDBC_CONN_URL=jdbc:postgresql://dbhost:5432/yellowfinDatabase \
-e JDBC_CONN_USER=dbuser \
-e JDBC_CONN_PASS=dbpassword \
yellowfinbi/yellowfin-app-only:latest

上述命令将以默认设置启动镜像，并在主机的80端口暴露Yellowfin服务。需向镜像传递外部Yellowfin仓库数据库的连接信息。启动应用程序专用容器前，需假设已通过标准Yellowfin安装程序安装了Yellowfin仓库。容器启动所需的JDBC连接设置可从用于安装数据库的实例的Yellowfin/appserver/webapps/ROOT/WEB-INF/web.xml文件中获取。

若Yellowfin仓库位于需要用户提供JDBC驱动的数据库（如Oracle或MySQL）中，可通过LIBRARY_ZIP环境变量将这些驱动添加到Docker容器。

许可证部署

由于应用程序专用镜像使用现有Yellowfin仓库数据库，许可证应已存在。若不存在，可在节点启动后通过Web界面加载，该许可证将应用于所有共享此仓库的Yellowfin节点。

配置选项

可通过-e参数向容器传递配置选项。

配置项	描述	示例
JDBC驱动名称, JDBC_CLASS_NAME	配置连接Yellowfin仓库的JDBC驱动类（必填）	`-e JDBC_CLASS_NAME=org.postgresql.Driver`
仓库URL, JDBC_CONN_URL	指定仓库数据库的连接URL（必填）	`-e JDBC_CONN_URL=jdbc:postgresql://host:5432/yf`
仓库用户名, JDBC_CONN_USER	指定访问仓库数据库所需的数据库用户（必填）	`-e JDBC_CONN_USER=dba`
仓库密码, JDBC_CONN_PASS	指定访问仓库数据库所需的数据库密码（可加密）（必填）	`-e JDBC_CONN_PASS=secret`
应用内存, APP_MEMORY	指定分配给Yellowfin应用的内存（MB），未设置则使用Java默认值（通常为系统RAM的25%）	`-e APP_MEMORY=4096`
应用日志详细级别, LOG_LEVEL	指定应用日志的详细级别（INFO/DEBUG/ERROR/WARN/TRACE）（默认：INFO）	`-e LOG_LEVEL=DEBUG`
数据库密码加密, JDBC_CONN_ENCRYPTED	指定数据库密码是否加密（true/false）	`-e JDBC_CONN_ENCRYPTED=true`
连接池大小, JDBC_MAX_COUNT	指定仓库数据库连接池的最大大小（默认：25）	`-e JDBC_MAX_COUNT=25`
默认欢迎页, WELCOME_PAGE	指定默认索引页	`-e WELCOME_PAGE=custom_index.jsp`
内部应用HTTP端口, APP_SERVER_PORT	指定内部HTTP端口（默认：8080）	`-e APP_SERVER_PORT=9090`
内部关闭端口, TCP_PORT	指定内部关闭端口（默认：8083）	`-e TCP_PORT=9093`
代理端口, PROXY_PORT	外部代理端口	`-e PROXY_PORT=443`
代理协议, PROXY_SCHEME	外部代理协议（http/https）	`-e PROXY_SCHEME=https`
代理主机, PROXY_HOST	外部代理主机或IP地址	`-e PROXY_HOST=reporting.company.com`
安全标志, SECURE_ENABLED	启用安全Connector标志（true/false）（默认：false）	`-e SECURE_ENABLED=true`
Same-Site Cookie模式, SAMESITE_COOKIE_MODE	配置Same-Site Cookie行为（unset/none/lax/strict）（默认：unset）	`-e SAMESITE_COOKIE_MODE=none`
外部集群地址, CLUSTER_ADDRESS	集群通信的外部集群地址，通常为Docker主机的主机名或IP地址	`-e CLUSTER_ADDRESS=10.10.10.23`
外部集群端口, CLUSTER_PORT	容器接收其他节点集群消息的唯一TCP端口	`-e CLUSTER_PORT=7801`
内部集群网络适配器, CLUSTER_INTERFACE	指定绑定集群消息的Docker接口，默认eth0，Kubernetes和Docker Swarm可能需修改	`-e CLUSTER_INTERFACE=match-interface:eth1`
后台处理任务类型, NODE_BACKGROUND_TASKS	逗号分隔的此节点可运行的后台任务类型列表，指定时需同时更新NODE_PARALLEL_TASKS，未指定则启用所有任务类型	`-e NODE_BACKGROUND_TASKS=FILTER_CACHE,ETL_PROCESS_TASK`
后台任务处理作业数, NODE_PARALLEL_TASKS	逗号分隔的每个任务类型的并发任务数列表，数量需与NODE_BACKGROUND_TASKS的任务类型数量匹配	`-e NODE_PARALLEL_TASKS=5,4`
附加库URL, LIBRARY_ZIP	包含附加库的ZIP文件URL，将解压到Yellowfin的lib文件夹，用于添加JDBC驱动或自定义插件（ZIP条目不应包含路径）	`-e LIBRARY_ZIP=[***]`
附加内容URL, CONTENT_ZIP	包含附加内容的ZIP文件URL，将解压到Yellowfin的ROOT文件夹，用于添加样式、图片、JSP文件和库（ZIP可包含子目录）	`-e CONTENT_ZIP=[***]`
跳过OS包更新, SKIP_OS_PACKAGE_UPGRADE	设置为TRUE可阻止容器启动时更新操作系统包	`-e SKIP_OS_PACKAGE_UPGRADE=TRUE`
全局会话超时, SESSION_TIMEOUT	指定会话过期时间（分钟）（默认：30）	`-e SESSION_TIMEOUT=60`

数据存储位置

Yellowfin数据/内容存储在关联的仓库数据库中。终止容器不会导致数据丢失。

启动容器后操作

启动容器后，通过浏览器连接到映射到容器应用端口的Docker主机TCP端口。

示例：

bash
docker run -d -p 9090:8080 \
-e JDBC_CLASS_NAME=org.postgresql.Driver \
-e JDBC_CONN_URL=jdbc:postgresql://dbhost:5432/yellowfinDatabase \
-e JDBC_CONN_USER=dbuser \
-e JDBC_CONN_PASS=dbpassword \
yellowfinbi/yellowfin-app-only:latest

访问地址：
[***]

Docker容器启动后，浏览器可能需要短暂延迟才会响应。

升级Yellowfin

Yellowfin仓库数据库需手动升级，然后针对升级后的数据库启动新版本的Yellowfin应用程序专用容器。对于集群环境的零停机升级，可将现有应用节点置于只读模式，升级数据库，然后启动新版本应用节点。

代理考虑

若Docker容器托管在Web服务器、负载均衡器或代理之后，可能需要使用代理主机、代理协议和代理端口参数帮助Yellowfin生成URL。这些参数配置Yellowfin应用的外部地址和协议，仅适用于Yellowfin应用程序专用Docker镜像。

代理主机

通常是用户访问Yellowfin时通过的代理主机名。

代理端口

用户通过代理访问Yellowfin时连接的TCP端口，通常为80；若外部代理启用SSL，则通常为443。

代理协议

可为HTTP或HTTPS，若代理为非SSL启用的Yellowfin节点提供SSL安全，则设为HTTPS，用于生成环境的正确协议重定向。

安全标志

根据代理性质，可能需要启用安全标志，使应用能够将请求视为来自安全端点。

Same-Site Cookies

若Yellowfin环境的内容需嵌入不同域的外部网站，可能需要修改Same-Site Cookie配置。

SAMESITE_COOKIE_MODE选项定义如下：

unset：不设置Same-Site Cookie属性（默认值）
none：设置Same-Site Cookie属性，Cookie将始终在跨站请求中发送
lax：浏览器仅在同站请求和跨站顶级GET请求中发送Cookie
strict：浏览器阻止在任何跨站请求中发送Cookie

（来源：Apache Tomcat Same-Site Cookie配置）

集群考虑

Yellowfin应用程序专用Docker镜像启用了仓库集群功能，允许多个共享同一仓库数据库的应用节点注册为集群成员。每个集群成员需要唯一的TCP端点用于节点间通信，启动容器时需设置，可通过CLUSTER_ADDRESS和CLUSTER_PORT配置参数进行配置。

集群地址

所有Docker节点（可能运行在不同Docker主机）可解析的地址，通常设为Docker主机的主机名或IP地址。同一主机上运行的多个Yellowfin Docker容器可共享相同的集群地址，但需使用唯一的TCP端口进行通信。

集群端口

暴露到外部网络用于节点间通信的TCP端口，需通过-p参数转发到外部网络。

3节点集群示例

在单主机上运行三个节点需确保外部暴露端口不冲突，为所有容器的Web访问和节点间通信分配唯一端口。Web访问和节点间通信的内部端口分别为8080和7800，通过-p参数映射到Docker主机的非冲突端口。

节点1：

bash
docker run -d -p 81:8080 -p 7801:7800 \
-e JDBC_CLASS_NAME=org.postgresql.Driver \
-e JDBC_CONN_URL=jdbc:postgresql://dbhost:5432/yellowfinDatabase \
-e JDBC_CONN_USER=dbuser \
-e JDBC_CONN_PASS=dbpassword \
-e CLUSTER_ADDRESS=dockerhost1 \
-e CLUSTER_PORT=7801 \
--name yellowfin_node1 \
yellowfinbi/yellowfin-app-only:latest

配置：81端口为暴露的Web UI端口，7801端口用于集群消息传递。

节点2：

bash
docker run -d -p 82:8080 -p 7802:7800 \
-e JDBC_CLASS_NAME=org.postgresql.Driver \
-e JDBC_CONN_URL=jdbc:postgresql://dbhost:5432/yellowfinDatabase \
-e JDBC_CONN_USER=dbuser \
-e JDBC_CONN_PASS=dbpassword \
-e CLUSTER_ADDRESS=dockerhost1 \
-e CLUSTER_PORT=7802 \
--name yellowfin_node2 \
yellowfinbi/yellowfin-app-only:latest

配置：82端口为暴露的Web UI端口，7802端口用于集群消息传递。

节点3：

bash
docker run -d -p 83:8080 -p 7803:7800 \
-e JDBC_CLASS_NAME=org.postgresql.Driver \
-e JDBC_CONN_URL=jdbc:postgresql://dbhost:5432/yellowfinDatabase \
-e JDBC_CONN_USER=dbuser \
-e JDBC_CONN_PASS=dbpassword \
-e CLUSTER_ADDRESS=dockerhost1 \
-e CLUSTER_PORT=7803 \
--name yellowfin_node3 \
yellowfinbi/yellowfin-app-only:latest

配置：83端口为暴露的Web UI端口，7803端口用于集群消息传递。

暴露的Web UI（HTTP）端口（上述示例中的81、82、83）应映射到负载均衡器，以在集群中分发Web流量。客户端通过浏览器连接到单个端点访问Yellowfin实例。测试时，连接任何单个端口将加载对应Yellowfin节点的Web UI。

节点间集群通信通过其他暴露端口（7801、7802、7803）进行。集群地址和端口的组合将注册到Yellowfin仓库，作为每个发现节点的唯一地址。

所有3个节点启动后，访问info_cluster.jsp应显示3个节点已加入集群。

!集群信息

诊断潜在问题和修改配置

可通过exec命令连接到运行中的Yellowfin实例，访问日志文件和系统设置。

bash
docker exec -it <docker容器ID> /bin/sh

通过以下命令获取Docker容器ID：

bash
docker container list

若在运行中的Docker容器中修改了设置，Yellowfin可能需要重启，可通过以下命令重启：

bash
docker restart <docker容器ID>

查看更多 yellowfin-app-only 相关镜像 →

yellowfinbi/yellowfin-all-in-one

yellowfinbi

Yellowfin All-In-One镜像包含Yellowfin应用和存储数据库，适用于短期试用和演示，数据存储在容器内，容器关闭后数据丢失，不支持集群环境。

3 次收藏5万+ 次下载

26 天前更新

testcontainers/helloworld

testcontainers

Testcontainers是一款帮助开发者在测试环境中便捷集成并使用真实依赖服务（如数据库、消息队列、缓存等）的工具，而此Docker镜像专门用于支持Testcontainers自身的自测套件运行，可确保其核心功能（包括容器生命周期管理、跨平台兼容性、服务模拟准确性等）在不同测试场景下均能得到稳定验证，为Testcontainers的持续迭代优化和整体质量保障提供关键技术支撑。

8 次收藏100万+ 次下载

6 个月前更新

airbyte/destination-yellowbrick

为Kasm Workspaces提供集成的OnlyOffice办公套件，支持文档、表格、演示文稿的在线编辑与协作，便于在容器化远程桌面环境中高效处理办公任务。

29 次收藏500万+ 次下载

2 天前更新

onlyoffice/documentserver

onlyoffice

功能丰富的基于Web的办公套件，具备广泛的协作功能。

“Hello World!”是一个经典的入门示例，具体而言是最小化Docker化的范例，它通过简单的应用展示了如何利用Docker将程序打包为容器，涵盖基础的镜像构建与容器运行流程，适合初学者快速理解Docker的核心概念及基本操作，直观体现了Docker化的简洁性与入门友好性。

2.5千次收藏10亿+ 次下载

12 天前更新

轩辕镜像配置手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

Docker 配置

登录仓库拉取

通过 Docker 登录认证访问私有仓库

专属域名拉取

无需登录使用专属域名

K8s Containerd

Kubernetes 集群配置 Containerd

K3s

K3s 轻量级 Kubernetes 镜像加速

Dev Containers

VS Code Dev Containers 配置

Podman

Podman 容器引擎配置

Singularity/Apptainer

HPC 科学计算容器配置

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

Harbor 镜像源配置

Harbor Proxy Repository 对接专属域名

Portainer 镜像源配置

Portainer Registries 加速拉取

Nexus 镜像源配置

Nexus3 Docker Proxy 内网缓存

系统配置

Linux

在 Linux 系统配置镜像服务

Windows/Mac

在 Docker Desktop 配置镜像

MacOS OrbStack

MacOS OrbStack 容器配置

Docker Compose

Docker Compose 项目配置

NAS 设备

群晖

Synology 群晖 NAS 配置

飞牛

飞牛 fnOS 系统配置镜像

绿联

绿联 NAS 系统配置镜像

威联通

QNAP 威联通 NAS 配置

极空间

极空间 NAS 系统配置服务

网络设备

爱快路由

爱快 iKuai 路由系统配置

宝塔面板

在宝塔面板一键配置镜像

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

使用与功能问题

配置了专属域名后，docker search 为什么会报错？

docker search 限制

Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？

站内搜不到镜像

机器不能直连外网时，怎么用 docker save / load 迁镜像？

离线 save/load

docker pull 拉插件报错（plugin v1+json）怎么办？

插件要用 plugin install

WSL 里 Docker 拉镜像特别慢，怎么排查和优化？

WSL 拉取慢

轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？

安全与 digest

第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？

新手拉取配置

错误码与失败问题

docker pull 提示 manifest unknown 怎么办？

manifest unknown

docker pull 提示 no matching manifest 怎么办？

no matching manifest（架构）

镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？

invalid tar header（解压）

Docker pull 时 HTTPS / TLS 证书验证失败怎么办？

TLS 证书失败

Docker pull 时 DNS 解析超时或连不上仓库怎么办？

DNS 超时

Docker 拉取出现 410 Gone 怎么办？

410 Gone 排查

出现 402 或「流量用尽」提示怎么办？

402 与流量用尽

Docker 拉取提示 UNAUTHORIZED（401）怎么办？

401 认证失败

遇到 429 Too Many Requests（请求太频繁）怎么办？

429 限流

docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？

D-Bus 凭证提示

为什么会出现「单层超过 20GB」或 413，无法加速拉取？

413 与超大单层

账号 / 计费 / 权限

轩辕镜像免费版和专业版有什么区别？

免费版与专业版区别

轩辕镜像支持哪些 Docker 镜像仓库？

支持的镜像仓库

镜像拉取失败还会不会扣流量？

失败是否计费

麒麟 V10 / 统信 UOS 提示 KYSEC 权限不够怎么办？

KYSEC 拦截脚本

如何在轩辕镜像申请开具发票？

申请开票

怎么修改轩辕镜像的网站登录和仓库登录密码？

修改登录密码

如何注销轩辕镜像账户？要注意什么？

注销账户

配置与原理类

写了 registry-mirrors，为什么还是走官方或仍然报错？

mirrors 不生效

怎么用 docker tag 去掉镜像名里的轩辕域名前缀？

去掉域名前缀

如何拉取指定 CPU 架构的镜像（如 ARM64、AMD64）？

指定架构拉取

用轩辕镜像拉镜像时快时慢，常见原因有哪些？

拉取速度原因

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"