cleanstart/k8s-sidecar

CleanStart K8S-Sidecar镜像文档

CleanStart K8S-Sidecar镜像提供面向企业环境的生产级安全加固容器，基于最小化基础OS构建并经过全面安全加固，可实现可靠的应用执行与高级安全特性。

📌 基础架构: 基于CleanStart的生产级容器
镜像路径: cleanstart/k8s-sidecar
镜像仓库: CleanStart Registry

拉取最新镜像

从仓库下载容器镜像：

bash
docker pull docker.xuanyuan.run/cleanstart/k8s-sidecar:latest

bash
docker pull docker.xuanyuan.run/cleanstart/k8s-sidecar:latest-dev

说明: cleanstart/k8s-sidecar:latest是基于Python的Kubernetes Sidecar工具，可监听全集群（通过NAMESPACE=ALL）的ConfigMaps和Secrets，并将其数据同步为文件到共享卷；需设置FOLDER_ANNOTATION环境变量，且每个ConfigMap/Secret需添加匹配注解指定目标目录；开启UNIQUE_FILENAMES=true时，文件将以namespace_._.格式命名，避免跨命名空间冲突。

基础运行

使用基础配置运行容器：

bash
docker run -it --name k8s-sidecar docker.xuanyuan.run/cleanstart/k8s-sidecar:latest

生产部署

带生产级安全设置部署：

bash
docker run -d --name k8s-sidecar-prod \
  --security-opt=no-new-privileges \
  --user 1000:1000 \
  --restart unless-stopped \
  docker.xuanyuan.run/cleanstart/k8s-sidecar:latest

卷挂载

挂载本地目录用于持久化数据：

bash
docker run -v /app:/app docker.xuanyuan.run/cleanstart/k8s-sidecar:latest

端口转发

自定义端口映射运行：

bash
docker run -p 8080:8080 docker.xuanyuan.run/cleanstart/k8s-sidecar:latest

Kubernetes安全上下文

Kubernetes部署推荐安全上下文：

yaml
securityContext:
  allowPrivilegeEscalation: false
  capabilities:
    drop:
    - ALL
  readOnlyRootFilesystem: true
  runAsUser: 1000
  runAsGroup: 1000

文档资源

关键链接与扩展信息：

• 容器仓库: [***]
• CleanStart社区镜像: https://hub.docker.com/u/cleanstart
• CleanStart镜像运行指南与示例项目: https://github.com/cleanstart-containers
  • 如何使用Dockerfile运行示例项目
  • 如何通过Kubernetes YAML部署
  • 如何从公共镜像迁移到CleanStart镜像

漏洞声明
CleanStart提供的Docker镜像包含第三方开源库和包，由独立贡献者维护。尽管CleanStart维护这些镜像并应用行业标准安全实践，但无法保证其控制范围外上游组件的安全性或完整性。

用户确认并同意开源软件可能包含未发现的漏洞，或通过更新引入新风险。CleanStart不对第三方库引发的安全问题负责，包括但不限于零日漏洞、供应链***或贡献者引入的风险。

安全是共同责任：CleanStart尽可能提供更新镜像和指导，用户需负责评估部署并实施适当控制。