可协作植物管理工具HortusFox

发表于 2024-01-15 更新于 2024-09-18 分类于各种折腾 Waline：阅读次数：本文字数： 3.5k 阅读时长 ≈ 3 分钟

HortusFox 是一款协作管理工具，可帮助您与多个用户（例如家人、合作伙伴、朋友等）跟踪、管理家里的植物。

什么是 HortusFox ？

HortusFox 是一个自托管的协作植物管理系统，您可以在自己的环境中使用它来管理所有的植物。您可以添加植物，并附带各种详细信息和照片，并将它们分配到环境中的位置。系统提供了一个仪表板，显示所有重要的概览信息。该系统还具有警告系统，以指示哪些植物需要特殊关注，还包括用户身份验证、任务、库存管理、协作聊天和用户所采取的操作历史记录。该系统支持协作管理，因此您可以与多个用户共同管理您的植物。

这是国外一位程序员为女朋友开发的，用于记录她家里 100 多株植物的情况

软件特点：

管理植物并将其分配到位置
包括植物的许多详细信息，以及标签系统和照片上传功能
任务功能：跟踪植物养育所需的任务
库存管理系统：跟踪与植物相关的库存
搜索功能：搜索文本标记或植物 ID
植物历史记录：跟踪已经消失的植物
群组聊天：交流重要的与植物相关的信息
管理员仪表盘：管理系统、用户、位置和媒体
用户仪表盘：查看位置和其他重要信息

你可以先去官方演示站点进行体验：https://www.hortusfox.com/demo

构建镜像

如果你不想自己构建，可以跳过，直接阅读下一章节

官方提供了 Dockerfile 文件，但没找到镜像，所以需要自己编一下，对应的软件版本为 v1.6

构建镜像和容器运行的基本命令如下👇

# 下载代码
git clone https://github.com/danielbrendel/hortusfox-web.git

# 进入目录  
cd hortusfox-web

# 构建镜像
docker build -t wbsu2003/hortusfox-web:v1 .

# 运行容器
docker-compose up -d

安装

在群晖上以 Docker 方式安装。

需要注意的是，群晖内核版本太低会遇到下面的错误，这个 AH00141 已经遇到多次了，老苏除了换机器，也没找到其他的办法；

1	Function not implemented: AH00141: Could not initialize random number generator

在注册表中搜索 hortusfox ，选择第二个 wbsu2003/hortusfox，版本选择 latest。

涉及到前、后端两个容器，所以采用 docker-compose 安装更简单一些

请将下面的内容保存为 docker-compose.yml 文件

version: '3.8'

services:
  app:
    image: wbsu2003/hortusfox-web
    container_name: hortusfox-web
    ports:
      - "3094:80"
    environment:
      APP_DEBUG: "true"
      DB_HOST: db
      DB_PORT: 3306
      DB_DATABASE: hortusfox
      DB_USERNAME: hortusfox
      DB_PASSWORD: password
      DB_CHARSET: "utf8mb4"
      HORTUSFOX_ADMIN: wbsu2003@gmail.com
      HORTUSFOX_PASSWORD: 123456
    depends_on:
      - db

  db:
    image: mariadb
    container_name: hortusfox-db
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: my-secret-pw
      MYSQL_DATABASE: hortusfox
      MYSQL_USER: hortusfox
      MYSQL_PASSWORD: password
    ports:
      - "3308:3306"
    volumes:
      - ./data:/var/lib/mysql

容器 hortusfox-db 的环境变量

可变	值
`MYSQL_ROOT_PASSWORD`	数据库用户 `root` 用户对应的密码
`MYSQL_DATABASE`	数据库库名
`MYSQL_USER`	数据库用户
`MYSQL_PASSWORD`	数据库用户对应的密码

容器 hortusfox-web 的环境变量

可变	值
`APP_DEBUG`	调试模式
`DB_HOST`	数据库主机
`DB_PORT`	数据库端口
`DB_DATABASE`	数据库库名，对应 `MYSQL_DATABASE` 的值
`DB_USERNAME`	数据库用户，对应 `MYSQL_USER` 的值
`DB_PASSWORD`	数据库主机，对应 `DB_PASSWORD` 的值
`DB_CHARSET`	数据库字符集
`HORTUSFOX_ADMIN`	管理员账号，不设会有默认值
`HORTUSFOX_PASSWORD`	管理员密码，不设会自动生成

然后执行下面的命令

# 新建文件夹 hortusfox 和 子目录
mkdir -p /volume2/docker/hortusfox/data

# 进入 hortusfox 目录
cd /volume2/docker/hortusfox

# 将 docker-compose.yml 放入当前目录

# 一键启动数据库
docker-compose up -d db

# 稍等一会再一键启动
docker-compose up -d

一定要先启动数据库，等一会儿再启动 HortusFox，否则会登录失败

以往到这里就结束了，但是这个镜像还不行，因为在上传植物照片时，会报错

经过老苏的测试，发现应该是图片目录权限是 755 没有写入权限导致的。既然知道了原因，就好办了

# 进入容器
docker exec -it hortusfox-web /bin/bash

# 修改目录权限
chmod 777 ./public/img

运行

在浏览器中输入 http://群晖IP:3094 就能看到登录界面

如果你没有设置 HORTUSFOX_ADMIN 和 HORTUSFOX_PASSWORD，容器 hortusfox-web 在启动时会自动生成管理员账号和密码，在日志中能找到

这界面风格应该是为移动端浏览器设计的

软件支持多语言，但是目前只有 英文 和 德文

添加 Locations

从设置中找到 Locations

点 Add Location 添加区域

关于 Icon 支持 Font Awesome 5，老苏参照官方的图标，在这里找到了几个常用的图标
https://www.w3schools.com/icons/fontawesome5_intro.asp

花园：fas fa-leaf
阳台：fas fa-crow
卧室：fas fa-bed
游戏室：fas fa-gamepad
厨房：fas fa-utensils
客厅：fas fa-couch
浴室：fas fa-bath

添加成功后，可以修改和删除

回到首页

添加 Plant

点 Add Plant 添加植物

似乎对图片的兼容性不是太好，比较容易报错；

图片目录没有映射到本地目录，所以重装会导致图片丢失；

添加成功，可以继续添加其他的植物

回到首页

创建任务

点 Create new 创建新任务

任务有点简陋

已经完成的任务，可以在 Done 里找到

其他还有库存（Inventory）、聊天（Chat）等功能，有兴趣可以自己摸索

参考文档

danielbrendel/hortusfox-web: Self-hosted collaborative plant management system for your local environment
地址：https://github.com/danielbrendel/hortusfox-web

hortusfox.github.io
地址：https://hortusfox.github.io/

HortusFox: Plant Manager App
地址：https://www.hortusfox.com/

HortusFox, the selfhosted & collaborative plant manager app, reached version 1.6 today! : selfhosted
地址：https://www.reddit.com/r/selfhosted/comments/193kmr8/hortusfox_the_selfhosted_collaborative_plant/

What is HortusFox? An explanation : hortusfox
地址：https://www.reddit.com/r/hortusfox/comments/18ybo0r/what_is_hortusfox_an_explanation/