如何不克隆自托管企业GitHub仓库列出仓库文件

地址解析报错的核心原因 #

此前替换API地址时出现域名无法解析的问题，本质是自行猜测独立API子域名，没有遵循GitHub Enterprise Server的固定路径规则。
根据你给出的仓库访问格式https://company.net/org/reponame，自托管实例的API基础地址无需单独配置独立子域，正确格式为同主域下的/api/v3路径，对应你的场景即为https://company.net/api/v3。大部分企业自托管部署不会拆分独立的API访问子域，自行猜测的api.company.net域名如果没有在企业DNS中配置记录，自然会触发解析失败的错误。

无克隆查询全量文件的操作流程 #

前置准备 #

• 在自托管GitHub企业实例内生成具备repo读取权限的经典个人访问令牌，所有接口请求必须携带该令牌完成身份校验，否则会触发权限拦截
• 若自托管实例使用自签名HTTPS证书，保留curl命令的-k参数跳过证书校验即可，与公有版的使用逻辑完全一致

递归拉取全量文件 #

使用Git Trees递归查询接口，无需逐层级遍历子目录，单次请求即可获取仓库全量结构：

curl -k \
  -H "Authorization: token 你的企业实例访问令牌" \
  "https://company.net/api/v3/repos/对应组织名/对应仓库名/git/trees/目标分支名?recursive=1"

参数及返回说明：

• ?recursive=1参数用于开启递归遍历，接口会返回仓库从根目录到最深路径的所有条目
• 返回的JSON结构中，type字段为blob的条目即为仓库内的实际文件，type为tree的条目为子目录
• 提取所有type=blob条目下的path字段值，即可得到仓库的全量文件列表

旧示例命令不适配的原因 #

你参考的公有版命令curl -k https://api.github.com/user/repo?refs=master 本身仅用于查询个人空间下的仓库元信息，不返回任何文件列表数据。同时企业版的仓库类接口统一挂载在/repos/路径下，不存在根路径直接查询个人仓库的快捷入口，叠加API基址的域名规则差异，直接替换域名自然无法适配企业场景。

常见报错快速排查 #

• 域名解析失败：弃用自行猜测的独立API子域，直接替换为主域下的/api/v3路径即可解决
• 接口返回404：核对路径中的组织名、仓库名与浏览器访问的地址完全匹配，注意大小写区分
• 接口返回401/403：确认使用的访问令牌是从当前自托管企业实例生成，而非公有GitHub平台的令牌，且令牌权限覆盖了目标仓库的读取范围

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