Browse Source

add docs for linux

master
filesite 3 days ago
parent
commit
32e3f7bc7d
  1. 83
      nas_linux/README.md
  2. 23
      nas_linux/compose.yaml
  3. 30
      nas_linux/photos/README.md
  4. 2
      nas_linux/runtime/README.md
  5. 21
      template/readme_beauty.md
  6. 6
      windows/README.md

83
nas_linux/README.md

@ -0,0 +1,83 @@
# NAS/Linux安装machete家庭相册
我们相信,回忆被经常看到才倍显珍贵!
## 软件清单
以下为脚本安装的软件明细:
* docker
* docker-compose
* machete docker image
Linux下安装docker,请参考[Docker官方安装教程](https://docs.docker.com/engine/install/)。
Linux下安装docker-compose方法:
1. 打开[Docker Compose官方下载](https://github.com/docker/compose/releases),根据linux系统版本选择对应版本下载
2. 给下载下来的docker-compose程序设置可执行权限
以CentOS 7.9为例:
```
wget "https://github.com/docker/compose/releases/download/v2.32.2/docker-compose-linux-x86_64"
chmod +x docker-compose-linux-x86_64
./docker-compose-linux-x86_64 --help
```
## 安装相册
进入安装目录nas_linux/,执行启动容器命令:
```
cd nas_linux/
docker-compose up
```
相册默认安装时把nas_linux/photos/目录映射到容器里的照片目录,
只需把你的照片、视频等文件上传到此目录即可。
如需更换本地照片目录,请修改文件**compose.yaml**,把“${PWD}/photos”替换为你的照片目录的绝对路径。
如果你的系统无法从Docker Hub下载镜像,请先手动下载并导入machete相册镜像:
```
wget "https://static.jialuoma.cn/docker_images/machete.tar"
docker image load -i machete.tar
```
用"docker images"查看已经导入的镜像,如果看到了:filesite/machete,说明导入完成,
再执行启动容器命令:
```
docker-compose up
```
## 系统升级
命令行输入以下升级命令:
```
docker exec -it filesite_machete /var/www/machete/bin/upgrade.sh
```
## 卸载machete
输入以下命令删除相册容器:
```
cd nas_linux/
docker-compose down
```
卸载machete家庭相册时,不会删除你本地的照片、视频。
## 交流QQ群
Machete源码交流QQ群:**44123711**
使用中遇到任何问题,欢迎加入QQ群大家一起讨论。

23
nas_linux/compose.yaml

@ -0,0 +1,23 @@
# source code: https://github.com/filesite-io/machete
# docker-compose download in linux: https://github.com/docker/compose/releases
# example for centos 7.*:
# ```
# wget "https://github.com/docker/compose/releases/download/v2.32.2/docker-compose-linux-x86_64"
# chmod +x docker-compose-linux-x86_64
# ./docker-compose-linux-x86_64 --help
# ```
name: filesite_machete
services:
web:
build: .
ports:
- "1080:80"
image: "filesite/machete:latest"
container_name: filesite_machete
volumes:
# Cache files will save into ./runtime
- "${PWD}/runtime:/var/www/machete/runtime"
#
# **[IMPORTANT]**
# Change this path (${PWD}/wwww/girls) to your photos' directory
- "${PWD}/photos:/var/www/machete/www/girls/"

30
nas_linux/photos/README.md

@ -0,0 +1,30 @@
# 家庭相册
Filesite/machete是一款简单易用的家庭相册系统,可方便更新升级、支持Docker安装。
## 使用场景
* 家庭相册,局域网搭建图片、视频网站,在家庭成员之间、不同设备里共享照片、视频
* 摄影工作室,搭建照片集方便客户在手机里挑选
* 摄影发烧友,收藏、展示自己的照片、视频
## 使用方法
1. 按说明文档安装好相册
2. 用手机、平板、电脑打开相册网址
到此就可以欢乐地跟家人、朋友观看你们的精彩瞬间啦!
## 交流讨论
如有疑问,欢迎加QQ群交流:
* <a href="https://jq.qq.com/?_wv=1027&k=WoH3Pv7d" target="_blank">FS相册交流群</a>
## 友情链接
* <a href="https://tajian.tv" target="_blank">Ta荐 - 你的聚宝盆</a>

2
nas_linux/runtime/README.md

@ -0,0 +1,2 @@
此目录为filesite/machete相册运行时所需的临时目录,用来存放缓存文件。

21
template/readme_beauty.md

@ -1,6 +1,6 @@
# 家庭相册 # 家庭相册
Machete是一款简单易用的家庭相册系统,可方便更新升级、支持Docker安装。 Filesite/machete是一款简单易用的家庭相册系统,可方便更新升级、支持Docker安装。
## 使用场景 ## 使用场景
@ -9,22 +9,21 @@ Machete是一款简单易用的家庭相册系统,可方便更新升级、支
* 摄影工作室,搭建照片集方便客户在手机里挑选 * 摄影工作室,搭建照片集方便客户在手机里挑选
* 摄影发烧友,收藏、展示自己的照片、视频 * 摄影发烧友,收藏、展示自己的照片、视频
## 使用方法 ## 使用方法
1. 通过iPhone、iPad的“隔空传送”发送照片、视频到安装了“家庭相册”的Mac mini电脑; 1. 按说明文档安装好相册
2. 在Mac mini从“下载”中把收到照片、视频拖动到**桌面**的目录“**machete家庭相册**”; 2. 用手机、平板、电脑打开相册网址
3. 双击桌面的快捷方式“相册.url”打开网页浏览照片、视频;
4. 用iPhone扫码网页底部的二维码,打开后分享给家庭成员的微信、QQ等,他们就可以在自己的手机里浏览你们共同的照片、视频啦; 到此就可以欢乐地跟家人、朋友观看你们的精彩瞬间啦!
注意: ## 交流讨论
* 网页看到的照片、视频有 **10分钟** 的缓存,如果你打开网页后十分钟内有增加新照片、视频,
请点击网页右上角的“**刷新**”图标清空网页缓存
* 如果你的相册安装目录不是默认的“**machete家庭相册**”,请拖动照片、视频到你的相册目录
如有疑问,欢迎加QQ群交流:
如有其它相关疑问,欢迎加QQ群交流: * <a href="https://jq.qq.com/?_wv=1027&k=WoH3Pv7d" target="_blank">FS相册交流群</a>
* <a href="https://jq.qq.com/?_wv=1027&k=WoH3Pv7d" target="_blank">Machete交流群</a>
## 友情链接 ## 友情链接

6
windows/README.md

@ -28,6 +28,9 @@ docker pull filesite/machete
* https://static.jialuoma.cn/docker_images/machete.tar * https://static.jialuoma.cn/docker_images/machete.tar
复制上面链接到浏览器地址栏粘贴后按回车键下载。
## 安装步骤 ## 安装步骤
按以下步骤安装并验证machete家庭相册。 按以下步骤安装并验证machete家庭相册。
@ -69,6 +72,9 @@ Read our policy for uploaded diagnostic data
### 导入machete家庭相册镜像 ### 导入machete家庭相册镜像
以下命令均可**复制后在cmd里粘贴**按回车键执行,无需手动输入。
1. 打开命令行软件cmd,cd到下载machete镜像文件所在目录; 1. 打开命令行软件cmd,cd到下载machete镜像文件所在目录;
2. 输入命令导入machete镜像: 2. 输入命令导入machete镜像:
``` ```

Loading…
Cancel
Save