如何无需CI、Runner等工具在GitLab Pages发布纯HTML网站
无需启用GitLab CI发布纯HTML到GitLab Pages的方法
纯HTML无需构建编译,完全可以跳过GitLab CI流程,直接通过分支部署完成发布,具体步骤如下:
- 整理你的纯HTML网站文件(包括
index.html、样式表、脚本、图片等静态资源),要么放到本地Git仓库的根目录,要么统一存入名为public的子文件夹(GitLab Pages默认优先识别public目录)。 - 将本地仓库代码推送到你的GitLab项目分支(比如
main),确保项目已创建完成。 - 进入GitLab项目的设置页面,在左侧菜单「部署」分类下找到「Pages」选项。
- 在Pages设置的「部署来源」区域,选择「分支」作为部署方式:
- 选中你推送代码的目标分支(如
main) - 选择对应文件路径:文件在根目录选
/,在public文件夹选/public
- 选中你推送代码的目标分支(如
- 点击「保存更改」,等待1-2分钟,GitLab会自动完成静态网站部署,页面将显示你的网站访问地址。
注意事项
- 网站入口文件必须命名为
index.html,这是GitLab Pages默认的首页文件。 - 所有资源引用请使用相对路径(比如
./css/main.css),避免绝对路径导致部署后资源加载失败。 - 若使用私有项目,需在Pages设置中额外配置访问权限;公开项目的Pages可直接访问,无需额外设置。
内容的提问来源于stack exchange,提问作者PChemGuy
相关产品推荐
相关产品推荐

