### 在 Docker 环境下实现 GitLab 的离线安装 要在 Docker 环境中完成 GitLab 的离线安装，主要分为以下几个方面的工作： #### 1. 下载 GitLab 容器镜像 在能够连接互联网的 Linux 主机上下载所需的 GitLab 镜像。可以通过 `docker pull` 命令获取官方发布的 GitLab CE 或 EE 版本镜像。 ```bash docker pull gitlab/gitlab-ce ``` 此命令会拉取最新的稳定版 GitLab 社区版镜像[^1]。如果需要特定版本，则可以在镜像名称后指定版本号，例如： ```bash docker pull gitlab/gitlab-ce:15.7.0 ``` 完成后，将该镜像保存为 tar 文件以便传输至目标离线环境。 ```bash docker save -o gitlab-ce.tar gitlab/gitlab-ce ``` #### 2. 将镜像迁移到离线环境 通过物理介质（如 U 盘）或其他方式将生成的 `gitlab-ce.tar` 文件复制到目标离线机器上。随后加载镜像文件： ```bash docker load -i gitlab-ce.tar ``` 这一步骤确保了即使在网络不可达的情况下也能运行所需镜像[^2]。 #### 3. 创建必要的目录结构 为了持久化数据以及便于管理配置文件，在宿主机创建几个挂载点用于存储 GitLab 数据、日志和配置信息。 ```bash mkdir -p /data/{gitlab/config,gitlab/logs,gitlab/data} ``` 这些路径分别对应于 GitLab 的配置文件夹、日志记录位置及其实际工作区域[^3]。 #### 4. 启动 GitLab 容器实例 利用之前准备好的镜像启动一个新的容器，并设置好外部可访问 URL 和其他参数。 ```bash docker run --detach \ --hostname gitlab.example.com \ --publish 80:80 --publish 443:443 --publish 222:22 \ --name gitlab \ --restart always \ --volume /data/gitlab/config:/etc/gitlab \ --volume /data/gitlab/logs:/var/log/gitlab \ --volume /data/gitlab/data:/var/opt/gitlab \ gitlab/gitlab-ce ``` 上述脚本中的选项解释如下： - `-d`: 脱机模式运行； - `--hostname`: 设定虚拟主机名； - `--publish`: 映射端口使得可以从外界访问 HTTP(S) 及 SSH 功能； - `--name`: 给予容器一个易于识别的名字； - `--restart`: 自定义重启策略以提高可用性； - `--volume`: 把本地磁盘空间绑定进容器内部相应的位置来保持资料一致性。 另外需要注意的是，默认情况下如果没有特别指明的话，HTTP 请求会被导向至根域名下的 `/` 地址；而 HTTPS 则需额外配置证书等内容。 #### 5. 修改初始配置 (Optional) 进入容器修改默认设定满足个性化需求前先确认服务已经正常运作起来之后再做调整比较稳妥一些。编辑位于宿主机上的 `/data/gitlab/config/gitlab.rb` 文件更改外网入口地址等细节部分: ```ruby external_url 'http://your-domain-or-ip' ``` 最后记得应用改动后的配置重载整个系统或者单独组件即可生效: ```bash docker exec -it gitlab gitlab-ctl reconfigure ``` 至此便完成了基于 Docker 的 GitLab 离线部署流程[^4]。 --- ### 注意事项 对于某些特殊场景比如跨平台迁移时还需要考虑兼容性和依赖关系等问题。此外当涉及到多节点集群架构设计的时候也需要规划清楚网络拓扑图及相关联的服务清单等等复杂因素。