apache/skywalking-helm
Apache Skywalking Helm镜像提供Skywalking分布式追踪与可观测性平台的Helm Chart，用于在Kubernetes集群中简化其部署、配置管理及版本控制，提升分布式系统监控平台的部署效率与运维便捷性。
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Apache SkyWalking Helm Chart
Deploy https://skywalking.apache.org/ on Kubernetes: the OAP backend, the Horizon UI web console, an optional Satellite gateway, and a storage backend the chart can deploy for you.
This repository holds a Helm chart, not a container image. Install it with
helm installfrom theoci://URL below —docker pullis not how you use it. The images the chart runs are published separately as https://hub.docker.com/r/apache/skywalking-oap-server, https://hub.docker.com/r/apache/skywalking-ui and https://hub.docker.com/r/apache/skywalking-banyandb.
Requires Helm 3.8 or newer — earlier versions cannot pull oci:// charts.
Install
The chart's default storage is Elasticsearch, deployed through https://github.com/elastic/cloud-on-k8s. ECK's CRDs must exist before the chart renders, so install them first:
shellhelm install eck-crds eck-operator-crds \ --repo https://helm.elastic.co --version 3.3.1 \ -n skywalking --create-namespace helm install skywalking oci://registry-1.docker.io/apache/skywalking-helm \ --version 5.0.0 -n skywalking --create-namespace \ --set oap.image.tag=11.0.0 \ --set oap.storageType=elasticsearch \ --set ui.image.tag=horizon-1.0.0 \ --set eck-operator.installCRDs=false
Prefer BanyanDB, SkyWalking's own storage engine? No CRDs needed, and it is much lighter than a three-node Elasticsearch:
shellhelm install skywalking oci://registry-1.docker.io/apache/skywalking-helm \ --version 5.0.0 -n skywalking --create-namespace \ --set oap.image.tag=11.0.0 \ --set oap.storageType=banyandb \ --set ui.image.tag=horizon-1.0.0 \ --set elasticsearch.enabled=false \ --set banyandb.enabled=true \ --set banyandb.image.tag=0.11.0
elasticsearch.enabled defaults to true, so switching storage means turning it off explicitly —
otherwise the chart also installs an Elasticsearch cluster nothing uses.
Required values
Three values have no default and must be set on every install. The chart fails fast, at render time, if any is missing.
| value | description | example |
|---|---|---|
oap.image.tag | OAP server image tag | 11.0.0 |
oap.storageType | storage backend | elasticsearch, banyandb, postgresql |
ui.image.tag | Horizon UI image tag — must be a horizon-* tag | horizon-1.0.0 |
banyandb.image.tag is required as well whenever banyandb.enabled=true.
Set them with --set, or collect them in a file and pass -f my-values.yaml. Every value the
chart accepts is listed in the
https://skywalking.apache.org/docs/skywalking-helm/latest/reference/skywalking-chart-values/.
A fresh install has no login
Horizon UI ships no default credentials, and it does not fail closed: the pod reports Ready,
the login page renders, and no username or password is accepted until you configure users. Set
HORIZON_AUTH_LOCAL_USERS to a JSON array of users — from a Kubernetes Secret in production:
yamlui: envFromSecret: skywalking-ui-users
https://skywalking.apache.org/docs/skywalking-helm/latest/ui/logins/ covers generating the Argon2id password hashes, a throwaway demo login, and the Secret-based setup.
Version compatibility
OAP 11 pins the BanyanDB server API version it accepts and refuses to start against a mismatch, so these three move together:
| chart | OAP | Horizon UI | BanyanDB |
|---|---|---|---|
5.0.0 | 11.0.0 | horizon-1.0.0 | 0.11.x |
4.x | 10.x | 10.x (legacy booster UI) | 0.10.x |
The legacy booster UI is not supported from chart 5.0.0: SkyWalking 11.0.0 removed it from the
distribution, so apache/skywalking-ui publishes no 11.x tag — only horizon-* tags. See
https://skywalking.apache.org/docs/skywalking-helm/latest/evaluate/version-compatibility/
and the https://skywalking.apache.org/docs/skywalking-helm/latest/upgrade/upgrading/.
Documentation
- https://skywalking.apache.org/docs/skywalking-helm/latest/readme/
- https://skywalking.apache.org/docs/skywalking-helm/latest/install/quick-start/
- https://skywalking.apache.org/docs/skywalking-helm/latest/storage/choose-a-backend/
- https://skywalking.apache.org/docs/skywalking-helm/latest/troubleshooting/install-and-startup/
- https://skywalking.apache.org/docs/skywalking-helm/latest/changes/changes/
- https://skywalking.apache.org/docs/main/latest/en/setup/backend/backend-setup/
Source
https://github.com/apache/skywalking-helm
Contact us
- Submit an https://github.com/apache/skywalking/issues
- Mailing list: *******. Mail to
dev-subscribe@skywalking.apache.org, then follow the reply to subscribe. - Send a
Request to join SkyWalking slackmail to the mailing list and we will invite you. Chinese speakers, use[CN] Request to join SkyWalking slack. - ***: ASFSkyWalking
- https://space.bilibili.com/390683219
License
https://github.com/apache/skywalking-helm/blob/master/LICENSE
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 skywalking-helm 镜像标签
docker pull docker.xuanyuan.run/apache/skywalking-helm:<标签>
DockerHub 原生拉取命令
docker pull apache/skywalking-helm:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"
