如何在5分钟内搭建Norish自托管食谱系统：新手必备安装教程

【免费下载链接】norishNorish - A realtime, self-hosted recipe app for families & friends项目地址: https://gitcode.com/gh_mirrors/no/norish

Norish是一款专为家庭和朋友设计的实时自托管食谱应用，让你轻松管理、分享和发现美食 recipes。本教程将带你快速完成Norish自托管系统的搭建，无需复杂技术背景，只需简单几步即可拥有属于自己的食谱管理平台。

📋 准备工作：3分钟环境检查

在开始安装前，请确保你的系统满足以下基本要求：

• 已安装Docker和Docker Compose（推荐Docker 20.10+版本）
• 至少2GB可用内存
• 稳定的网络连接

如果你还没有安装Docker，可以参考官方文档的安装指南。

图1：Norish支持桌面和移动设备同步使用，让食谱管理无处不在

⚡ 快速安装：2分钟完成部署

步骤1：获取项目代码

打开终端，执行以下命令克隆Norish项目仓库：

git clone https://gitcode.com/gh_mirrors/no/norish cd norish

步骤2：配置环境文件

进入项目的docker目录，复制示例配置文件并修改必要参数：

cd docker cp docker-compose.example.yml docker-compose.yml

使用文本编辑器打开docker-compose.yml文件，重点修改以下配置：

• AUTH_URL: 设置为你的服务器访问地址（如http://your-ip:3000）
• MASTER_KEY: 生成安全密钥（执行openssl rand -base64 32命令获取）

步骤3：启动服务

保存配置后，执行以下命令启动Norish系统：

docker-compose up -d

Docker将自动下载所需镜像并启动服务，首次启动可能需要1-2分钟。

✅ 验证安装：访问你的食谱系统

打开浏览器，访问你在配置文件中设置的AUTH_URL（默认http://localhost:3000），你将看到Norish的登录界面。

图2：Norish直观的仪表盘界面，轻松管理你的每日食谱

首次登录设置

1. 系统首次启动时，需要创建管理员账户
2. 你可以选择密码登录、GitHub OAuth或Google OAuth等方式
3. 登录后，系统会引导你完成初始设置

🍳 开始使用：创建你的第一个食谱

登录后，点击界面上的"Add Recipe"按钮即可开始创建食谱。Norish提供了丰富的功能：

• 📝 详细的食谱编辑界面，支持步骤、 ingredients和营养信息
• 🍽️ 智能分类系统，轻松管理不同类型的食谱
• 📅 日历视图，规划你的每周菜单
• 🛒 自动生成购物清单，让采购更高效

图3：详细的食谱页面，包含 ingredients、步骤和营养信息

📚 进阶配置与帮助

如需更多高级配置，可以参考项目的官方文档：

• 配置文件位置：docker/docker-compose.yml
• 官方文档：apps/docs/intro.mdx
• 开发指南：apps/docs/development/setup.md

🎉 完成！开始你的美食之旅

恭喜你！现在你已经成功搭建了自己的Norish自托管食谱系统。无论是家庭聚餐规划，还是个人美食探索，Norish都能成为你的得力助手。开始收集、创建和分享你的美食 recipes吧！

如果在使用过程中遇到任何问题，可以查看项目的CONTRIBUTING.md获取帮助或参与社区讨论。

【免费下载链接】norishNorish - A realtime, self-hosted recipe app for families & friends项目地址: https://gitcode.com/gh_mirrors/no/norish