在Windows上配置GitLab必须通过Docker Desktop运行Linux容器，需启用Hyper-V、VirtualMachinePlatform和WSL2，安装WSL2内核更新包，配置Docker Desktop启用WSL2集成，创建D:\gitlab目录及子目录，运行docker run命令启动GitLab容器，首次访问http://localhost设置root密码后即可登录。
在Windows系统上配置GitLab代码托管服务器环境，必须通过Docker Desktop运行Linux容器实现，因为GitLab官方不支持原生Windows安装，直接双击exe或用gem install gitlab等方法均无法成功启动服务。
启用Windows虚拟化与WSL2支持
打开PowerShell（以管理员身份运行），依次执行以下三条命令：
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
执行完每条命令后需重启电脑一次。第三条命令执行后若提示“操作成功”，但wsl --list仍无输出，说明WSL内核未安装，此时需手动下载并安装WSL2 Linux内核更新包（从Microsoft官网搜索“WSL2 Kernel Update”获取msi安装器）。
安装并配置Docker Desktop
从Docker官网下载Docker Desktop for Windows安装包，安装时务必勾选“Use the WSL 2 based engine”。安装完成后启动Docker Desktop，右下角托盘图标显示绿色鲸鱼即为就绪。
右键托盘图标→Settings→Resources→WSL Integration，开启已安装的Linux发行版（如Ubuntu）的集成开关。
【必须确认Docker能调用WSL2，否则后续gitlab容器无法挂载Windows路径】
AI 领域系统学习体系。管理知识图谱、深度学习笔记、实战复盘和关联网络。触发场景：学习计划、知识图谱更新、深度研究某个 AI 主题、实战复盘总结、调研后沉淀知识、每周学习回顾。当用户说'学了什么'、'总结一下'、'沉淀知识'、'复盘'、'更新图谱'、'深入研究'、'写笔记'、'学习回顾'、'review what...
创建GitLab数据目录并运行容器
在D盘根目录新建文件夹：D:\gitlab，并在其下建立三个子目录：config、logs、data。
打开命令提示符（非管理员权限即可），粘贴并执行以下命令：
docker run --detach --hostname gitlab.example.com --publish 443:443 --publish 80:80 --publish 22:22 --name gitlab --restart always --volume D:\gitlab\config:/etc/gitlab --volume D:\gitlab\logs:/var/log/gitlab --volume D:\gitlab\data:/var/opt/gitlab gitlab/gitlab-ce:latest
该命令会自动拉取镜像并后台启动容器。首次运行需5–15分钟，期间GitLab正在初始化数据库、生成密钥、配置Nginx等。可通过docker logs -f gitlab实时查看启动日志，直到出现gitlab Reconfigured!字样即完成初始化。
首次访问与管理员密码设置
打开浏览器，访问 http://localhost。
页面加载完成后，输入新密码（至少8位，含大小写字母和数字），点击“Change your password”。该密码即为root用户的登录凭据。
密码提交后自动跳转至登录页，使用用户名root和刚设的密码登录。
