寻求面向实习生教学的密码保护Git静态文档站点开源方案

一、基于GitHub + Jekyll 的密码保护实现 #

你熟悉的Jekyll工作流可以通过两种低成本方式添加密码保护：

• 客户端静态加密：使用jekyll-password-protect插件，在Jekyll配置中设置密码后，生成的静态页面会自带加密逻辑，用户输入密码即可解密查看，无需后端服务。
• Cloudflare Access 访问控制：将GitHub Pages站点接入Cloudflare，利用其免费的Access功能配置身份验证（支持密码、邮箱验证等），无需修改Jekyll项目代码，就能实现站点的私有访问。

二、GitLab Pages 免费私有站点方案 #

GitLab Pages对私有仓库提供免费部署支持，且访问控制更灵活：

• 仓库成员权限控制：私有仓库部署的Pages站点默认仅对仓库成员开放，你只需将学生、实习生添加为仓库成员，他们即可通过GitLab账号登录访问，无需额外密码。
• 独立密码加密：若需要脱离GitLab账号的密码验证，可使用staticrypt工具加密静态HTML文件。执行命令staticrypt index.html "your-secure-password"生成加密文件，提交到GitLab仓库后部署即可，用户输入密码就能查看内容。

三、其他适配需求的开源方案 #

• MkDocs + 加密插件：MkDocs是轻量静态文档生成工具，基于纯Markdown格式，天然支持Git版本控制。搭配mkdocs-password-protection插件可实现密码保护，部署到GitHub/GitLab Pages流程简单，还支持文档导航、搜索等扩展功能。
• BookStack（轻量服务器部署）：如果校内有可用服务器，BookStack是不错的选择。它是开源文档系统，支持Markdown编辑、Git同步，可设置细粒度用户权限，适合团队协作编写文档，同时能让学生练习Git同步操作。

四、关于Git技能培养的适配性 #

所有方案均基于Git仓库，学生可通过分支管理、Pull Request、Fork等操作参与文档协作，直接实践Git核心技能；纯文本Markdown格式确保内容不绑定专有平台，可随时迁移，满足快速扩展需求。

内容的提问来源于stack exchange，提问作者Austin Kocher