Gitlab Pages自定义域名所有权验证失败求助

Hey there, let's work through this GitLab Pages domain verification issue step by step— I've dealt with similar DNS-related headaches before, so here's what to check first:

1. Give DNS propagation some time #

DNS changes don't take effect immediately. Even if you just added the required verification record, it can take 5 minutes to 24 hours to propagate across global DNS servers. Start with waiting 30-60 minutes, then hit the "Verify Ownership" button again. To confirm the record is live, run this in your terminal:

dig your-custom-domain.com TXT

Make sure the exact verification string from GitLab shows up in the output.

2. Double-check every detail of your DNS record #

Typos are the #1 culprit here. Head to your domain registrar's DNS settings and verify:

• The record type matches exactly what GitLab requested (almost always a TXT record for ownership checks)
• The host/name field is correct— GitLab might ask for _gitlab-pages-verification-code.your-domain.com or just your root domain, so don't guess; copy it directly from the Domain Details page
• The value is the full, unmodified verification string (no extra spaces, no missing characters at the start/end)

3. Check for conflicting DNS records #

If you have multiple TXT records on the same host, or a CNAME record that's overriding the verification entry, GitLab won't be able to read it. Make sure there are no other records using the same host name as your verification record.

4. Re-generate the verification code #

Sometimes there's a glitch on GitLab's end with the code. Delete your current verification record, go back to Settings > Pages > Domain Details, click "Re-generate verification code", create a new record with the updated string, then try verifying again.

5. Confirm your Pages setup is linked correctly #

Double-check that your domain is listed correctly in the Pages settings, with no typos, and that your repository is properly connected to the Pages site (no accidental disconnects in the repo settings).

If you've tried all these and it still fails, you can check GitLab's internal status dashboard to rule out platform-wide issues— but in most cases, it's just a propagation delay or a tiny typo you missed.

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