machete/FAQ.md

Machete家庭相册系统使用FAQ常见问题

项目完整名称为：Filesite/Machete，为求简单下文都以machete代替。

本文目录如下：

• Filesite/Machete家庭相册系统有哪些特点？
• 用machete家庭相册系统管理我的照片安全吗？
• 怎么升级machete家庭相册代码？
• 系统配置文件在哪里？
• 怎么开启密码授权访问？
• 怎么关闭网页底部的二维码？
• 怎么修改网站简介信息？
• 怎么修改网站标题？
• 怎么修改底部的版权信息？
• 怎么修改浏览器地址栏左侧的小图标？
• 相册部署到外网了，点击图片打开有点慢怎么办？
• 在局域网内使用，能否所有图片使用原图而不是缩略图？
• 我的设备cpu性能较差，缩略图显示有点慢且cpu占用较高怎么解决？
• 更多问题如何联系？

Filesite/Machete家庭相册系统有哪些特点？

以下为machete家庭相册的几个与众不同的地方：

• 以你的照片目录为数据源、所见即所得，保留你的照片管理习惯
• 开放源代码，源码公开且免费使用
• 无数据库非常轻量、毫秒级响应
• 点击图片放大浏览时默认使用原图，适合大屏幕欣赏高清图片
• 支持背景音乐播放
• 支持单个目录下所有图片自动循环播放
• 支持单个目录下所有视频自动循环播放
• 支持白天/夜晚两种浏览模式

用machete家庭相册系统管理我的照片安全吗？

请放心使用machete家庭相册系统来把本地图片目录转化为一个网站，只要你遵循我们推荐的方式安装部署，它是绝对安全的！

理由如下：

1. machete是开源项目，代码公开，接受任何人/机构的安全检测；
2. 推荐使用docker安装部署machete，docker的安全机制很完善；
3. 只给runtime/目录写入权限，其它文件和目录只读；

Filesite/machete是开放源代码的，它托管在以下几个git网站：

• GitHub
• GitCode
• Gitee

并遵循MIT License，任何个人或公司，只要在保留来源申明的情况下，都可以基于它根据需要做修改后免费使用。

另外，推荐使用docker来安装部署machete家庭相册， 这样基于docker提供的安全沙箱环境，最大程度地保护你的电脑、服务器不受machete程序影响。

最后，machete程序只有临时文件存放目录runtime/需要开放写入权限，其它文件和目录都只需开放“只读”权限即可， 所以你在使用docker为machete配置volume或者本地映射目录时，相册目录只开放只读权限docker容器， 由此可以进一步确保你的照片目录不会被machete程序修改/删除。

怎么升级machete家庭相册代码？

执行容器命令即可：

docker exec -it machete_album /var/www/machete/bin/upgrade.sh

说明： 其中容器名称machete_album请更换为你所启动的machete容器名字。

系统配置文件在哪里？

• 全局配置文件：conf/app.php
• 自定义配置文件：runtime/custom_config.json

系统默认从全局配置文件里读取数据，如果有自定义配置，则优先使用自定义配置文件中的数据。

推荐使用自定义配置文件，以免系统升级后配置被覆盖。

如果是使用docker安装的machete，请自行了解如何修改docker容器里的文件，或者如何把本地文件复制到容器替换。

怎么开启密码授权访问？

在目录runtime/下创建配置文件：custom_password.json， 可复制conf/custom_password.json到runtime/目录下进行修改。

也可按下面示例创建：

{
    "password_auth": {
        "enable": true,
        "default": "",
        "allow": {
            "目录1": "hello",
            "目录2": "world"
        }
    }
}

配置说明：

• enable开关设置true则启用，默认为false关闭状态
• default选项配置全局默认密码，针对所有目录生效
• allow里配置单个目录的授权密码，如果default配置为空，则只有allow里所设置的目录需要密码授权访问

怎么关闭网页底部的二维码？

在runtime/custom_config.json中增加配置：

"showQRImageInFooter": false

怎么修改网站简介信息？

请修改图片根目录下的README.md文件内容（如果你安装的是老版本，看不到这个文件，请手动创建），它是markdown格式的内容。

保存后，点网页右上角“刷新”图标，清空缓存查看效果。

怎么修改网站标题？

网站标题显示在网页左上角，以及浏览器tab栏上，系统默认的标题是“家庭相册”或者“Filesite/Machete”。

请在图片根目录下，创建文件README_title.txt，用一行文字来设置，示例如下：

我的相册

怎么修改底部的版权信息？

请在图片根目录下，创建文件README_copyright.txt，内容参考下面示例代码：

<span>&copy;2022 - 2024</span>
by <a href="https://filesite.io/" target="_blank">FileSite.io</a>
<br>
执行耗时: {page_time_cost} ms

怎么修改浏览器地址栏左侧的小图标？

请创建自己的icon文件，命名为favicon.ico，把它复制到你的图片根目录即可；

以容器目录为例：

/var/www/machete/www/girls/favico.ico

相册部署到外网了，点击图片打开有点慢怎么办？

machete家庭相册默认为局域网使用，配置enableSmallImageForWan开启查看大图显示缩略图是关闭的， 如果你的照片文件大小很大，那么在外网打开可能会很慢。

解决办法，为外网点击图片浏览大图开启缩略图功能， 在自定义配置：runtime/custom_config.json里增加以下配置即可：

"enableSmallImageForWan": true

在局域网内使用，能否所有图片使用原图而不是缩略图？

系统配置enableSmallImage默认为true打开的，在自定义配置文件中，加入以下配置保存即可关闭所有缩略图功能：

"enableSmallImage": false

我的设备cpu性能较差，缩略图显示有点慢且cpu占用较高怎么解决？

machete家庭相册在设计的时候考虑到在嵌入式设备中运行，缩略图功能可由用户的浏览器完成。

在自定义配置中把disableGenerateSmallImageInServer开关打开即可关闭服务器端生成缩略图，从而节省cpu消耗：

"disableGenerateSmallImageInServer": true

更多问题如何联系？

请打开官方网站查看底部QQ群和微信： FileSite.io