企业官网建设流程全解析

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, it's 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 给出的方法操作：

1. 用你喜欢的编辑器打开仓库里的.git/config文件；
2. 找到其中的url变量，它当前值里带有https部分；
3. 把url中https的那部分改成ssh形式（即将该远程地址由https写法替换为ssh写法）；
4. 保存文件后，重新触发部署。

文档没有给出一条现成的 git 子命令来完成这一步，指示是直接编辑.git/config文件，因此按上面步骤手工修改即可。

验证部署是否恢复

改完 remote 后按 docs/INSTALL.md 和 docs/QUICKSTART.md 的流程确认部署链路走通：

1. 对站点做一次改动，提交并推送到main分支（推送目标是main/master，不要直接操作gh-pages）；
2. 打开仓库的Actions标签页，等待Deploy site工作流完成——按 docs/QUICKSTART.md 的说法，看到绿色对勾、耗时约 4 分钟；
3. 成功条件：部署完成后，仓库里除了main分支之外会多出一个构建产物分支gh-pages。不要改动这个分支；
4. 在仓库Settings → Pages中确认发布源分支设置为gh-pages（不是main）；
5. 访问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" 一节给出了通用的排查项：

1. 查看仓库Actions标签页里的具体错误信息；
2. 确认 Workflow permissions 已设为 Read and write（见 docs/QUICKSTART.md 的 Step 2）；
3. 检查_config.yml中url与baseurl：个人站点url: https://<your-github-username>.github.io且baseurl留空（不要删除该字段），项目站点则baseurl: /<your-project-name>/；
4. 确认你推送的是main（或master）分支，而不是gh-pages；
5. 再提交并推送一个小改动触发重新部署。

限制说明

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