Install scripts of machete

filesite 3f104c6010 readme update		3 months ago
..
README.md	readme update	3 months ago

README.md

Unescape Escape

windows系统安装machete家庭相册

我们相信，回忆被经常看到才倍显珍贵！

machete家庭相册软件兼容windows操作系统，下面为详细的安装方法及相关说明。

软件准备

基于docker安装machete家庭相册，需要先下载以下软件：

docker desktop windows版本
machete的docker镜像

docker desktop windows 4.34.0版下载地址：

如果已经安装了docker desktop，可以尝试命令行下载machete镜像：

docker pull filesite/machete

由于部分地区docker hub被限制访问，使用docker直接pull镜像会失败，需要手动下载machete的docker镜像，下载地址：

https://static.jialuoma.cn/docker_images/machete.tar

安装步骤

按以下步骤安装并验证machete家庭相册。

安装docker desktop

双击下载到的docker desktop程序，按提示安装完成；
双击桌面的Docker Desktop图标启动docker desktop；

如果启动docker desktop时出现以下错误信息：

Docker Desktop - Unexpected WSL error
An unexpected error occurred while executing a WSL command.

Either shut down WSL down with wsl --shutdown, and/or reboot your machine. You can also try reinstalling WSL and/or Docker Desktop. If the issue persists, collect diagnostics and submit an issue⁠.

deploying WSL2 distributions
provisioning docker WSL distros: ensuring main distro is deployed: deploying "docker-desktop": importing WSL distro "当前计算机配置不支持 WSL2。\r\n请启用“虚拟机平台”可选组件，并确保在 BIOS 中启用虚拟化。\r\n通过运行以下命令启用“虚拟机平台”: wsl.exe --install --no-distribution\r\n有关信息，请访问 https://aka.ms/enablevirtualization\r\nError code: Wsl/Service/RegisterDistro/CreateVm/HCS/HCS_E_HYPERV_NOT_INSTALLED\r\n" output="docker-desktop": exit code: 4294967295: running WSL command wsl.exe C:\Windows\System32\wsl.exe --import docker-desktop <HOME>\AppData\Local\Docker\wsl\main C:\Program Files\Docker\Docker\resources\wsl\wsl-bootstrap.tar --version 2: 当前计算机配置不支持 WSL2。
请启用“虚拟机平台”可选组件，并确保在 BIOS 中启用虚拟化。
通过运行以下命令启用“虚拟机平台”: wsl.exe --install --no-distribution
有关信息，请访问 https://aka.ms/enablevirtualization
Error code: Wsl/Service/RegisterDistro/CreateVm/HCS/HCS_E_HYPERV_NOT_INSTALLED
: exit status 0xffffffff
checking if isocache exists: CreateFile \\wsl$\docker-desktop-data\isocache\: The network name cannot be found.
Read our policy for uploaded diagnostic data⁠

是由于你的电脑主板没有启用虚拟化支持，请参考下面华硕主板电脑的解决方法：

重启电脑，并在开机时按键盘上的delete键进入bios系统
找到advance，进入高级模式并找到：CPU Configuration
进入CPU Configuration并找到Intel Virtual Technology，改disabled为enabled启用
按f10保存并重启电脑

如果你的电脑主板不支持虚拟化技术，推荐在京东商城购买二手Mac Mini电脑小主机（2014款只需几百元）进行安装使用。

导入machete家庭相册镜像

打开命令行软件cmd，cd到下载machete镜像文件所在目录；
输入命令导入machete镜像：

docker image load -i machete.tar

查看已有的docker镜像：

docker images

看到filesite/machete镜像了，说明导入成功。

启动machete家庭相册容器

打开命令行软件cmd
输入以下命令启动容器：

docker run --name machete_album -p 1080:80 \
    -v /d/图片目录/:/var/www/machete/www/girls/ \
    -itd filesite/machete \
    beauty

说明：

上述命令中的目录“/d/图片目录/”需要换成你的照片目录，其中的d代表d盘。

启动成功后，在浏览器输入网址：

http://127.0.0.1:1080

看到machete家庭相册网页表示安装完成。

常见问题

Q：怎样在局域网里的其它电脑/电视机/平板/手机打开家庭相册？

A：

打开命令行软件cmd，在里面输入命令查看本机局域网ip地址：

ipconfig

回车之后会看到本机的ip地址，示例如下：

Windows IP 配置


以太网适配器 vEthernet (WSL (Hyper-V firewall)):

   连接特定的 DNS 后缀 . . . . . . . :
   本地链接 IPv6 地址. . . . . . . . : fe80::923e:b245:256:b250%20
   IPv4 地址 . . . . . . . . . . . . : 172.18.64.1
   子网掩码  . . . . . . . . . . . . : 255.255.240.0
   默认网关. . . . . . . . . . . . . :

以太网适配器 以太网:

   连接特定的 DNS 后缀 . . . . . . . :
   本地链接 IPv6 地址. . . . . . . . : fe80::7b47:7817:de4c:fe1%9
   IPv4 地址 . . . . . . . . . . . . : 192.168.3.26
   子网掩码  . . . . . . . . . . . . : 255.255.255.0
   默认网关. . . . . . . . . . . . . : 192.168.3.1

其中的“IPv4 地址”，就是你本机的局域网IP地址，上面示例中的ip地址为：192.168.3.26。

记住这个ip地址之后，在其它电脑/电视机等设备里，打开浏览器输入网址打开相册：

http://192.168.3.26:1080

注意，需要将192.168.3.26替换为你本机的IP地址。

Q：复制了新照片到相册目录，怎么在相册网页里看不到？

A：

machete家庭相册系统默认有10分钟缓存，点击右上角的“刷新”图标即可清空缓存，看到最新照片和视频了。

Q：怎么升级家庭相册到最新版？

A：

打开命令行软件cmd，在里面输入下面升级命令：

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

等待升级完成，刷新相册网页即可。

Q：machete相册升级会导致我的照片被删除吗？

A：

不会！

machete家庭相册只会读取你指定的照片目录里的子目录和文件，它没有实现任何修改、删除目录和文件的功能。

它的升级代码只会更新相册本身的源代码，而且使用docker容器来安装machete家庭相册，docker为相册运行提供了一个沙箱环境，并对它的访问权限限制在了容器内部，所以也无需担心machete相册系统能访问/修改到你的windows系统（除了在启动容器的时候指定的照片目录）。

交流QQ群

Machete源码交流QQ群：44123711

使用中遇到任何问题，欢迎加入QQ群大家一起讨论。

README.md Unescape Escape