热门搜索:
apache/karaf
自动构建
Apache Karaf是一个轻量级、模块化的OSGi运行时容器，用于部署和管理企业级应用，支持热部署、动态配置和模块化开发，适用于构建灵活可扩展的分布式系统。
Apache Karaf Docker镜像文档
镜像概述和主要用途
Apache Karaf是基于OSGi规范的开源运行时容器，提供模块化应用的部署、管理和运行环境。该Docker镜像封装了Apache Karaf运行时环境，简化了企业级模块化应用的部署流程，支持快速启动、动态更新和资源隔离，适用于构建微服务架构、分布式系统和模块化企业应用。
核心功能和特性
- OSGi标准支持：完全兼容OSGi 4.2/5.0规范，支持模块化应用开发与部署
- 热部署能力：无需重启容器即可更新应用模块，提高系统可用性
- 轻量级设计：精简的运行时核心，最小化资源占用，适合边缘计算和容器化环境
- 多维度管理：提供命令行控制台(SSH)、Web管理界面和JMX监控接口
- 动态配置：支持配置文件热更新，通过Karaf配置管理服务实时生效
- 扩展性：丰富的特性模块(Feature)，如JPA、JAX-RS、CXF等，可按需安装
- 安全机制：内置用户认证、权限控制和加密配置，保障应用运行安全
使用场景和适用范围
- 企业级应用部署：作为模块化应用的运行容器，支持复杂业务系统的拆分与集成
- 微服务架构：构建基于OSGi的微服务集群，实现服务动态发现和负载均衡
- 边缘计算环境：轻量级特性适合资源受限的边缘设备部署
- 开发测试环境：快速搭建模块化应用的开发调试环境，支持热更新加速迭代
- 遗留系统现代化：将传统应用拆分为OSGi模块，实现增量迁移和功能扩展
使用方法和配置说明
基本运行命令
bashdocker run -d \ --name karaf-container \ -p 8181:8181 \ # HTTP管理端口 -p 8101:8101 \ # SSH控制台端口 -v karaf-data:/opt/karaf/data \ # 持久化数据卷 apache/karaf:latest
Docker Compose配置示例
yamlversion: '3' services: karaf: image: apache/karaf:latest container_name: karaf-service ports: - "8181:8181" # Web管理端口 - "8101:8101" # SSH控制台端口 - "1099:1099" # JMX端口 volumes: - karaf-data:/opt/karaf/data - ./custom-features:/opt/karaf/deploy # 自定义特性部署目录 environment: - JAVA_OPTS="-Xms256m -Xmx512m" # JVM参数配置 - KARAF_USER=admin # 管理员用户名 - KARAF_PASSWORD=admin123 # 管理员密码 restart: unless-stopped volumes: karaf-data: # 持久化Karaf数据和配置
核心配置说明
端口映射
| 端口 | 用途 |
|---|---|
| 8101 | SSH管理控制台端口，默认用户/密码：karaf/karaf |
| 8181 | Web管理界面端口，访问路径：http://localhost:8181/system/console |
| 1099 | JMX监控端口，用于远程监控和管理 |
| 44444 | RMI注册端口，用于OSGi服务远程调用 |
环境变量配置
| 环境变量 | 描述 | 默认值 |
|---|---|---|
| JAVA_OPTS | JVM运行参数 | -Xmx512m -Djava.awt.headless=true |
| KARAF_HOME | Karaf安装目录 | /opt/karaf |
| KARAF_USER | SSH控制台管理员用户名 | karaf |
| KARAF_PASSWORD | SSH控制台管理员密码 | karaf |
| KARAF_OPTS | Karaf启动参数 | 空 |
数据持久化
通过挂载以下目录实现数据持久化：
/opt/karaf/data：存储运行时数据、日志和临时文件/opt/karaf/etc：配置文件目录（如users.properties、org.ops4j.pax.logging.cfg）/opt/karaf/deploy：自动部署目录，放入的OSGi bundle会被自动加载
基本操作示例
进入Karaf控制台
bash# 通过SSH连接容器内Karaf控制台 ssh karaf@localhost -p 8101 # 输入密码（默认：karaf）后进入命令行界面
部署应用模块
bash# 将OSGi bundle复制到deploy目录自动部署 docker cp ./myapp-bundle.jar karaf-container:/opt/karaf/deploy/ # 或通过Karaf控制台手动安装 karaf@root()> bundle:install -s mvn:com.example/myapp/1.0.0
安装特性模块
bash# 安装预定义特性（如CXF、JPA） karaf@root()> feature:install cxf jpa
查看运行状态
bash# 查看已部署bundle状态 karaf@root()> bundle:list # 查看服务状态 karaf@root()> service:list
注意事项
- 生产环境中需修改默认管理员密码，通过
KARAF_USER和KARAF_PASSWORD环境变量配置 - 自定义配置文件建议通过数据卷挂载，避免容器重建后配置丢失
- 高并发场景下可调整
JAVA_OPTS优化JVM参数（如堆内存、GC策略） - 镜像标签遵循Apache Karaf版本号（如
4.4.6），建议指定具体版本而非latest以确保稳定性
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull apache/karaf:<标签>
更多 karaf 镜像推荐
apache/airflow
Apache 软件基金会镜像
Apache Airflow是一个开源的工作流编排平台，旨在通过编程方式（主要使用Python）定义、调度和监控复杂工作流，它以有向无环图（DAG）形式管理任务依赖关系，支持灵活的调度策略（如基于时间、事件或依赖），提供直观的Web界面用于任务状态监控与管理，具备高度可扩展性，可集成多种数据处理工具、云服务及外部系统，广泛应用于数据管道构建、ETL流程自动化、机器学习工作流编排等场景，帮助用户高效管理和执行复杂的任务流程。
626 次收藏10亿+ 次下载
6 天前更新
apache/superset
Apache 软件基金会镜像
Apache Superset是一款开源的数据可视化与数据探索平台，它支持连接多种数据源，允许用户通过直观界面创建交互式仪表盘、图表及报告，无需复杂编程即可进行数据查询与分析，适用于从非技术人员到数据工程师的各类用户，帮助团队高效洞察数据价值，是企业级数据驱动决策的强大工具。
322 次收藏5亿+ 次下载
6 天前更新
apache/tika
Apache 软件基金会镜像
Apache Tika Server的容器镜像，提供内容检测、元数据及文本提取的HTTP服务，便于便捷部署和集成到应用系统中。
54 次收藏1000万+ 次下载
1 个月前更新
apache/kafka
Apache 软件基金会镜像
Apache Kafka是一个开源的分布式流处理平台，旨在提供高吞吐量、低延迟的实时数据流传递服务，支持发布/订阅消息模式，能够持久化存储海量数据流并确保数据可靠性，具备水平扩展能力和容错机制，广泛应用于日志收集、事件驱动架构、实时数据集成及流处理系统等场景，为企业级应用提供高效、稳定的数据流传输与处理解决方案。
206 次收藏1000万+ 次下载
9 天前更新
apache/spark
Apache 软件基金会镜像
Apache Spark是由Apache软件基金会开发的开源分布式计算系统，专为大数据处理设计，支持批处理、流处理、机器学习和图计算等多种数据处理模式，通过基于内存的计算引擎显著提升处理速度，具备高效、易用且可扩展的特性，广泛应用于数据科学与大数据分析领域，为用户提供快速、灵活的大数据处理解决方案。
98 次收藏1000万+ 次下载
2 个月前更新
apache/apisix
Apache 软件基金会镜像
Apache APISIX是一款动态、实时、高性能的云原生API网关，提供负载均衡、动态上游、金丝雀发布、熔断、认证、可观测性等丰富流量管理功能，适用于处理传统南北向流量及服务间东西向流量。
103 次收藏1000万+ 次下载
6 天前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
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 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题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 无法连接轩辕镜像域名怎么办？
域名连通性排查
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 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"