ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

al-folio 部署时提示需要 GitHub 登录凭证且密码认证被禁用怎么解决?

al-folio 部署时提示需要 GitHub 登录凭证且密码认证被禁用怎么解决? al-folio 部署时提示需要 GitHub 登录凭证且密码认证被禁用怎么解决【免费下载链接】al-folioA beautiful, simple, clean, and responsive Jekyll theme for academics项目地址: https://gitcode.com/GitHub_Trending/al/al-folio用 al-folio 部署站点时如果你在执行 git 操作被要求输入 GitHub 登录凭证而 GitHub 已禁用密码认证导致认证失败、部署以错误退出docs/FAQ.md 中有一条针对性条目直接覆盖了这个现象英文原文When trying to deploy, its asking for github login credentials, which github disabled password authentication and it exits with an error。官方给出的修复方法是把仓库远程地址从https形式改成ssh形式然后重新部署。问题现象以下现象与 docs/FAQ.md 中该条目的描述一致部署 al-folio 站点时git 提示输入 GitHub 登录凭证输入密码后认证不通过GitHub 已禁用密码认证命令以错误退出。al-folio 从v0.3.5开始每次向仓库main分支推送新变更都会自动重新部署见 docs/INSTALL.md 的 Deployment 一节所以这个凭证错误会卡在你提交改动、等待 Actions 完成部署的环节上。解决步骤把 remote url 从 https 改为 ssh按 docs/FAQ.md 给出的方法操作用你喜欢的编辑器打开仓库里的.git/config文件找到其中的url变量它当前值里带有https部分把url中https的那部分改成ssh形式即将该远程地址由https写法替换为ssh写法保存文件后重新触发部署。文档没有给出一条现成的 git 子命令来完成这一步指示是直接编辑.git/config文件因此按上面步骤手工修改即可。验证部署是否恢复改完 remote 后按 docs/INSTALL.md 和 docs/QUICKSTART.md 的流程确认部署链路走通对站点做一次改动提交并推送到main分支推送目标是main/master不要直接操作gh-pages打开仓库的Actions标签页等待Deploy site工作流完成——按 docs/QUICKSTART.md 的说法看到绿色对勾、耗时约 4 分钟成功条件部署完成后仓库里除了main分支之外会多出一个构建产物分支gh-pages。不要改动这个分支在仓库Settings → Pages中确认发布源分支设置为gh-pages不是main访问https://your-github-username.github.io项目页面则带上前缀路径确认站点可正常访问。如果之前没有配置过自动部署docs/INSTALL.md 要求先在Actions标签页启用 GitHub Actions并在Settings → Actions → General → Workflow permissions中给 GitHub Actions 授予Read and write permissions否则部署动作本身跑不起来。改完凭证仍部署失败时的相关检查如果 remote 改成ssh后部署依然报错docs/TROUBLESHOOTING.md 的 Site fails to deploy on GitHub Pages 一节给出了通用的排查项查看仓库Actions标签页里的具体错误信息确认 Workflow permissions 已设为 Read and write见 docs/QUICKSTART.md 的 Step 2检查_config.yml中url与baseurl个人站点url: https://your-github-username.github.io且baseurl留空不要删除该字段项目站点则baseurl: /your-project-name/确认你推送的是main或master分支而不是gh-pages再提交并推送一个小改动触发重新部署。限制说明docs/FAQ.md 对这个凭证问题只给出了把.git/config中url的https部分改为ssh这一种修法文档中没有涉及 SSH 密钥的生成与绑定流程也没有区分不同的部署拓扑如果你的环境在换成ssh地址后还有其他报错只能依据 Actions 标签页里的错误信息回到 docs/TROUBLESHOOTING.md 对应条目继续对照排查。【免费下载链接】al-folioA beautiful, simple, clean, and responsive Jekyll theme for academics项目地址: https://gitcode.com/GitHub_Trending/al/al-folio创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进