本地局域网中如何配置GitLab通过子域名访问？

你确实需要额外配置域名解析相关内容，原因是gitlab.rpi4.local属于自定义子域名，局域网默认的mDNS（负责.local后缀域名解析的服务）不会自动将该域名指向你的树莓派IP，可按以下步骤处理：

1. 配置域名解析（二选一即可） #

方案A：修改访问端hosts文件 #

适合访问GitLab的设备数量较少的场景：

• Windows设备：修改C:\Windows\System32\drivers\etc\hosts
• macOS/Linux设备：修改/etc/hosts
  在文件末尾添加一行内容，将IP替换为你树莓派的实际局域网IP：

192.168.xxx.xxx gitlab.rpi4.local

方案B：局域网路由器配置静态映射 #

适合需要整个局域网所有设备都能访问的场景：

• 登录路由器管理后台，找到静态DNS/hosts映射配置入口
• 添加一条解析记录，将gitlab.rpi4.local指向树莓派的局域网IP，保存后生效

2. 验证GitLab侧配置有效性 #

域名解析配置完成后，可先确认GitLab本身配置无误：

• 登录树莓派本地执行curl http://gitlab.rpi4.local，如果能返回GitLab页面内容，说明GitLab侧配置已经正常生效
• 如果本地访问也失败，检查/etc/gitlab/gitlab.rb中external_url拼写是否正确，修改后必须执行sudo gitlab-ctl reconfigure让配置生效，再执行sudo gitlab-ctl status确认所有GitLab服务处于运行状态

可选：树莓派mDNS广播配置 #

如果你希望树莓派本身的mDNS服务自动广播gitlab.rpi4.local域名，无需修改其他设备或路由器配置，可按以下操作：

• 执行sudo apt install avahi-utils安装mDNS工具
• 编辑/etc/avahi/avahi-daemon.conf，开启publish-aaaa-on-ipv4=yes等发布相关配置
• 添加子域名别名配置文件，写入需要广播的gitlab.rpi4.local后，重启avahi-daemon服务即可

内容的提问来源于stack exchange，提问作者user1414745