logo
1
0
WeChat Login
✨ docs: 更新README中的支持联系方式,统一使用Issue链接

OS - CNB 操作系统环境仓库

用于集中存放和管理 CNB 中常见操作系统环境的仓库,涵盖开发、构建与运行过程中常用的基础系统与定制化系统镜像。

📦 镜像概览

本仓库提供以下类型的 Docker 镜像:

基础镜像

  • zhiqiangwang/cnb:debiandocker.cnb.cool/zhiqiangwang/cnb/os/debian:latest
    基于 Debian Bookworm 的轻量级基础镜像

开发环境镜像

  • zhiqiangwang/cnb:vscodedocker.cnb.cool/zhiqiangwang/cnb/os/debian:vscode
    包含完整开发环境的 Debian 镜像,内置 VS Code Server

🚀 快速开始

拉取镜像

# 拉取基础镜像 (两种方式等效) docker pull zhiqiangwang/cnb:debian # 或 docker pull docker.cnb.cool/zhiqiangwang/cnb/os/debian:latest # 拉取开发环境镜像 (两种方式等效) docker pull zhiqiangwang/cnb:vscode # 或 docker pull docker.cnb.cool/zhiqiangwang/cnb/os/debian:vscode

运行容器

# 运行基础镜像 docker run -it zhiqiangwang/cnb:debian # 或 docker run -it docker.cnb.cool/zhiqiangwang/cnb/os/debian:latest # 运行开发环境(端口映射) docker run -p 8080:8080 -it zhiqiangwang/cnb:vscode # 或 docker run -p 8080:8080 -it docker.cnb.cool/zhiqiangwang/cnb/os/debian:vscode

📋 镜像详情

zhiqiangwang/cnb:debian

基础系统: Debian Bookworm Slim
主要特性:

  • 中文语言环境支持 (zh_CN.UTF-8)
  • 时区设置为 Asia/Shanghai
  • 预装常用工具:git, vim, curl, wget, ping, htop, rsync, lsof
  • 使用腾讯云镜像源加速包下载
  • 支持 git-lfs (Git Large File Storage)

预装软件包:

# 网络工具 iputils-ping dnsutils net-tools tcpdump netcat-openbsd telnet # 开发工具 git git-lfs make openssh-server # 系统工具 htop lsof rsync zip unzip bash-completion vim # 其他工具 curl wget jq

zhiqiangwang/cnb:vscode

基于镜像: zhiqiangwang/cnb:debian
主要特性:

  • 完整的 VS Code Server (code-server) 环境
  • 多语言开发支持 (Node.js, Go, Python)
  • 丰富的 VS Code 扩展插件
  • 数据库客户端支持

开发环境:

  • Node.js: v20.19.4 (通过 NVM 管理)
  • Go: v1.23.12 (通过 GVM 管理)
  • Python: Python 3 + pip
  • 数据库客户端: Redis CLI, MariaDB Client, SQLite3

预装 VS Code 扩展:

  • cnbcool.cnb-welcome - CNB 欢迎插件
  • golang.go - Go 语言支持
  • ms-python.python - Python 语言支持
  • vue.volar - Vue 支持
  • dbaeumer.vscode-eslint - ESLint 代码检查
  • esbenp.prettier-vscode - Prettier 代码格式化
  • bradlc.vscode-tailwindcss - Tailwind CSS 支持
  • usernamehw.errorlens - 错误行显示
  • mikestead.dotenv - .env 文件支持
  • redhat.vscode-yaml - YAML 语言支持
  • DavidAnson.vscode-markdownlint - Markdown 检查
  • ms-vscode.makefile-tools - Makefile 支持
  • ms-azuretools.vscode-docker - Docker 集成
  • tencent-cloud.coding-copilot - 腾讯云 AI 辅助
  • christian-kohler.path-intellisense - 路径智能补全

🔧 构建说明

环境变量

  • CNB_DOCKER_REGISTRY - Docker 注册表地址
  • CNB_REPO_SLUG_LOWERCASE - 仓库名称(小写)
  • DOCKER_USERNAME - Docker Hub 用户名
  • DOCKER_PASSWORD - Docker Hub 密码

构建命令

# 构建 debian 基础镜像 docker buildx build -f debian/Dockerfile -t zhiqiangwang/cnb:debian --platform linux/amd64,linux/arm64/v8,linux/arm/v7,linux/386,linux/arm/v5,linux/ppc64le,linux/s390x --push . # 构建 vscode 开发环境镜像 docker buildx build -f debian/Dockerfile.vscode -t zhiqiangwang/cnb:vscode --platform linux/amd64,linux/arm64 --push .

📁 项目结构

├── .cnb.yml # CNB 构建配置 ├── debian/ │ ├── Dockerfile # Debian 基础镜像 │ └── Dockerfile.vscode # VS Code 开发环境镜像 ├── includes/ │ └── vscode.yml # VS Code 相关配置 ├── LICENSE # Apache 2.0 许可证 └── README.md # 项目文档

🤝 贡献指南

  1. Fork 本仓库
  2. 创建特性分支:git checkout -b feature/new-feature
  3. 提交更改:git commit -am 'Add new feature'
  4. 推送分支:git push origin feature/new-feature
  5. 提交 Pull Request

📄 许可证

本项目采用 Apache License 2.0 许可证。

🆘 支持

如有问题或建议,请通过以下方式联系:


注意: 本镜像专为 CNB 环境优化,建议在 CNB 平台使用以获得最佳体验。

About

用于集中存放和管理 CNB 中常见操作系统环境的仓库,涵盖开发、构建与运行过程中常用的基础系统与定制化系统镜像。

228.00 KiB
1 forks0 stars1 branches0 TagREADMEApache-2.0 license