craftercms/git_https_server

CrafterCMS Git HTTPS Server Docker镜像

镜像概述和主要用途

CrafterCMS Git HTTPS Server Docker镜像是为CrafterCMS生态系统提供Git仓库HTTPS访问能力的容器化组件。该镜像封装了Git HTTPS服务端功能，允许用户通过HTTPS协议安全地进行Git仓库的克隆、推送、拉取等操作，是CrafterCMS内容管理系统中Git工作流的重要组成部分。

注意：SNAPSHOT版本的镜像仅对CrafterCMS企业版用户开放使用。

核心功能和特性

• HTTPS协议支持：原生支持HTTPS协议，确保Git数据传输过程中的安全性
• Git服务集成：与Git版本控制系统深度集成，支持标准Git操作命令
• 容器化部署：基于Docker容器化设计，简化部署流程，提高环境一致性
• CrafterCMS兼容：专为CrafterCMS设计，无缝对接其内容管理和版本控制需求

使用场景和适用范围

• 开发环境：供开发团队通过HTTPS协议访问CrafterCMS项目的Git仓库
• 测试环境：在测试流程中提供安全的Git交互通道
• 生产环境：为生产环境中的CrafterCMS实例提供稳定的Git HTTPS服务支持
• 企业部署：满足企业对数据传输安全性要求较高的场景

使用方法和配置说明

前提条件

• 已安装Docker Engine（推荐版本20.10及以上）
• 已获取CrafterCMS Git HTTPS Server镜像（非SNAPSHOT版本可通过公开渠道获取，SNAPSHOT版本需企业授权）

基本部署示例

1. 使用docker run命令部署

bash
docker run -d \
  -p 443:443 \
  --name crafter-git-https-server \
  docker.xuanyuan.run/craftercms/git-https-server:latest

说明：默认配置下，容器会监听443端口（HTTPS默认端口），实际部署时可根据需求调整端口映射（如-p 8443:443）。

2. 使用docker-compose部署

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  crafter-git-https:
    image: docker.xuanyuan.run/craftercms/git-https-server:latest
    container_name: crafter-git-https-server
    ports:
      - "443:443"
    restart: unless-stopped
    # 可根据需要添加卷挂载以持久化配置和数据
    volumes:
      - ./git-repos:/var/git
      - ./ssl:/etc/ssl/certs

启动服务：

bash
docker-compose up -d

高级配置

自定义SSL证书

默认情况下，镜像可能包含自签名证书用于测试。生产环境中应使用自定义SSL证书：

1. 准备SSL证书文件（如server.crt和server.key）
2. 通过卷挂载方式将证书文件映射到容器内指定路径：

bash
docker run -d \
  -p 443:443 \
  -v /path/to/ssl:/etc/ssl/certs \
  --name crafter-git-https-server \
  docker.xuanyuan.run/craftercms/git-https-server:latest

持久化Git仓库数据

为防止容器重启导致数据丢失，建议将Git仓库目录持久化：

bash
docker run -d \
  -p 443:443 \
  -v /host/path/to/git/repos:/var/git \
  --name crafter-git-https-server \
  docker.xuanyuan.run/craftercms/git-https-server:latest

注意事项

• 证书管理：生产环境中必须使用受信任的SSL证书，避免使用自签名证书
• 版本选择：稳定版本推荐使用非SNAPSHOT标签（如:latest或具体版本号），SNAPSHOT版本仅用于企业版测试
• 安全加固：部署时应限制容器网络访问权限，仅允许必要的IP或网段访问HTTPS端口
• 数据备份：通过卷挂载的Git仓库数据应定期备份，防止数据丢失

参考资料

• CrafterCMS官方文档
• https://github.com/craftercms