truenas 篇七：Truenas Scale 23.10应用程序教程（homepage）

Homepage是一个全静态、快响应、自动化的，可高度定制化的导航面板，它整合了超过100种服务，你可以通过YAML文件或者Docker标签发现功能轻松地进行配置。官网上宣传界面如下：

Truecharts的应用程序已经整合了homepage服务选项，只需要在安装时勾选“homepage”就能自动添加到导航面板中，十分方便。下面介绍一下如何安装homepage，以及基本的设置。

首先在APP存储池下新建一个appsData数据集，用于存放应用程序配置等文件。将所有者设置为apps。

然后在appsData数据集下面新建一个homepage目录，里面再创建两个子目录config和images。config目录用于存放homepage应用程序的配置文件，images用于存放容器内没有预置的图标。将目录所有者设置为apps。

$ sudo mkdir /mnt/APP/appsData/homepage/{config,images} -p
$ sudo chown apps:apps -R /mnt/APP/appsData/homepage

在<应用> - 中搜索“Homepage”找到这个应用，点击进入详情页，再点<安装>进入安装界面。

找到“Storage and Persistence”，“Type of Storage”选择Host Path；下面的“Host Path”选择刚才创建的config目录；再点击“Additional App Storage”<添加>，将images目录挂载到容器中的“/app/public/images”目录。

找到“Ingress”，勾选“Enable Ingress”，在下面的“HostName”中填写你的域名。

在下面的“certManager”中，勾选“enabled”，“certificateIssuer”填写你之前在安装clusterissuer应用时填写的名称。

其余选项保持默认，直接到最后点击<安装>。安装完打开就可以看到homepage的界面了。

接下来需要修改homepage的配置文件。使用root账号（admin账号无权限修改），通过SFTP工具连接到truenas，可以看到在之前创建的config目录下自动生成了很多个文件。homepage的界面呈现都是由这些配置文件决定的。

首先设置语言。使用编辑器打开settings.yaml，在最后添加如下一行，然后保存。

language: zh-CN

接着打开services.yaml，可以看到里面有一些内容，这就是homepage页面上显示的内容。

然后根据自己的需求修改一下，我现在要添加两个服务：

容器内已经预置了truenas图标，直接引用就行；我这里还添加了istoreos软路由，容器里没有预置图标，因此需要将图标手动上传到/mnt/APP/appsData/homepage/images目录中。

根据homepage官方文档介绍，每当手动添加图标之后，必须重启容器才可以生效。重启容器有两种方法：一是编辑应用程序，不要修改任务配置，直接到最后点击<更新>就行了；二是使用heavyscript脚本。注意：按照官方说法，不要点击应用程序列表后面的停止按钮，否则可能会引起异常。我这里使用第二种方法。

在truenas命令行中，输入heavyscript命令，出现如下界面：