ubuntu gitlab 怎样创建项目

Ubuntu 上 GitLab 创建项目的完整步骤

一 前提准备

• 已在 Ubuntu 上安装并运行 GitLab CE，可通过浏览器访问 http://服务器IP或域名。
• 首次登录使用管理员账户（常见为 root），如未设置密码，可在服务器上查看初始密码：sudo cat /etc/gitlab/initial_root_password（该文件中的密码通常在首次启动后 24 小时 内有效）。
• 如需命令行操作，建议提前配置 SSH 密钥 或准备好 Personal Access Token，以便免密推送与拉取。

二 在 Web 界面创建项目

• 登录 GitLab 后，点击左侧导航的 Projects，再点右上角 New project。
• 选择创建方式：
  • Create blank project（空白项目）
  • Create from template（从模板创建）
  • Import project（从外部仓库导入）
• 填写项目信息：
  • Project name（项目名称）与 Description（描述）
  • Visibility Level：Private / Internal / Public
  • 可勾选 Initialize repository with a README 自动生成初始提交
• 点击 Create project 完成创建。

三 本地代码推送到新项目

• 在项目的首页复制仓库地址（支持 HTTPS 或 SSH）。
• 在本地项目目录执行（以 SSH 为例）：

  # 进入项目目录
  cd /path/to/your/project
  
  # 初始化本地仓库（如尚未初始化）
  git init --initial-branch=main
  
  # 关联远程仓库（粘贴你的项目 SSH/HTTPS 地址）
  git remote add origin git@<你的域名或IP>:<群组或用户名>/<项目名>.git
  
  # 添加并提交代码
  git add .
  git commit -m "Initial commit"
  
  # 推送到远端默认分支（通常为 main）
  git push -u origin main
  

• 若使用 HTTPS，按提示输入用户名与 Personal Access Token 或密码；若使用 SSH，确保本机公钥已添加到 GitLab 账户的 SSH Keys。

四 常见问题与快速排查

• 访问 GitLab 页面打不开：确认 external_url 配置正确并已执行 sudo gitlab-ctl reconfigure && sudo gitlab-ctl restart，同时检查 防火墙/安全组 是否放行对应端口。
• 推送被拒绝或权限不足：确认使用正确的 SSH 密钥 或 Token，并且你有该项目的 Maintainer/Developer 权限。
• 忘记管理员密码：可在控制台重置

  sudo gitlab-rails console -e production
  user = User.where(id: 1).first
  user.password = 'YourNewPassword123!'
  user.password_confirmation = 'YourNewPassword123!'
  user.save!
  

  然后重启服务或重新登录。