Chowdown Docker 本地部署完全指南打造你的私人食谱服务器【免费下载链接】chowdownSimple recipes in Markdown format项目地址: https://gitcode.com/gh_mirrors/ch/chowdown你是否厌倦了把菜谱散落在备忘录、书签和社交平台里Chowdown 是一款基于 Markdown 的简单食谱数据库专为黑客和热爱动手的普通人设计。本文将手把手教你使用Chowdown Docker 部署在本地快速搭建一台属于你自己的私人食谱服务器从此用纯文本格式管理所有菜谱干净、可搜索、永久免费。什么是 Chowdown为什么值得自己部署Chowdown 的核心理念很简单食谱就是 Markdown 文件。每一道菜都是一个独立的.md文档存放在_recipes目录下比如 banana-bread.md。用文本编辑器就能写菜谱不需要任何数据库或后台管理界面。相比商业食谱 App自己部署 Chowdown 有三大优势数据完全归你所有食谱都是纯文本文件永远不会被平台关停格式极简标题、图片、食材清单、步骤用 Markdown 语法即可随写随搜内置搜索功能可按菜名或食材即时查找开始前的准备检查你的环境在部署前请确认本机满足以下条件已安装 Docker 和 Docker Compose预留至少 1GB 磁盘空间食谱图片为主了解基本的终端命令操作一键部署最简单的 Docker 安装步骤项目仓库里已经准备好了 docker-compose.yml部署流程极简只需三步。第一步获取项目代码打开终端克隆仓库到本地git clone https://gitcode.com/gh_mirrors/ch/chowdown第二步启动服务进入项目目录后直接运行docker compose up -dDocker 会自动拉取jekyll/jekyll镜像并启动容器。根据 docker-compose.yml 的配置宿主机 80 端口会映射到容器内的 4000 端口也就是 Jekyll 服务的默认地址。第三步访问你的食谱服务器打开浏览器访问http://localhost即可看到你的食谱首页。所有已收录的菜谱会以卡片形式展示支持点击进入详情页。深度解读 docker-compose.yml 配置如果你想调整端口或目录理解 docker-compose.yml 的配置会很有帮助配置项作用image: jekyll/jekyll使用官方 Jekyll 镜像免装 Ruby 环境command: jekyll serve --force_polling开启文件监听改动即时生效ports: 80:4000宿主机 80 端口映射到容器 4000 端口volumes: .:/srv/jekyll将项目目录挂载进容器实现热更新想换个端口只需把80:4000改成8080:4000然后重启容器即可。如何添加食谱3 分钟上手 Markdown 食谱格式添加新菜谱非常简单在_recipes文件夹中新建一个.md文件参照 banana-bread.md 的格式填写。一个标准的 Chowdown 菜谱包含三部分--- layout: recipe title: 香蕉面包 image: banana-bread.jpg ingredients: - 4根香蕉 - 半杯黄油 - 2个鸡蛋 directions: - 打散鸡蛋与黄油和糖混合 - 拌入香蕉和面粉 - 放入烤盘烤至表面金黄 ---frontmatter 头部用---包裹声明标题、图片、食材和步骤正文部分可写菜谱背后的故事、灵感来源等补充内容图片文件放入images目录在 frontmatter 中引用文件名保存文件后浏览器刷新即可看到新菜谱出现无需重启服务这就是--force_polling热更新带来的便利。进阶玩法组件化食谱让组合更聪明Chowdown 支持一个非常酷的特性——组件化食谱。你可以把基础配方拆成独立组件再组合成新菜。以 red-berry-tart.md 为例它本身没有食材清单而是通过components字段引用了三个组件components: - Graham Cracker Crust - Vanilla Custard Filling - Red Berry Dessert Topping这三个组件分别存放在_components目录下例如 graham-cracker-crust.md。这样做的价值在于饼底、酱汁等万金油配方只需维护一次新菜谱 已有组件的新组合省时省力页面会自动渲染各组件的完整食材和步骤高效搜索按菜名或食材快速找菜菜谱多了怎么办Chowdown 内置了基于 SimpleJekyllSearch 的本地搜索功能入口在 search.html。搜索支持两种方式关键词搜索输入菜名或任意食材如chickenlentils标签筛选点击页面上预设的标签如 breakfast、desserts快速过滤所有菜谱数据会实时生成到 search.json由 js/search.min.js 驱动无需任何外部服务完全离线可用。数据安全用好挂载卷备份你的食谱库这是整个部署中最值得重视的一环。由于容器通过 volumes 把宿主机目录挂载进容器你的所有数据都保存在本地目录中容器删了重建也不会丢失。食谱文件保存在_recipes/和_components/图片保存在images/站点配置在 _config.yml备份建议定期打包整个项目目录或至少上述三个文件夹即可完成食谱库备份。配合 Git 版本管理你甚至可以追踪每一道菜谱的修改历史。常见问题排查Q访问 80 端口失败怎么办A检查端口是否被占用可将docker-compose.yml中端口改为8080:4000后重启。Q修改菜谱后页面没有变化A确认容器内 Jekyll 是否在运行执行docker compose logs查看日志。Q如何让家人朋友也能访问A在路由器上做端口映射或使用内网穿透工具即可把私人食谱服务器分享给他人。总结开启你的纯文本食谱之旅通过本文的 Chowdown Docker 部署指南你已经掌握了一套极简、可靠、完全自控的私人食谱服务器方案。它没有复杂的后台没有云端锁定的风险只有干净的 Markdown 文件和随时可搜的菜谱库。从今天开始把第一道拿手菜写进_recipes吧——这台私人食谱服务器会成为你厨房里最值得信赖的数字搭档。【免费下载链接】chowdownSimple recipes in Markdown format项目地址: https://gitcode.com/gh_mirrors/ch/chowdown创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考