aquar搭建指南初步完成

Aquar系统搭建指南.md

@@ -325,22 +325,35 @@ VirtrIO驱动下载地址：https://fedorapeople.org/groups/virt/virtio-win/dire
 TrueNas：
 - [硬盘直通](./details/pve硬盘直通.md)
 - [配置用户及权限](./details/truenas下配置用户及权限.md)
-- [配置存储池](/details/TrueNAS存储池配置.md)
-- [配置NFS](/details/TrueNAS下的NFS服务配置.md)
-- [配置SMB](/details/TrueNas配置SMB.md)
-- [配置WebDAV](/details/TrueNAS下的WebDAV服务配置.md)
+- [配置存储池](./details/TrueNAS存储池配置.md)
+- [配置NFS](./details/TrueNAS下的NFS服务配置.md)
+- [配置SMB](./details/TrueNas配置SMB.md)
+- [配置WebDAV](./details/TrueNAS下的WebDAV服务配置.md)
 
 服务主机ubuntu：
 
-- 使用setup_aquar.sh脚本进行环境初始化
+- [使用setup_aquar.sh脚本进行环境初始化](./details/使用setup_aquar.sh脚本进行环境初始化)
 - 设置docker-compose等待nfs挂载后再启动
 
 Windows虚拟机：
 
-- SMB挂载
-- 显卡直通
-- USB直通
+- [SMB挂载](./details/TrueNas配置SMB.md)（参考TrueNAS配置SMB服务的后半段）
+- [显卡直通](./details/pve虚拟机设置及独显直通.md)
+- [USB直通](./details/pve下直通usb.md)
 
-## 服务初始化配置：
+## 服务初始化配置
+在服务跑起来之后，他们大多数应用都需要一个初始化配置的过程，大部分配置比较简单，可以凭借页面的提示直接完成，同时也可以去参考各个应用的官方文档页面。在此我列出一些与Aquar环境相关的几个注意事项：
 
-## AquarHome组件配置：
+1. setup_aquar.sh脚本会将NFS服务挂载在`/opt/aquar/storages/aquarpool/`路径下，默认的docker应用配置大多使用了这个目录或者其子目录。
+2. aquar启动了一个公用的mariadb数据库容器来满足一些依赖数据库服务的容器需求，而有赖于docker本身的网络别名机制，当需要配置数据库地址时，我们只需要写“mariadb”即可，docker的虚拟网络会帮我们找到数据库服务。这在Nextcloud的初始化配置时非常关键。
+3. 如果你发现自己不知道docker系统的默认用户名和密码，请先核对位于`/opt/aquar/src/docker-compose/docker-compose.yml`的docker配置信息，如果你想修改配置信息，也应该在这里修改。
+
+## 与系统磨合
+
+当你的应用容器启动并初始化完成后，Aquar系统的大部分核心能力就已经具备了，走过这么长的路实属不易。
+
+然而你和这个系统的磨合才刚刚开始。再次强调文档开头的话：“软件系统**生长**在使用者的需求之上。”你的需求是它存在的基础。在此后的很长一段时间内，你将由自己的需求驱动，深入地调整每一个docker服务，配置每一项AquarHome组件，下载应用对应地app，搭建自己的自动化同步体系等等。这个过程比搭建系统本身更加漫长，也更加重要，它决定了你和这套系统的相处是细水长流还是三分热度。希望你能在探索和磨合中享受这个过程。
+
+AquarHome的详细配置文档如下，不得不说，配置AquarHome的过程同样需要很多耐心和时间，希望这些都值得。
+
+[https://gitee.com/firemaker/aquar-home-helper](https://gitee.com/firemaker/aquar-home-helper)

details/使用setup_aquar.sh脚本进行环境初始化.md

@@ -0,0 +1,31 @@
+[setup_aquar.sh](./../files/setup_aquar.sh)是aquar系统中最复杂的脚本，他能够在ubuntu环境中初始化各种配置，包括必要的常用软件下载，NFS挂载配置，python环境及虚拟环境下载，docker及docker-compose安装与配置，aqserv命令安装，docker镜像预装配置，docker-compose启动等内容。脚本执行的不确定性较大，也会消耗较长的时间，所以在执行脚本前你需要仔细进行准备工作。
+
+## 执行步骤
+
+1.确定你的NFS服务的IP地址（如192.168.0.104），并确认你NFS服务的目录名称（如aquar_pool)。其中IP地址是在调用脚本是需要传入的唯一参数。NFS目录名需要你在脚本的第13行及第18行根据你自己的命名来修正。
+
+2.在脚本的第97行至第279行是docker容器配置信息，你需要核对以下几个事项：
+- 你可以根据自己的需求去掉你不需要的应用。
+- 一些应用会的配置信息中会带有初始用户名和密码信息，如160行的photoprism默认密码，218~219行的transmission默认用户名及密码。请根据自己的需求修改这些信息。
+- 其中大部分容器都使用了挂载卷(volume)，你需要根据自己的需求调整这些挂载点配置。你也可以不修改这些挂载信息，按照我默认的配置来执行。
+
+3.登录ubuntu系统，`sudo -i`后输入密码，切换到超级用户，将[setup_aquar.sh](./../files/setup_aquar.sh)拷贝到机器上（如`/root/`目录）
+
+
+4.执行`/bin/bash /root/setup_aquar.sh 192.168.0.104`，然后等待他执行完成。执行期间需要下载大量的包，如果中间出现了超时等问题，你可以重复执行这个命令，这个脚本是幂等（多次执行不影响效果）的。  
+如果脚本已经开始下载docker镜像，但下载镜像过程中中断了，那意味着脚本已经执行成功，你可以关掉当前终端界面，重新进入一次，切换超级用户后执行`aqserv start`命令，这条命令将直接尝试拉起docker-conmpose中的所有服务。
+
+## 验证
+
+1.执行`df`命令，在输出信息中会出现NFS的挂载信息。
+![c36e51a14d2adb947d3e68a0ce31a992.png](../_resources/c36e51a14d2adb947d3e68a0ce31a992.png)
+
+2.在`/opt/aquar/storages/aquarpool/`目录下会出现你存储池中的所有文件。
+
+3.在超级用户下执行`aqserv -h`命令会显示帮助信息。
+
+4.执行`aqserv ps`命令查看容器状态是否为"UP"。
+
+5.等待大约10分钟后，尝试访问docker中的各个服务，看服务是否正常。
+
+如果上面这些验证都顺利通过了，那么恭喜你，最棘手的部分已经度过了。

files/setup_aquar.sh

@@ -157,7 +157,7 @@ services:
     ports:
       - 8042:2342 # [local port]:[container port]
     environment:
-      PHOTOPRISM_ADMIN_PASSWORD: "<utf-8>"
+      PHOTOPRISM_ADMIN_PASSWORD: "admin"
       PHOTOPRISM_HTTP_PORT: 2342
       PHOTOPRISM_HTTP_COMPRESSION: "gzip"
       PHOTOPRISM_DEBUG: "false"
@@ -275,7 +275,6 @@ services:
       - /opt/aquar/storages/apps/aquarhome/logs:/root/.pm2/logs
     ports:
       - 8172:8172
-      - 10000-10100:10000-10100
     restart: unless-stopped
 EOF
 mkdir -p /opt/aquar/src/docker-compose/mariadb.init.d