GitLab 远程订阅教程

适用场景：把代理订阅或静态配置文件托管在 GitLab 私有仓库，通过带访问令牌的仓库直链生成一个可远程读取的订阅地址，供代理客户端定时拉取。你会学到令牌创建、URL 拼接与安全注意事项。

操作步骤

  1. 进入目标 GitLab 项目。
  2. 打开 Settings > Access Tokens。

访问令牌入口

  1. 进入访问令牌页面，准备创建新令牌。

访问令牌页面

  1. 点击右上角“创建令牌”，权限按下图或按你的读取需求设置。

创建令牌

  1. 创建完成后立即复制令牌。这个令牌通常只会展示一次。

复制令牌

订阅地址格式

将以下模板中的占位符替换为你的实际值：

https://gitlab.com/api/v4/projects/用户名称%2F项目名称/repository/files/文件名称/raw?ref=main&private_token=访问令牌

参数说明

  • 用户名称%2F项目名称：项目路径，斜杠需要编码为 %2F。
  • 文件名称：仓库中的目标文件名。
  • ref=main：目标分支名称，如果你的默认分支不是 main，需要改成对应分支。
  • private_token：刚创建的访问令牌。

注意事项

  • 令牌泄露后，任何拿到链接的人都可能读取对应文件。
  • 如果只是公开分享静态订阅，优先考虑使用公开仓库或中转服务，避免直接暴露私有令牌。

验证与自查

  1. 用 curl -I "<你的订阅地址>" 测试，返回 200 OK 即直链有效
  2. 将订阅地址粘贴到代理客户端（Clash / Surge / sing-box 等），能成功拉取到节点列表
  3. 用无痕窗口打开订阅链接，确认内容与仓库中的文件一致；分享前检查 URL 中没有多余字符

参考