machete_installer/windows/README.md

# windows系统安装machete家庭相册

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


## 软件准备

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

1. docker desktop windows版本
2. machete的docker镜像

docker desktop windows 4.34.0版下载地址：
* https://www.jb51.net/softs/757227.html
* https://soft.3dmgame.com/down/308182.html


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

由于部分地区docker hub被限制访问，使用docker直接pull镜像会失败，
需要手动下载machete的docker镜像，下载地址：
* https://static.jialuoma.cn/docker_images/machete.tar


## 安装步骤

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


### 安装docker desktop

1. 双击下载到的docker desktop程序，按提示安装完成；
2. 双击桌面的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⁠
```

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

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


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


### 导入machete家庭相册镜像

1. 打开命令行软件cmd，cd到下载machete镜像文件所在目录；
2. 输入命令导入machete镜像：
```
docker image load -i machete.tar
```
3. 查看已有的docker镜像：
```
docker images
```

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


### 启动machete家庭相册容器

1. 打开命令行软件cmd
2. 输入以下命令启动容器：
```
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：

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讨论群：**44123711**。