A free and open database for farming and gardening knowledge. You can grow anything!

当前项目代码仓暂无内容

自动翻译

停机通知

OpenFarm 服务器在 2025 年 4 月关闭，上线时间略超 10 年。代码库已不再维护，并且服务器运行的基础设施将从 2025 年 5 月起不再接收安全更新。出于预防措施，考虑到近年来网站的访问量逐渐减少，我们决定无限期关闭服务器，并将此 GitHub 仓库公开存档。

我们为所有在 OpenFarm 项目中投入努力的软件开发者、设计师和数据贡献者感到自豪和感激，很高兴这项服务能够在过去十年中为各种 API 用户和网络上的过客提供价值。尽管 OpenFarm 从未获得足够的关注以成为一个自给自足且真正全面的“种植植物的 Wikipedia”，我们希望像这样的新努力将在未来萌芽，完成我们未能做到的。

OpenFarm

安全顾虑

我们重视安全，并珍视独立研究人员的意见。如遇需立即关注的问题，请发送邮件至 security@farmbot.io。请遵循责任披露.不要使用 Slack 或 GitHub 问题来讨论安全漏洞。

贡献者社区：运作方式

关于

OpenFarm 是一个免费且开源的数据库和网页应用，用于种植和园艺知识。人们可能会将其视为种植植物的 Wikipedia，尽管它的功能更像一个烹饪食谱网站。

主要内容是种植指南：创造性、由大众协作、单作者编写的结构化文档，包含一个人或机器种植植物所需的所有信息，例如：种子间距和深度、浇水计划、推荐土壤组成和伴生植物、光照/遮阴要求等。在这个 Freebase 平台上，园艺师可以找到类似“我如何种植番茄？”的问题的答案。

加入现有贡献者开始

要开始讨论，参与进来，并认识 OpenFarm 核心社区的贡献者，我们强烈推荐加入我们的 Slack 聊天室！在这里，您可以找到关于 Openfarm 的最新对话和最活跃的贡献者。

也请查看常见问题解答来了解关于贡献的一些常见问题（Angular、问题追踪器、IRC 频道）。

查看待处理的问题优先级列表中需要解决的问题。

寻找您想参与的工作

对于前端和后端代码贡献，我们旨在通过 Github 项目维护和优先处理 Github 问题，这是类似 Trello 的基于网页的项目管理板：OpenFarm 项目。

需要使用 OpenFarm 资源？在这里！

网站的翻译内容还缺少几种语言：帮助我们翻译网站！

谁可以贡献

欢迎每个人为 OpenFarm 的开源社区贡献价值。时间是我们这里最宝贵的资产，所以您投入的每一分钟都至关重要！ "做得好，胜于完美！" 我们追求社区多样性，并通过采纳行为准则来确保为每个人提供一个安全包容的空间。

我们的社区由技术和技术之外的人士组成，有园艺方面的新手和专家，都是愿意为更好的未来采取行动、分享知识并种植自己食物的伟大人士。

我们的问题解决流程

在我们一起工作的过程中，我们致力于：

在行动背后保持推理的透明度：花时间进行文档编写、提问和解答
更倾向于完成而非完美：分解任务，以便任何人都能定期投入几分钟时间
走捷径：什么是最明显的改进用户体验的方法？什么是构建功能的捷径？什么是最有价值的反馈？

开发

快速入门（简单方式）

您应该使用 Vagrant 在您的计算机上运行 OpenFarm 系统。这将避免您需要安装下面“困难方式”中提到的内容。

安装 Vagrant。
安装 VirtualBox。
打开您的终端。
$ git clone https://github.com/openfarmcc/OpenFarm.git - 这会告诉您的计算机使用 git 获取存储在此仓库中的数据。
$ cd OpenFarm - 切换到 OpenFarm 目录。
$ vagrant up 这个过程会持续很长时间。我们正在下载很多东西。去给自己煮一壶咖啡，或者泡杯茶。如果在此过程中出现问题，请直接通过 GitHub 问题与我们联系。

访问 Vagrant

一旦在您的系统上设置好 Vagrant，您可能想要实际访问它。例如，如果您想启动服务器（尽管 vagrant up 应该为您运行 rails s）：

$ vagrant ssh - 这会为您提供访问我们刚刚创建来运行 OpenFarm 的新虚拟服务器的权限。
cd /vagrant - vagrant 目录与您自己的计算机中的目录相镜像。如果您在那里添加一个文件，您将在这里看到它。
rails s - 实际运行 Rails 服务器！
现在您应该能够在本地系统上通过 http://localhost:3000 访问 OpenFarm。如果一切顺利，您将有一个预填充的数据库，并可以使用账户 admin@admin.com 和密码 admin123。

上述内容仍在修补中，如果出现问题，请与我们联系！

快速入门（困难方式）

在您的本地机器上运行 OpenFarm 服务器之前，您需要安装 Ruby、Rails、ElasticSearch v6.5.0 和 Mongodb。一旦您有了这些先决条件来开始项目的本地副本，运行：

$ git clone https://github.com/openfarmcc/OpenFarm.git
$ cd OpenFarm
$ bundle install
$ rake db:setup
$ echo "ENV['SECRET_KEY_BASE'] = '$(rake secret)'" >> config/app_environment_variables.rb
$ echo "ENV['GOOGLE_MAPS_API_KEY'] = ''" >> config/app_environment_variables.rb # or get an actual API key at https://console.developers.google.com/flows/enableapi?apiid=maps_backend&keyType=CLIENT_SIDE&reusekey=true&pli=1
$ rails s

然后，在您的浏览器中访问 http://127.0.0.1:3000/，以查看在本地计算机上运行的 OpenFarm 网络应用程序。如果一切顺利，您将拥有一个已填充的数据库，并可以使用账号 admin@admin.com 及密码 admin123。

关于 ElasticSearch 的注意事项：一些 Linux 用户报告了在宿主机上安装 ElasticSearch 的问题。一种解决方法是使用 Docker 来安装 ElasticSearch：

sudo docker pull elasticsearch:6.5.0
sudo docker pull mongo

当然，请您提供需要翻译的英文文本以及期望的中文风格（通俗、专业、优雅或流畅）。我将会根据您的要求进行翻译。

sudo sysctl -w vm.max_map_count=262144 # <= Some linux users must run this
sudo docker run -p 9300:9300 -p 9200:9200 elasticsearch:6.5.0
sudo docker run -p 27017:27017 mongo

如果在安装软件包或运行过程中遇到任何问题，请查看常见问题页面。

请注意，Vagrant虚拟机中的/vagrant文件夹主要是为了方便使用，在此文件夹中工作可能会导致与其他工具的不兼容行为——你应该在非Vagrant环境中进行工作。使用你最熟悉的开发环境编程，Vagrant将负责其他部分。