arashthr/hugo-flow

来源：https://github.com/arashthr/hugo-flow

Hugo-Flow：基于 Git 的 Hugo 前端界面

一个自定义的、基于 Web 的前端界面，用于你的静态 Hugo 网站。

特性

• GitHub 集成： 通过 GitHub API 直接将文件提交到你的仓库。
• 动态配置： 通过 UI 动态选择你的仓库和路径。
• 双编辑器模式： 在所见即所得富文本编辑器和原始 Markdown 编辑器之间无缝切换。
• 图片上传： 上传图片，并自动以 base64 编码的 blob 形式与你的 Markdown 文章一起推送。

本地开发

1. 创建 .env.local 文件： env NEXTAUTH_URL=http://localhost:3000 NEXTAUTH_SECRET=your_random_secret_here GITHUB_ID=your_github_oauth_id GITHUB_SECRET=your_github_oauth_secret

2. 运行开发服务器： bash npm install npm run dev

生产部署（标准 Node.js）

如果不使用 Docker，可以直接用 Node.js 运行应用：

1. 确保 .env.local 配置了生产环境的密钥和 URL。
2. 构建优化后的生产包： bash npm run build
3. 启动生产服务器： bash npm start 应用将在 http://localhost:3000 上运行。

生产部署（Docker + Caddy）

该应用已准备好通过 Docker 和 Docker Compose 进行部署。它利用 Next.js 的独立输出模式，实现高度优化的最小容器体积。

1. 更新 GitHub OAuth 应用

将 GitHub OAuth 应用的“授权回调 URL”更新为你的生产域名： https://your-domain.com/api/auth/callback/github

2. 设置生产环境变量

在服务器上与你 docker-compose.yml 相同的目录下创建 .env 文件： env NEXTAUTH_URL=https://your-domain.com NEXTAUTH_SECRET=your_secure_random_string（可通过以下命令生成：openssl rand -base64 32） GITHUB_ID=your_production_github_id GITHUB_SECRET=your_production_github_secret

3. 使用 Docker Compose 运行

在后台启动应用： bash docker-compose up -d --build 这将让应用在宿主机的 3000 端口上暴露。

4. 设置 Caddy 反向代理

如果你使用 Caddy 来为域名提供服务，只需将以下代码块添加到你的 Caddyfile 中：

caddyfile your-domain.com { reverse_proxy localhost:3000 }

重载 Caddy（caddy reload），你的应用就可以通过 HTTPS 安全访问了！

+++