云电脑运行Gitlab，搭建网站代码仓库

云电脑运行GitLab搭建网站代码仓库

在云电脑上运行GitLab，可以快速搭建一个私有的网站代码仓库，实现代码托管、版本控制和团队协作。
整个过程的核心是借助Docker容器化部署，避免复杂的环境配置。
本文面向零基础用户，从准备到验证逐步展开，跟着操作即可完成搭建。

云电脑环境检查和Docker安装

云电脑通常预装Linux系统，推荐Ubuntu 22.04或CentOS 7以上。
首先通过SSH登录云电脑，检查系统版本和资源：

cat /etc/os-release
free -h
df -h

GitLab对内存有一定要求，建议云电脑配置不低于2核4GB，否则运行可能卡顿。
确认无误后安装Docker。
以Ubuntu为例：

sudo apt update
sudo apt install -y docker.io
sudo systemctl enable docker
sudo systemctl start docker

安装完成后，运行docker --version能看到版本号即表示成功。
如果使用CentOS，可将apt替换为yum，并安装docker-ce。

拉取镜像并启动GitLab容器

GitLab官方提供了社区版镜像，直接拉取并运行。
注意将宿主机目录挂载到容器内，方便数据持久化。

sudo docker run --detach \
  --hostname gitlab.example.com \
  --publish 443:443 --publish 80:80 --publish 2222:22 \
  --name gitlab \
  --restart always \
  --volume /srv/gitlab/config:/etc/gitlab \
  --volume /srv/gitlab/logs:/var/log/gitlab \
  --volume /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest

关键参数说明：

• --hostname：填写云电脑的公网IP或已解析的域名，后续克隆地址会用到。
• --publish 2222:22：将容器SSH端口映射到宿主机2222，避免与云电脑默认22端口冲突。
• --volume：三个目录分别持久化配置、日志和数据，即使容器删除，数据也不会丢失。

启动后等待1-2分钟，通过sudo docker ps查看容器状态为Up即表示运行中。

获取初始密码并登录配置

GitLab首次启动会自动生成root密码，执行以下命令查看：

sudo docker exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password

复制输出的密码，在浏览器访问http://云电脑公网IP，使用用户名root和该密码登录。
登录后立即修改密码，并创建项目测试。

在GitLab界面点击“New project”创建一个空白项目，命名为website-repo。
创建成功后，页面会显示仓库地址，例如http://云电脑IP/root/website-repo.git。

上传网站代码并验证克隆

回到本地电脑，确保已安装Git。
打开终端，进入你的网站代码目录，执行：

git init
git remote add origin http://云电脑IP/root/website-repo.git
git add .
git commit -m "首次提交网站代码"
git push -u origin main

如果推送时提示输入用户名密码，输入root和修改后的密码即可。
推送成功后，刷新GitLab页面，能看到文件列表。
为了验证克隆，另开一个目录执行：

git clone http://云电脑IP/root/website-repo.git

能完整下载代码说明仓库运行正常。

常见问题与避坑要点

内存不足导致502错误：GitLab对内存消耗较大，如果云电脑内存小于4GB，建议增加交换分区或升级配置。
可临时创建2GB交换文件：

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

SSH克隆端口错误：由于容器SSH映射到2222端口，克隆时需指定端口：

git clone ssh://git@云电脑IP:2222/root/website-repo.git

修改外部访问地址：
如果云电脑IP变动或绑定域名，
需要进入容器修改/etc/gitlab/gitlab.rb中的external_url，
然后执行sudo docker exec -it gitlab gitlab-ctl reconfigure重新配置。

数据备份：定期备份/srv/gitlab/data和/srv/gitlab/config目录，可直接打包压缩后下载到本地。

验证部署结果和后续使用

完成上述步骤后，可以通过以下方式确认GitLab已正常工作：

• 浏览器访问http://云电脑IP，能正常显示登录页并登录。
• 使用git push推送代码无报错，且GitLab界面能看到提交记录。
• 执行sudo docker logs gitlab查看日志，没有持续报错信息。

日常使用中，建议为云电脑设置定时快照，避免数据丢失。
如果团队协作，可在GitLab中创建多个用户并分配权限。
至此，你已经在云电脑上成功运行GitLab并搭建了网站代码仓库，后续可以基于它进行版本管理和自动化部署。